共享 Cortex Agent¶

作为提供商，您可以与 Snowflake 上的其他组织共享现有的 Cortex Agent 代理，从而扩大代理的用户群，并将其价值带给其他 Snowflake 客户。您可以在 Snowflake Marketplace 上共享您的 Cortex Agent，或使用指定账户共享。有关成为 Snowflake Marketplace 提供商的更多信息，请参阅以提供商身份使用列表。

作为共享 Cortex Agent 的使用者，您可以访问易于使用的界面，从共享的结构化或非结构化数据中获取见解。有关使用 Cortex Agent 的更多信息，请参阅 Use listings as a consumer 和以使用者身份使用和管理 Snowflake Native Apps。

要求¶

共享 Cortex Agent 需要满足以下条件：

共享所有链接的对象，例如语义视图或 Cortex Search Service。有关更多信息，请参阅创建和配置共享和。
共享的链接对象必须与共享的 Cortex Agent 位于同一数据库中。
只能共享使用以下工具类型的代理：语义视图、Cortex Search Service 和函数。使用其他工具类型的代理（例如过程、技能或 MCP 连接器）无法共享。

将 Cortex Agent 设置为共享¶

您可以作为提供商通过 Provider Studio 在 Snowflake Marketplace 中共享 Cortex Agent。

您也可以通过 SQL 语句将代理设置为共享状态。以下示例将代理 my_agent 添加到共享 my_share：

GRANT USAGE ON AGENT my_agent TO SHARE my_share;

如果代理使用语义视图、Cortex Search Service 或函数等链接对象，您还必须将这些对象授予共享：

GRANT USAGE ON AGENT my_agent TO SHARE my_share;
GRANT SELECT, REFERENCES ON SEMANTIC VIEW my_sv TO SHARE my_share;
GRANT USAGE ON CORTEX SEARCH SERVICE my_css TO SHARE my_share;
GRANT USAGE ON FUNCTION my_function TO SHARE my_share;

将代理添加到现有共享时，已安装共享的使用者用户会收到试用代理的电子邮件通知。

在 Snowsight 中识别共享代理¶

在导航菜单中，选择 AI & ML » Agents。源列指示每个代理是本地还是共享。使用此列可快速区分在您的账户中创建的代理和从其他账户与您共享的代理。

使用共享的 Cortex Agent¶

当您获得包含共享 Cortex Agent 的列表时，您可以将该代理添加到 Snowflake Intelligence。为此，请在获取列表时保持 Add to Snowflake Intelligence 切换为启用状态。这使得共享代理可用作 Snowflake Intelligence 中的数据源。

获取列表时，“Add Agent to Snowflake Intelligence”切换按钮已启用。

仓库选择¶

默认情况下，共享代理使用默认仓库运行。您可以为查询和工具执行指定自定义仓库，以控制计算资源和成本。

要为共享代理配置自定义仓库，请执行以下操作：

登录 Snowsight。
在导航菜单中，选择 AI & ML » Agents。
选择共享代理。您可以通过源列识别共享代理。
选择 More options menu (...) ‣ Configure warehouses for tools。
选择 Custom，选择一个仓库，然后选择 Save。

配置自定义仓库后，共享代理将使用指定的仓库来运行查询和执行工具。

复制¶

共享的 Cortex Agent 支持复制。列表自动履行功能会将代理复制到其他区域，从而允许不同区域的使用者访问共享代理。

限制¶

以下限制适用于共享的 Cortex Agent：

SQL 表函数可以共享，但 Python 用户定义的表函数不能共享。
如果更新共享代理以使用新工具（例如语义视图、Cortex Search Service 或函数），还必须将这些新工具授予共享。不会自动添加新工具。

成本注意事项¶

除了向共享 Cortex Agent 的提供商支付的任何费用外，使用者还需要支付以下费用：

使用者调用共享代理时使用的输入和输出令牌。
使用者的 SQL 查询仓库使用情况和工具执行。

有关向提供商支付的费用的更多信息，请参阅为列表付费。有关 Snowflake 成本的更多信息，请参阅 Snowflake 服务消耗表。