Surveiller les requêtes des Agents Cortex

Les Agents Cortex enregistrent des traces détaillées de toutes les conversations à des fins d’audit et de débogage. Grâce à la surveillance, vous pouvez accéder à l’historique de conversation d’un agent déployé via Snowflake Intelligence ou l’API d’agents. Outre l’historique des conversations, vous pouvez examiner le traçage détaillé du processus de planification des agents, de la sélection des outils, des résultats d’exécution et de la génération finale des réponses.

Informations collectées dans les journaux des Agents Cortex

Les journaux des Agents Cortex comprennent les informations suivantes :

  • Historique de conversation associé à un thread

  • Trace d’exécution des agents avec des spans incluant :

    • Planification LLM

    • Exécution de l’outil (Cortex Search, Cortex Analyst, recherche web)

    • Génération de réponses LLM

    • Exécution SQL

    • Génération de graphiques

  • Entrées et sorties associées à chaque span

  • Commentaires de l’utilisateur pour chaque réponse d’agent

Accéder aux journaux des Agents Cortex

Pour voir les journaux de conversation des Agents Cortex dans Snowsight, procédez comme suit :

  1. Connectez-vous à Snowsight.

  2. Dans le menu de navigation, sélectionnez AI & ML » Agents.

  3. Sélectionnez l’agent dont vous souhaitez voir les journaux.

  4. Naviguez jusqu’au panneau de la vue Monitoring de l’agent.

Les journaux de surveillance associés à l’agent sont stockés dans le tableau des événements SNOWFLAKE.LOCAL.AI_OBSERVABILITY_EVENTS. Les entrées de cette table ne peuvent pas être modifiées.

Les administrateurs avec le rôle d’application AI_OBSERVABILITY_ADMIN peuvent supprimer des entrées dans la table SNOWFLAKE.LOCAL.AI_OBSERVABILITY_EVENTS.

Contrôle d’accès et autorisations

Pour voir les journaux des Agents Cortex, les utilisateurs doivent disposer des privilèges suivants :

  • Les privilèges OWNERSHIP ou MONITOR sur l’objet AGENT

  • Le rôle de base de données CORTEX_USER

  • Le rôle d’application AI_OBSERVABILITY_EVENTS_LOOKUP

L’exemple suivant utilise le rôle ACCOUNTADMIN pour créer un nouveau rôle agent_monitoring_user_role avec les autorisations requises pour voir les journaux des Agents Cortex. Ce nouveau rôle est ensuite attribué à some_user.

USE ROLE ACCOUNTADMIN;
CREATE ROLE agent_monitoring_user_role;
GRANT MONITOR ON AGENT my_agent TO ROLE agent_monitoring_user_role;
GRANT DATABASE ROLE SNOWFLAKE.CORTEX_USER TO ROLE agent_monitoring_user_role;
GRANT APPLICATION ROLE SNOWFLAKE.AI_OBSERVABILITY_EVENTS_LOOKUP TO ROLE agent_monitoring_user_role;
GRANT ROLE agent_monitoring_user_role TO USER some_user;
Copy
Langage: Français