Catégories :: Fonctions de table (Cortex Agents)

GET_AI_OBSERVABILITY_EVENTS (SNOWFLAKE.LOCAL)¶

Renvoyer les événements d’observabilité AI de la table AI_OBSERVABILITY_EVENTS dans le schéma LOCAL. Transmettre CORTEX AGENT comme agent_type pour un Cortex Agent, ou``EXTERNAL AGENT`` pour un objet Agent externe utilisé avec l’observabilité AI (voir:doc:/sql-reference/commands-external-agent). Chaque ligne utilise la disposition des colonnes de la table d’événements (notamment RECORD, RECORD_ATTRIBUTES, VALUE et les champs de trace). Les événements peuvent représenter l’activité de la conversation, des spans (planification, outils, génération de réponses), des journaux, les commentaires de l’utilisateur et d’autres télémétries écrites pour l’agent ou l’application.

Pour les workflows Snowsight et des exemples d’événements de filtrage (y compris des commentaires), voir Surveiller les requêtes des Agents Cortex. Pour savoir comment l’observabilité AI stocke les données dans la table des événements, voir Données d’observabilité.

Voir aussi :: GET_AI_OBSERVABILITY_LOGS (SNOWFLAKE.LOCAL), GET_AI_RECORD_TRACE (SNOWFLAKE.LOCAL), GET_AI_EVALUATION_DATA (SNOWFLAKE.LOCAL)

Syntaxe¶

SNOWFLAKE.LOCAL.GET_AI_OBSERVABILITY_EVENTS( <database>, <schema>, <agent_name>, <agent_type> )

Arguments¶

database: Nom de la base de données contenant l’agent.
schema: Nom du schéma contenant l’agent.
agent_name: Nom de l’agent dont vous souhaitez récupérer les événements d’observabilité.
agent_type: La chaîne du type d’agent. Utiliser CORTEX AGENT pour un Cortex Agent (voir Surveiller les requêtes des Agents Cortex) ou EXTERNAL AGENT pour un objet Agent externe (voir:doc:/sql-reference/commands-external-agent). La valeur est insensible à la casse.

Renvoie¶

Une table d’événements d’observabilité. Les définitions des colonnes suivent le schéma de table d’événements. Filtrer et projeter avec instructions SQL standard (par exemple sur les champs RECORD:name, RECORD_ATTRIBUTES ou les champs de gravité à l’intérieur de RECORD) pour se limiter à des types d’événements spécifiques.

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
CORTEX_USER	Rôle de la base de données
USAGE	Cortex Agent ou Agent externe	Requis sur l’objet identifié par `agent_name`. Pour `EXTERNAL AGENT` ,USAGE sur l’Agent externe est suffisant pour appeler cette fonction (MONITOR ne s’applique pas).
MONITOR	Agent Cortex	Requis sur l’Agent Cortex identifié par `agent_name` quand `agent_type` est `CORTEX AGENT`. Ne s’applique pas lorsque `agent_type` est `EXTERNAL AGENT`.

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.

Lorsque agent_type est EXTERNAL AGENT, uniquement USAGE sur cet objet est nécessaire pour appeler cette fonction. OWNERSHIP sur l’Agent externe est nécessaire pour modifier ou supprimer l’objet avec ALTER EXTERNAL AGENT ou DROP EXTERNAL AGENT.

Pour la configuration type de la surveillance de Cortex Agent (y compris les autorisations pour les futurs agents), voir Surveiller les requêtes des Agents Cortex. Pour l’accès Agent externe aux données d’observabilité, voir Données d’observabilité.

Exemples¶

Renvoyer les événements d’observabilité pour un agent :

SELECT *
  FROM TABLE(SNOWFLAKE.LOCAL.GET_AI_OBSERVABILITY_EVENTS(
    'my_database',
    'my_schema',
    'my_agent',
    'CORTEX AGENT'
  ));

Pour lister uniquement les événements de commentaire des utilisateurs, filtrez par nom d’événement (voir Afficher les commentaires fournis par les utilisateurs) :

SELECT *
  FROM TABLE(SNOWFLAKE.LOCAL.GET_AI_OBSERVABILITY_EVENTS(
    'my_database',
    'my_schema',
    'my_agent',
    'CORTEX AGENT'
  ))
  WHERE RECORD:name = 'CORTEX_AGENT_FEEDBACK';

La même fonction fonctionne pour une application instrumentée en externe en transmettant EXTERNAL AGENT comme``agent_type`` et le nom de l’objet Agent externe dans:samp:{agent_name} (voir Données d’observabilité).