ALTER EXTERNAL AGENT¶

Modifie les propriétés d’un agent externe existant. Les agents externes représentent les applications d’AI générative dans Snowflake à utiliser avec l’observabilité de l’AI.

Voir aussi :: CREATE EXTERNAL AGENT, DROP EXTERNAL AGENT, SHOW EXTERNAL AGENTS, DESCRIBE EXTERNAL AGENT

Syntaxe¶

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

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

Paramètres requis¶

name

Chaîne spécifiant l’identificateur (c’est-à-dire le nom) de l’agent externe à modifier.

Si l’identificateur contient des espaces ou des caractères spéciaux, toute la chaîne doit être délimitée par des guillemets doubles. Les identificateurs entre guillemets doubles sont également sensibles à la casse.

Pour plus d’informations, voir Exigences relatives à l’identificateur.

Paramètres facultatifs¶

SET ...

Définit une ou plusieurs propriétés spécifiées pour l’agent externe :

COMMENT = comment: Spécifie une description de l’agent externe.

ADD VERSION version_name

Ajoute une nouvelle version à l’agent externe. Les versions représentent différentes implémentations de l’application, telles que différents récupérateurs, différentes invites,LLMs ou configurations d’inférence.

Exigences en matière de contrôle d’accès¶

Un rôle utilisé pour exécuter cette opération doit au minimum disposer des privilèges suivants :


Privilège	Objet	Remarques
OWNERSHIP	Agent externe	OWNERSHIP est un privilège spécial sur un objet qui est automatiquement accordé au rôle qui a créé l’objet, mais qui peut aussi être transféré à l’aide de la commande GRANTOWNERSHIP à un rôle différent par le rôle propriétaire (ou par tout rôle avec le privilège MANAGEGRANTS).

Pour effectuer une opération sur un objet dans un schéma, il est nécessaire de disposer d’au moins un privilège sur la base de données parente et d’au moins un privilège sur le schéma parent.

Pour obtenir des instructions sur la création d’un rôle personnalisé avec un ensemble spécifique de privilèges, voir Création de rôles personnalisés.

Pour des informations générales sur les rôles et les privilèges accordés pour effectuer des actions SQL sur des objets sécurisables, voir Aperçu du contrôle d’accès.

Notes sur l’utilisation¶

Concernant les métadonnées :

Attention

Les clients doivent s’assurer qu’aucune donnée personnelle (autre que pour un objet utilisateur), donnée sensible, donnée à exportation contrôlée ou autre donnée réglementée n’est saisie comme métadonnée lors de l’utilisation du service Snowflake. Pour plus d’informations, voir Champs de métadonnées dans Snowflake.

Exemples¶

Définir un commentaire sur un agent externe :

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

Ajouter une version à un agent externe :

ALTER EXTERNAL AGENT my_rag_app ADD VERSION "v2";