Visualizações do histórico DBMS_CLOUD_AI_AGENT

As exibições de histórico DBMS_CLOUD_AI são categorizadas no seguinte:

Visualizações do histórico da equipe

Essas visualizações mostram todas as execuções de equipe do agente no sistema. Cada linha registra uma execução da equipe do agente, incluindo o nome da equipe, os nomes das tarefas, os carimbos de data/hora de início ou término, o estado da execução e quaisquer erros. Ele serve como o log de execução de nível superior, vinculando ao histórico de nível de tarefa e ferramenta para uma análise mais profunda.
Visualizações do histórico da tarefa

Essas exibições mostram os parâmetros da tarefa do agente dentro de uma equipe. Essas exibições contêm os dados contextuais necessários para executar uma tarefa do agente. A tarefa lê os parâmetros de entrada dele quando ele é iniciado e grava os resultados quando ele é concluído. Ele conecta o sistema de agendamento com a estrutura do agente.
Visualizações do histórico de ferramentas

Essas visualizações mostram chamadas para ferramentas em todo o sistema. Cada linha registra o nome da ferramenta, o agente acionador e a tarefa, o ID de execução da equipe, o nome da etapa, os timestamps e os dados de entrada e saída. Use-o para auditar o uso da ferramenta, monitorar integrações e depurar o comportamento da ferramenta.

Observação: O suporte para o pacote DBMS_CLOUD_AI_AGENT está disponível no Oracle Database 19c a partir da versão 19.29 e no Oracle Database 26ai a partir da versão 23.26.

Visualização DBA_AI_AGENT_TEAM_HISTORY

A visualização exibe todas as execuções de equipe do agente no sistema.

Somente o Administrador do Banco de Dados tem privilégios para acessar esta view. Eles podem conceder acesso a outros usuários. As views DBA* mostram objetos de todos os usuários do Banco de Dados.

Coluna	Tipo de dados	NULL	Descrição
`TEAM_EXEC_ID`	`VARCHAR2(128)`	`NOT NULL`	Armazena o identificador exclusivo da instância de execução da equipe, geralmente um GUID.
`TEAM_NAME`	`VARCHAR2(128)`	`NOT NULL`	Especifica o nome do agente que está sendo executado.
`TEAM_OWNER`	`VARCHAR2(128)`	`NOT NULL`	Especifica o esquema do proprietário da equipe.
`START_DATE`	`TIMESTAMP`	`-`	O timestamp de início do processo.
`END_DATE`	`TIMESTAMP`	`NOT NULL`	O marcador de data/hora em que o processo foi encerrado. Se o processo ainda estiver em execução, o valor será NULL.
`STATE`	`VARCHAR2(30)`	`NOT NULL`	Indica o estado de execução atual. Os possíveis valores são: `RUNNING`: A equipe do agente está processando ativamente a solicitação. `WAITING_FOR_HUMAN`: A equipe do agente pausou e está aguardando a entrada ou aprovação do usuário. `RESUMING`: A equipe do agente continua após uma pausa ou entrada humana. `SUCCEEDED`: A equipe do agente terminou a execução e produziu uma resposta final. `FAILED`: A equipe do agente foi interrompida por causa de um erro ou condição não atendida.
`TEAM_INSTANCE_ID`	`NUMBER`	`-`	Especifica o ID da instância da sessão em que a equipe do agente foi executada.

USER_AI_AGENT_TEAM_HISTORY

A exibição exibe todas as execuções da equipe do agente para equipes pertencentes ao usuário atual.

O usuário atual pode ver o histórico da equipe de sua propriedade. Você não pode conceder acesso a outros usuários. O Administrador do Banco de Dados pode acessar essas views, mas vê apenas os objetos de sua propriedade.

Coluna	Tipo de dados	NULL	Descrição
`TEAM_EXEC_ID`	`VARCHAR2(128)`	`NOT NULL`	Armazena o identificador exclusivo da instância de execução da equipe, geralmente um GUID.
`TEAM_NAME`	`VARCHAR2(128)`	`NOT NULL`	Especifica o nome do agente que está sendo executado.
`START_DATE`	`TIMESTAMP`	`-`	O timestamp de início do processo.
`END_DATE`	`TIMESTAMP`	`NOT NULL`	O marcador de data/hora em que o processo foi encerrado. Se o processo ainda estiver em execução, o valor será NULL.
`STATE`	`VARCHAR2(30)`	`NOT NULL`	Indica o estado de execução atual. Os possíveis valores são: `RUNNING`: A equipe do agente está processando ativamente a solicitação. `WAITING_FOR_HUMAN`: A equipe do agente pausou e está aguardando a entrada ou aprovação do usuário. `RESUMING`: A equipe do agente continua após uma pausa ou entrada humana. `SUCCEEDED`: A equipe do agente terminou a execução e produziu uma resposta final. `FAILED`: A equipe do agente foi interrompida por causa de um erro ou condição não atendida.
`TEAM_INSTANCE_ID`	`NUMBER`	`-`	Especifica o ID da instância da sessão em que a equipe do agente foi executada.

Visualização DBA_AI_AGENT_TASK_HISTORY

Esta exibição mostra os parâmetros da tarefa do agente em uma equipe.

Coluna	Tipo de dados	NULL	Descrição
`TEAM_EXEC_ID`	`VARCHAR2(128)`	`NOT NULL`	Armazena o identificador exclusivo da instância de execução da equipe, geralmente um GUID.
`TEAM_NAME`	`VARCHAR2(128)`	`NOT NULL`	Especifica o nome da equipe do agente que está sendo executada.
`TASK_OWNER`	`VARCHAR2(128)`		Especifica o esquema do proprietário da equipe.
`AGENT_NAME`	`VARCHAR2(128)`	`NOT NULL`	Especifica o nome do agente que está sendo executado.
`TASK_NAME`	`VARCHAR2(128)`		Indica o nome da tarefa que está sendo executada.
`TASK_ORDER`	`NUMBER`		Identifica a posição da tarefa atual na sequência da equipe do agente. Como uma tarefa pode aparecer várias vezes, `task_order` distingue essa ocorrência específica.
`COVERSATION_PARAM`	`CLOB`		Fornece parâmetros JSON para a API de conversa, incluindo: `conversation_id`, `title` e `title`.
`INPUT`	`CLOB`		Especifica os dados de entrada para a tarefa.
`RESULT`	`CLOB`		Armazena a saída produzida pela tarefa. (Por exemplo, texto, JSON, linhas ou uma mensagem de status).
`STATE`	`VARCHAR2(30)`	`NOT NULL`	Indica o estado de execução atual. Os possíveis valores são: `RUNNING`: A equipe do agente está processando ativamente a solicitação. `WAITING_FOR_HUMAN`: A equipe do agente pausou e está aguardando a entrada ou aprovação do usuário. `RESUMING`: A equipe do agente continua após uma pausa ou entrada humana. `SUCCEEDED`: A equipe do agente terminou a execução e produziu uma resposta final. `FAILED`: A equipe do agente foi interrompida por causa de um erro ou condição não atendida.
`START_DATE`	`TIMESTAMP`	`-`	O timestamp de início do processo.
`END_DATE`	`TIMESTAMP`	`NOT NULL`	O marcador de data/hora em que o processo foi encerrado. Se o processo ainda estiver em execução, o valor será NULL.

USER_AI_AGENT_TASK_HISTORY

Esta exibição mostra os parâmetros da tarefa do agente para as equipes do usuário atual.

O usuário atual pode ver o histórico de tarefas que possui. Você não pode conceder acesso a outros usuários. O Administrador do Banco de Dados pode acessar essas views, mas vê apenas os objetos de sua propriedade.

Coluna	Tipo de dados	NULL	Descrição
`TEAM_EXEC_ID`	`VARCHAR2(128)`	`NOT NULL`	Armazena o identificador exclusivo da instância de execução da equipe, geralmente um GUID.
`TEAM_NAME`	`VARCHAR2(128)`	`NOT NULL`	Especifica o nome da equipe do agente que está sendo executada.
`AGENT_NAME`	`VARCHAR2(128)`	`NOT NULL`	Especifica o nome do agente que está sendo executado.
`TASK_NAME`	`VARCHAR2(128)`		Indica o nome da tarefa que está sendo executada.
`TASK_ORDER`	`NUMBER`		Identifica a posição da tarefa atual na sequência da equipe do agente. Como uma tarefa pode aparecer várias vezes, o `task_order` distingue essa ocorrência específica.
`COVERSATION_PARAM`	`CLOB`		Fornece parâmetros JSON para a API de conversa, incluindo: `conversation_id`, `title` e `title`.
`INPUT`	`CLOB`		Especifica os dados de entrada para a tarefa.
`RESULT`	`CLOB`		Armazena a saída produzida pela tarefa. (Por exemplo, texto, JSON, linhas ou uma mensagem de status).
`STATE`	`VARCHAR2(30)`	`NOT NULL`	Indica o estado de execução atual. Os possíveis valores são: `RUNNING`: A equipe do agente está processando ativamente a solicitação. `WAITING_FOR_HUMAN`: A equipe do agente pausou e está aguardando a entrada ou aprovação do usuário. `RESUMING`: A equipe do agente continua após uma pausa ou entrada humana. `SUCCEEDED`: A equipe do agente terminou a execução e produziu uma resposta final. `FAILED`: A equipe do agente foi interrompida por causa de um erro ou condição não atendida.
`START_DATE`	`TIMESTAMP`	`-`	O timestamp de início do processo.
`END_DATE`	`TIMESTAMP`	`NOT NULL`	O marcador de data/hora em que o processo foi encerrado. Se o processo ainda estiver em execução, o valor será NULL.

Visualização DBA_AI_AGENT_TOOL_HISTORY

Essa visualização lista as chamadas para ferramentas no sistema.

Coluna	Tipo de dados	NULL	Descrição
`invocation_id`	`VARCHAR2(128)`	`NOT NULL`	Armazena o identificador exclusivo da chamada.
`TEAM_EXEC_ID`	`VARCHAR2(128)`	`NOT NULL`	Armazena o identificador exclusivo da instância de execução da equipe, geralmente um GUID.
`TASK_ORDER`	`NUMBER`	`-`	Identifica a posição da tarefa atual na sequência da equipe do agente. Como uma tarefa pode aparecer várias vezes, `task_order` distingue essa ocorrência específica.
`TOOL_OWNER`	`VARCHAR2(128)`	`-`	Esquema proprietário da ferramenta.
`TOOL_NAME`	`VARCHAR2(128)`	`-`	Indica o nome da ferramenta que é chamada.
`AGENT_NAME`	`VARCHAR2(128)`	`-`	Indica o nome do agente que é usado para chamar a ferramenta.
`TASK_NAME`	`VARCHAR2(128)`	`-`	Nome da tarefa que executou a ferramenta.
`START_DATE`	`TIMESTAMP`	`-`	O timestamp em que a ferramenta começou a ser executada.
`END_DATE`	`TIMESTAMP`	`NOT NULL`	O timestamp de quando a ferramenta foi interrompida. Se o processo ainda estiver em execução, o valor será NULL.
`INPUT`	`CLOB`	`-`	Especifica os dados de entrada da ferramenta.
`OUTPUT`	`CLOB`	`-`	Armazena a saída produzida pela ferramenta. (Por exemplo, texto, JSON, linhas ou uma mensagem de status).
`TOOL_OUTPUT`	`CLOB`	`-`	Mensagens de diagnóstico da função da ferramenta, usadas para depurar ou diagnosticar e solucionar problemas e rastrear comportamentos.

Visualização USER_AI_AGENT_TOOL_HISTORY

Esta visualização lista as chamadas para as ferramentas que o usuário atual possui.

O usuário atual pode ver o histórico de ferramentas que possui. Você não pode conceder acesso a outros usuários. O Administrador do Banco de Dados pode acessar essas views, mas vê apenas os objetos de sua propriedade.

Coluna	Tipo de dados	NULL	Descrição
`invocation_id`	`VARCHAR2(128)`	`NOT NULL`	Armazena o identificador exclusivo da chamada.
`TEAM_EXEC_ID`	`VARCHAR2(128)`	`NOT NULL`	Armazena o identificador exclusivo da instância de execução da equipe, geralmente um GUID.
`TASK_ORDER`	`NUMBER`	`-`	Identifica a posição da tarefa atual na sequência da equipe do agente. Como uma tarefa pode aparecer várias vezes, `task_order` distingue essa ocorrência específica.
`TOOL_NAME`	`VARCHAR2(128)`	`-`	Indica o nome da ferramenta que é chamada.
`AGENT_NAME`	`VARCHAR2(128)`	`-`	Indica o nome do agente que é usado para chamar a ferramenta.
`TASK_NAME`	`VARCHAR2(128)`	`-`	Nome da tarefa que executou a ferramenta.
`START_DATE`	`TIMESTAMP`	`-`	O timestamp quando a ferramenta começou a ser executada.
`END_DATE`	`TIMESTAMP`	`NOT NULL`	O timestamp de quando a ferramenta foi interrompida. Se o processo ainda estiver em execução, o valor será NULL.
`INPUT`	`CLOB`	`-`	Especifica os dados de entrada da ferramenta.
`OUTPUT`	`CLOB`	`-`	Armazena a saída produzida pela ferramenta. (Por exemplo, texto, JSON, linhas ou uma mensagem de status).
`TOOL_OUTPUT`	`CLOB`	`-`	Mensagens de diagnóstico da função da ferramenta, usadas para depurar ou diagnosticar e solucionar problemas e rastrear comportamentos.