ALTER EXTERNAL AGENT¶

修改现有外部代理的属性。在 Snowflake 中，外部代理代表生成式 AI 应用程序，用于 AI 可观察性。

另请参阅：: CREATE EXTERNAL AGENT、DROP EXTERNAL AGENT、SHOW EXTERNAL AGENTS、DESCRIBE EXTERNAL AGENT

语法¶

ALTER EXTERNAL AGENT [ IF EXISTS ] <name> SET
  [ COMMENT = '<comment>' ]

ALTER EXTERNAL AGENT [ IF EXISTS ] <name> ADD VERSION <version_name>

name

字符串,用于指定要修改的外部代理的标识符（即名称）。

如果标识符包含空格或特殊字符，则整个字符串必须放在双引号内。放在双引号内的标识符也区分大小写。

有关更多信息，请参阅标识符要求。

SET ...

为外部代理实例设置一个或多个指定属性：

ADD VERSION version_name

向外部代理添加一个新版本。版本表示应用程序的不同实现，例如不同的检索器、提示、LLMs 或推理配置。

用于执行此操作的角色必须至少具有以下权限：


权限	对象	备注
OWNERSHIP	External Agent	OWNERSHIP 是对象上的特殊权限，会自动授予创建该对象的角色，但也可以通过拥有者角色或任何具有 MANAGE GRANTS 权限的角色，使用 GRANT OWNERSHIP 命令将权限转移给其他角色。

对架构中的对象进行操作至少需要父数据库的一项权限和父架构的一项权限。

有关创建具有指定权限集的自定义角色的说明，请参阅创建自定义角色。

有关对安全对象执行 SQL 操作的相应角色和权限授予的一般信息，请参阅访问控制概述。

关于元数据：

注意

客户应确保在使用 Snowflake 服务时，不会将个人数据（用户对象除外）、敏感数据、出口管制数据或其他受监管数据作为元数据输入。有关更多信息，请参阅 Snowflake 中的元数据字段。

为外部代理设置注释：

ALTER EXTERNAL AGENT my_rag_app SET COMMENT = 'RAG application for customer support';

向外部代理添加版本：

ALTER EXTERNAL AGENT my_rag_app ADD VERSION "v2";