Monitoramento de solicitações de Cortex Agents¶
Os Cortex Agents registram em log os rastreamentos detalhados de todas as conversas para fins de auditoria e depuração. Com o monitoramento, você pode acessar o histórico da conversa de um agente implantado via Snowflake Intelligence ou API Agent. Além do histórico da conversa, você pode revisar o rastreamento detalhado do processo de planejamento do agente, seleção de ferramentas, resultados de execução e geração de respostas finais.
Informações coletadas em logs do Cortex Agent¶
Os logs do Cortex Agent incluem as seguintes informações:
Histórico de conversas associado a um thread
Rastreamento de execução do agente com intervalos, incluindo:
Planejamento de LLM
Execução de ferramentas (Cortex Search, Cortex Analyst, pesquisa na Web)
Geração de resposta deLLM
Execução de SQL
Geração de gráficos
Entradas e saídas associadas a cada intervalo
Feedback do usuário para cada resposta do agente
Acesso aos logs do Cortex Agent¶
Para visualizar os logs de conversas do Cortex Agent no Snowsight, faça o seguinte:
Faça login no Snowsight.
No menu de navegação, selecione AI & ML » Agents.
Selecione o agente cujos logs você deseja visualizar.
Navegue até o painel Monitoring da exibição do agente.
Os logs de monitoramento associados ao agente são armazenados na tabela de eventos SNOWFLAKE.LOCAL.AI_OBSERVABILITY_EVENTS. As entradas nessa tabela não podem ser modificadas.
Administradores com a função de aplicativo AI_OBSERVABILITY_ADMIN podem excluir entradas na tabela SNOWFLAKE.LOCAL.AI_OBSERVABILITY_EVENTS.
Controle de acesso e permissões¶
Para visualizar os logs do Cortex Agent, os usuários devem ter os seguintes privilégios:
Privilégios OWNERSHIP ou MONITOR no objeto AGENT
A função de banco de dados CORTEX_USER
A função do aplicativo AI_OBSERVABILITY_EVENTS_LOOKUP
O exemplo a seguir usa a função ACCOUNTADMIN para criar uma nova função agent_monitoring_user_role com as permissões necessárias para visualizar os logs do Cortex Agent. Essa nova função é então atribuída a 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;