Categorias:: Funções de tabela (Cortex Agents)

GET_AI_OBSERVABILITY_LOGS (SNOWFLAKE.LOCAL)¶

Recupere os dados de log de um evento de observabilidade da AI, como um aviso ou uma falha, para um aplicativo Cortex Agent ou External Agent (consulte External Agent commands).

Chame esta função para recuperar informações sobre quais eventos ocorreram durante a execução de uma avaliação. Para obter mais informações, consulte Avaliações do Cortex Agent e Dados de observabilidade.

Consulte também:: GET_AI_OBSERVABILITY_EVENTS (SNOWFLAKE.LOCAL) , GET_AI_RECORD_TRACE (SNOWFLAKE.LOCAL) , GET_AI_EVALUATION_DATA (SNOWFLAKE.LOCAL) , EXECUTE_AI_EVALUATION

Sintaxe¶

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

Argumentos¶

database: Nome do banco de dados que contém o agente.
schema: Nome do esquema que contém o agente.
agent_name: Nome do agente do qual recuperar um registro.
agent_type: A cadeia de caracteres do tipo de agente. Use CORTEX AGENT para uma avaliação do Cortex Agent ou EXTERNAL AGENT para um objeto External Agent (consulte External Agent commands). Esse valor não diferencia maiúsculas de minúsculas.

Retornos¶

Para obter detalhes sobre as informações contidas nos eventos de observabilidade da AI, consulte Dados de observabilidade.

Requisitos de controle de acesso¶

A função usada para executar essa operação deve ter, no mínimo, os seguintes privilégios:


Privilégio	Objeto	Notas
CORTEX_USER	Função de banco de dados
USAGE	Cortex Agent ou External Agent	Necessário no objeto identificado por `agent_name`. Para `EXTERNAL AGENT`, USAGE no External Agent é suficiente para chamar esta função (MONITOR não se aplica).
MONITOR	Cortex Agent	Necessário no Cortex Agent identificado por `agent_name` quando `agent_type` é `CORTEX AGENT`. Não se aplica quando `agent_type` é `EXTERNAL AGENT`.

Operar em um objeto em um esquema requer pelo menos um privilégio no banco de dados pai e pelo menos um privilégio no esquema pai.

Para instruções sobre como criar uma função personalizada com um conjunto específico de privilégios, consulte Criação de funções personalizadas.

Para informações gerais sobre concessões de funções e privilégios para executar ações de SQL em objetos protegíveis, consulte Visão geral do controle de acesso.

Quando agent_type é EXTERNAL AGENT, somente USAGE nesse objeto é necessário para chamar esta função. OWNERSHIP no External Agent é necessário para modificar ou remover o objeto com ALTER EXTERNAL AGENT ou DROP EXTERNAL AGENT.

Para obter as permissões de controle de acesso completo exigidas pelas avaliações do Cortex Agent, consulte Avaliações do Cortex Agent – Requisitos de controle de acesso. Para consultar os objetos External Agent, veja Dados de observabilidade.

Exemplos¶

O exemplo a seguir verifica erros e avisos para uma execução chamada run-1, em que o agente é chamado evaluated_agent e armazenado no esquema 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';