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

GET_AI_OBSERVABILITY_LOGS (SNOWFLAKE.LOCAL)¶

Récupérez les données de journalisation d’un événement d’observabilité AI, tel qu’un avertissement ou un échec, pour un Agent Cortex ou une application Agent externe (voir Commandes External Agent).

Appelez cette fonction pour récupérer des informations sur les événements qui se sont produits lors d’une exécution d’évaluation. Pour plus d’informations, voir Évaluations Cortex Agent et Données d’observabilité.

Voir aussi :: GET_AI_OBSERVABILITY_EVENTS (SNOWFLAKE.LOCAL) , GET_AI_RECORD_TRACE (SNOWFLAKE.LOCAL) , GET_AI_EVALUATION_DATA (SNOWFLAKE.LOCAL) , EXECUTE_AI_EVALUATION

Syntaxe¶

SNOWFLAKE.LOCAL.GET_AI_OBSERVABILITY_LOGS( <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 pour lequel récupérer un enregistrement.
agent_type: La chaîne du type d’agent. Utilisez CORTEX AGENT pour une évaluation Agent Cortex ou EXTERNAL AGENT pour un objet Agent externe (voir Commandes External Agent). La valeur est insensible à la casse.

Renvoie¶

Pour plus de détails sur les informations contenues dans les événements d’observabilité AI, voir Données d’observabilité.

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	Agent Cortex ou Agent externe	Requis sur l’objet identifié par `agent_name`. Pour `EXTERNAL AGENT`, USAGE sur l’Agent externe suffit pour appeler cette fonction (MONITOR ne s’applique pas).
MONITOR	Agent Cortex	Requis sur l’Agent Cortex identifié par `agent_name` lorsque `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, seul 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 connaître les autorisations de contrôle d’accès complètes requises par les évaluations des Agents Cortex, consultez Évaluations des Agents Cortex — Exigences en matière de contrôle d’accès. Pour les objets Agents Externes, consultez Données d’observabilité.

Exemples¶

L’exemple suivant vérifie les erreurs et les avertissements pour une exécution appelée run-1, où l’agent est nommé evaluated_agent stocké sur le schéma eval_db.eval_schema :

SELECT * FROM TABLE(SNOWFLAKE.LOCAL.GET_AI_OBSERVABILITY_LOGS(
  'eval_db',
  'eval_schema',
  'evaluated_agent',
  'CORTEX AGENT')
)
  WHERE TRUE
    AND (record:"severity_text"='ERROR' or record:"severity_text"='WARN')
    AND record_attributes:"snow.ai.observability.run.name"='run-1';