ALTER EXTERNAL AGENT

Modifica as propriedades de um agente externo existente. Agentes externos representam aplicativos de AI generativa no Snowflake para uso com a observabilidade de AI.

Consulte também:

CREATE EXTERNAL AGENT, DROP EXTERNAL AGENT, SHOW EXTERNAL AGENTS, DESCRIBE EXTERNAL AGENT

Sintaxe

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

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

Parâmetros obrigatórios

name

Cadeia de caracteres que especifica o identificador (ou seja, nome) do agente externo a ser alterado.

Se o identificador contiver espaços ou caracteres especiais, toda a cadeia de caracteres deverá ser delimitada por aspas duplas. Os identificadores delimitados por aspas duplas também diferenciam letras maiúsculas de minúsculas.

Para obter mais informações, consulte Requisitos para identificadores.

Parâmetros opcionais

SET ...

Define uma ou mais propriedades especificadas para o agente externo:

COMMENT = comment

Especifica uma descrição do agente externo.

ADD VERSION version_name

Adiciona uma nova versão ao agente externo. As versões representam implementações diferentes do aplicativo, como recuperadores, prompts, LLMs ou configurações de inferência distintos.

Requisitos de controle de acesso

A função usada para executar essa operação deve ter, no mínimo, os seguintes privilégios:

Privilégio

Objeto

Notas

OWNERSHIP

Agent externo

OWNERSHIP é um privilégio especial para um objeto que é automaticamente concedido à função que criou o objeto, mas também pode ser transferido usando o comando GRANTOWNERSHIP para uma função diferente pela função proprietária (ou qualquer função com o privilégio MANAGE GRANTS).

Operar em um objeto em um esquema requer pelo menos um privilégio no banco de dados pai e pelo menos um privilégio no esquema pai.

Para instruções sobre como criar uma função personalizada com um conjunto específico de privilégios, consulte Criação de funções personalizadas.

Para informações gerais sobre concessões de funções e privilégios para executar ações de SQL em objetos protegíveis, consulte Visão geral do controle de acesso.

Notas de uso

  • Em relação aos metadados:

    Atenção

    Os clientes devem garantir que nenhum dado pessoal (exceto para um objeto do usuário), dados sensíveis, dados controlados por exportação ou outros dados regulamentados sejam inseridos como metadados ao usar o serviço Snowflake. Para obter mais informações, consulte Campos de metadados no Snowflake.

Exemplos

Definir um comentário em um agente externo:

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

Adicionar uma versão a um agente externo:

ALTER EXTERNAL AGENT my_rag_app ADD VERSION "v2";