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

GET_AI_OBSERVABILITY_LOGS (SNOWFLAKE.LOCAL)¶

Recupere dados de log para um evento de observabilidade do Cortex Agent, como um aviso ou falha.

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

Consulte também:: 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: O tipo de agente para o qual recuperar os dados de avaliação. Use a constante de cadeia de caracteres CORTEX AGENT. O 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
MONITOR	Cortex 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.

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.

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';