创建数据代理

借助对话式数据智能体，您可以使用自然语言界面与数据库数据进行互动。通过构建这些代理，您可以帮助用户“与数据对话”，从而从运营数据库中发掘洞见，而无需用户编写复杂的 SQL 查询。

从宏观层面来看，数据代理是角色、一组数据源的组合，可访问一组对其用途至关重要的业务知识。

对于应用开发者，这些代理可带来以下好处：

  • 高精确度：通过使用撰写的内容，您可以针对特定的业务问题获得高精确度的回答。编写的上下文是智能体创建者可用于提高准确率的主要关键因素。它包括架构说明、系统指令和结构化上下文，可提供有关预期数据库查询的其他信息。
  • 降低复杂性：智能体将自然语言转换为 SQL 查询、执行，甚至数据总结或可视化图表。
  • 灵活性：您可以起草代理以供个人测试，也可以发布代理，以便项目中的其他用户或通过 API 以编程方式使用代理。

准备工作

  1. 验证是否已为您的 Google Cloud 项目启用结算功能。

  2. 启用 Cloud SQL、Data Analytics API with Gemini 和 Gemini for Google Cloud API。

    启用 API 所需的角色

    如需启用 API，您需要拥有 serviceusage.services.enable 权限。如果您创建了项目，则可能已经通过 Owner 角色 (roles/owner) 获得了此权限。否则，您可以通过 Service Usage Admin 角色 (roles/serviceusage.serviceUsageAdmin) 获得此权限。了解如何授予角色。

    启用 API

所需的角色

如需使用数据智能体，您必须拥有与您的使用情形相符的 IAM 权限。下表列出了所需角色，具体取决于您是创建和发布代理、在 Gemini Enterprise 中预配代理，还是发现和使用代理。如需了解详情，请参阅 Conversational Analytics API IAM 角色。

使用场景 所需的角色
创建、修改、发布、共享和删除代理
  • 在项目中创建数据代理：项目中的 Gemini Data Analytics Data Agent Creator (roles/geminidataanalytics.dataAgentCreator)。此角色会自动授予您所创建数据代理的 Gemini Data Analytics 数据代理所有者角色。
  • 如需修改、共享或删除数据代理，您需要拥有该代理或项目的 Gemini Data Analytics 数据代理所有者 (roles/geminidataanalytics.dataAgentOwner) 角色。
  • 如需在项目中修改数据代理，您需要拥有以下角色：针对项目的 Gemini Data Analytics Data Agent Editor (roles/geminidataanalytics.dataAgentEditor)。
  • 如需查看项目中的数据代理，请为项目授予 Gemini Data Analytics Data Agent Viewer (roles/geminidataanalytics.dataAgentViewer) 权限。
  • 此外，您还必须拥有以下角色才能创建或修改数据代理：