用于列表和共享的 Automatic Data Agents

Automatic Data Agents 可为您的数据列表和共享即时生成由 AI 驱动的代理和语义视图，将静态数据转化为智能的对话式体验，让终端用户无需专业技术背景即可使用自然语言查询数据。

了解 Automatic Data Agents

传统上，Snowflake 列表和共享要求使用者了解底层架构并编写 SQL 查询来提取数据。Automatic Data Agents 通过分析您的列表元数据和数据架构，自动构建以下对象，从而消除了这一障碍：

  • 语义视图：与 Cortex Analyst 兼容的业务友好型数据呈现形式。

  • Cortex Agent：理解数据特定领域和上下文的 AI 编排层。

对于提供商而言，这种自动化显著缩短了使列表或共享达到“Cortex AI 就绪”标准所需的时间，让您无需手动开发即可提供对话式数据体验。创建这些对象后，您只需将其附加到列表或共享中，客户和终端用户便可利用 Cortex AI 产品和功能轻松与您的数据进行交互。

小技巧

创建 Cortex AI 就绪列表时，请为列表添加 Cortex AI ready 类别。此类别有助于使用者更轻松地找到您的列表。

Automatic Data Agents 的主要功能

  • 一键生成 基于现有的元数据和表结构自动创建代理及语义视图对象。

  • 表与视图选择 让您可以选择在生成语义视图时包含哪些表和视图，从而让您控制通过代理公开哪些数据。

  • AI 驱动的语义建模 利用 语义视图 Autopilot 来识别表关系、指标和维度。

  • 动态代理指令 基于列表元数据生成具备上下文感知能力的角色和编排指令。（对于 Direct Share，则使用静态指令。）

  • 集成测试 让提供商在发布给使用者之前可以验证代理的响应。

  • 无缝发布 将生成的资产直接附加到现有的安全共享中，使使用者能立即使用。

注意事项

如果您希望为包含表或视图的新列表或现有列表（或共享）快速启用 AI 功能，请使用 Automatic Data Agents。

此功能最适合满足以下条件的列表和共享：

  • 数据结构在表或视图中有明确定义。

  • 对于列表，其描述清楚地解释了数据领域。（这有助于优化由 AI 生成的指令。）

  • 共享中尚未手动附加现有的语义视图或代理。

限制

  • 重新生成： 重新生成代理会替换现有的代理和语义视图对象，之前的版本将不予保留。

  • 对象位置： 生成的代理和语义视图必须与共享内容存储在同一个数据库中。

  • 独占式生成： 如果共享中已包含代理、语义视图或 Cortex Search Service，则无法使用此功能。

  • 生成时间： 视共享架构的复杂程度和大小而定，该过程最高可能耗时 10 分钟。

作为提供商使用 Automatic Data Agents

通过 Automatic Data Agents，您可以直接在 Provider Studio`（针对公开和私有 :doc:`Snowflake Marketplace </collaboration/collaboration-marketplace-about> 列表）、Internal Sharing`（针对 :doc:`内部市场 </user-guide/collaboration/listings/organizational/org-listing-about> 列表）或 External sharing 页面（针对不带列表的 Direct Share）中配置、测试和管理您的 AI 代理。

所需权限

要创建、编辑和管理 Automatic Data Agents，您需要具备以下权限：

创建对象（代理生成）所需的权限

权限

对象

目的

CORTEX_USER

数据库

包括允许用户调用 Snowflake AI 函数以及使用 LLMs 生成语义视图的权限。默认情况下，CORTEX_USER 角色被授予给 PUBLIC 角色。

CREATE SEMANTIC VIEW

架构

创建新的语义视图时需要

CREATE AGENT

架构

这是创建 Cortex 代理所必需的

SELECT

共享中的表/视图

语义视图定义中使用的任何表或视图都需要

USAGE

数据库

访问包含共享对象的数据库所需的权限

USAGE

架构

访问将在其中创建对象的目标架构所需的权限

备注

在创建语义视图期间，需要对表拥有 SELECT 权限。但在此之后，要查询语义视图，您只需对该语义视图本身拥有 SELECT 权限即可。

向共享添加对象（发布）所需的权限

权限

对象

目的

OWNERSHIP

共享

将对象的权限授予共享所需的权限

OWNERSHIP 或 MODIFY

列表

修改列表并提交审批所需的权限（仅在使用列表时适用）

向共享添加对象时，系统会自动执行以下授权：

  • GRANT USAGE ON AGENT ... TO SHARE

  • GRANT SELECT ON SEMANTIC VIEW ... TO SHARE

  • GRANT REFERENCES ON SEMANTIC VIEW ... TO SHARE

管理对象（重新生成/删除）所需的权限

权限

对象

目的

OWNERSHIP

代理

删除或替换代理所需的权限（自动授予创建者）

OWNERSHIP

语义视图

删除或替换语义视图所需的权限（自动授予创建者）

Automatic Data Agents 工作流程

  1. 启动 Automatic Data Agents。

  2. 使用 SQL 验证创建的对象。

  3. 测试数据代理。

  4. （可选）：管理数据代理。

  5. 将 Automatic Data Agents 附加到您的列表或共享。

启动 Automatic Data Agents

对于提供商，Automatic Data Agents 设置过程会分析您的列表或共享，并生成必要的 Cortex AI 对象。您可以对 Snowflake Marketplace 列表、|i-market|（组织）列表或 Direct Share 使用 Automatic Data Agents。在开始使用 Automatic Data Agents 之前，您必须提供 所有必需信息。

以下示例说明了如何在 Snowflake Marketplace 列表、Internal Marketplace 列表或 Direct Share 上配置 Automatic Data Agents。请选择适当的选项。

备注

自动生成向导仅在 Snowsight 中可用。

选项 1.在 Snowflake Marketplace 列表上启动 Automatic Data Agents

以下步骤假设您已创建了 Snowflake Marketplace 列表并为其附加了数据产品。有关更多信息，请参阅 创建并发布列表。

  1. 登录 Snowsight。

  2. 在导航菜单中，选择 Marketplace » Provider Studio。

  3. 在 Listings 选项卡上，选择您要配置的公开列表。

  4. 在该列表的 Secure share 选项卡中，于 Add an Agent to your listing 横幅处选择 Get started。

    显示代理启用横幅的图像。

    备注

    该列表必须附带共享。否则，Secure share 选项卡将不可用。该列表还必须包含所有必需信息。否则，Get started 按钮将被禁用。

  5. 在配置对话框中，输入以下值：

    • Agent Display Name：选择使用 时默认使用的角色和仓库。输入代理名称（默认为列表标题）。

    • Location：选择使用 时默认使用的角色和仓库。为生成的对象选择目标架构。

    • Tables/Views：选择使用 时默认使用的角色和仓库。选择要包含在语义视图中的表和视图。您可以从共享的可用表和视图中选择一个子集，以控制代理可以访问的数据。

      备注

      此架构必须与共享数据位于同一个数据库中。

  6. 选择 Create。

生成过程将立即开始。您可以查看每个步骤的状态，包括元数据检索、语义视图生成和代理创建。此过程可能需要几分钟。

显示生成过程进度的图像。

选项 2.在 Internal Marketplace 列表上启动 Automatic Data Agents

以下步骤假设您已创建了 Internal Marketplace 列表并为其附加了数据产品。有关更多信息，请参阅 创建组织列表。

  1. 登录 Snowsight。

  2. 在导航菜单中，选择 Data sharing » Internal sharing。

  3. 在 Internal sharing 页面上，选择您要配置的列表。

  4. 在该列表的 Secure share 选项卡中，于 Add an Agent to your listing 横幅处选择 Get started。

    显示代理启用横幅的图像。

    备注

    该列表必须附带共享。否则，Secure share 选项卡将不可用。该列表还必须包含所有必需信息。否则，Get started 按钮将被禁用。

  5. 在配置对话框中，输入以下值：

    • Agent Display Name：选择使用 时默认使用的角色和仓库。输入代理名称（默认为列表标题）。

    • Location：选择使用 时默认使用的角色和仓库。为生成的对象选择目标架构。

    • Tables/Views：选择使用 时默认使用的角色和仓库。选择要包含在语义视图中的表和视图。您可以从共享的可用表和视图中选择一个子集，以控制代理可以访问的数据。

      备注

      此架构必须与共享数据位于同一个数据库中。

  6. 选择 Create。

生成过程将立即开始。您可以查看每个步骤的状态，包括元数据检索、语义视图生成和代理创建。此过程可能需要几分钟。

显示生成过程进度的图像。

选项 3.在 Direct Share 上启动 Automatic Data Agents

您还可以为未与列表关联的 Direct Share 生成 Automatic Data Agents。

  1. 登录 Snowsight。

  2. 在导航菜单中，选择 Data sharing » External sharing。

  3. 在 Shared by your account 选项卡上，选择您要配置的共享。

  4. 在 Add an Agent to your share 横幅中，选择 Get started。

  5. 在配置对话框中，输入以下值：

    • Agent Display Name：选择使用 时默认使用的角色和仓库。输入代理的名称。

    • Location：选择使用 时默认使用的角色和仓库。为生成的对象选择目标架构。

    • Tables/Views：选择使用 时默认使用的角色和仓库。选择要包含在语义视图中的表和视图。您可以从共享的可用表和视图中选择一个子集，以控制代理可以访问的数据。

      备注

      此架构必须与共享数据位于同一个数据库中。

  6. 选择 Create。

生成过程将立即开始。您可以查看每个步骤的状态，包括元数据检索、语义视图生成和代理创建。此过程可能需要几分钟。

使用 SQL 验证创建的对象

您可以使用 SQL 验证创建的对象。

-- Verify the agent was created
SHOW AGENTS IN SCHEMA my_database.my_schema;

-- Verify the semantic view was created
SHOW SEMANTIC VIEWS IN SCHEMA my_database.my_schema;

测试数据代理

在发布之前，请验证代理是否能准确回答有关数据的问题。

  1. 在列表或共享的 Agent 部分中，找到生成的代理。

  2. 选择其中一个可用的 Try 按钮以打开 Cortex Studio。

    您可以测试代理响应或验证语义视图。

  3. 输入与数据相关的自然语言查询，例如，“上个月的平均销售额是多少？”

  4. 查看生成的 SQL 和文本响应的准确性。

  5. 如果需要调整，请手动编辑语义视图或更新列表描述，然后重新生成代理。

管理数据代理

重新生成代理

如果您的数据架构发生变更，或者您更新了列表描述以完善代理的上下文，您可以重新生成代理。

小心

重新生成会删除现有的代理和语义视图并创建新版本。对先前语义视图进行的任何手动编辑都将丢失。

  1. 在 Agent 部分的 More actions (...) 菜单中，选择 Regenerate agent。

  2. 确认操作以启动该过程。

删除代理

您可以删除未附加到共享的代理。如果要删除的代理已附加到共享，则需要先将其从共享中移除，然后才能删除。

  1. 在 Agent 部分中，选择 More actions (...) 菜单。

  2. 选择 Drop agent。

  3. 确认从账户中同时移除代理和语义视图。

将 Automatic Data Agents 附加到您的列表或共享

要使代理对使用者可用，请将其附加到安全共享。

  1. 导航至列表的 Secure share 选项卡，或 Direct Share 的共享详细信息页面。

  2. 在 Agent 部分中，选择 Add to secure share。

    显示“添加到安全共享”按钮的图像。

  3. 查看确认对话框，其中显示该代理和语义视图将被授权给该共享。

  4. 点击 Add。

    添加代理后，您账户中这些对象的任何更新都将立即提供给有权访问该列表或共享的使用者。

以使用者身份使用 Automatic Data Agents

作为使用者，您可以使用 Automatic Data Agents，使用自然语言查询数据。

对于 Snowflake Marketplace 列表，请执行以下步骤：

  1. 登录 Snowsight。

  2. 在导航菜单中，选择 Marketplace » Snowflake Marketplace。

  3. 选择您要访问的 Cortex AI 就绪列表；如果您还没有该列表，请将其 Get。

  4. 选择 Open，然后选择代理名称以进行测试。

对于 Internal Marketplace 列表，请执行以下步骤：

  1. 登录 Snowsight。

  2. 在导航菜单中，选择 Catalog » Internal Marketplace。

  3. 选择您要访问的 Cortex AI 就绪列表；如果您还没有该列表，请将其 Get。

  4. 选择 Open，然后选择代理名称以进行测试。

对于私密共享列表，请执行以下步骤：

  1. 登录 Snowsight。

  2. 在导航菜单中，选择 Data sharing » External sharing。

  3. 在 Shared with you 选项卡中，选择您要访问的 Cortex AI 就绪列表或共享；如果您还没有，请将其 Get。

  4. 选择 Open，然后选择代理名称以进行测试。