Vistas de historial de DBMS_CLOUD_AI_AGENT

Las vistas del historial DBMS_CLOUD_AI se clasifican en las siguientes categorías:

Vistas de historial de equipo

Estas vistas muestran todas las ejecuciones de equipo de agentes en el sistema. Cada fila registra una ejecución de equipo de agente, incluido el nombre del equipo, los nombres de trabajo, los registros de hora de inicio o finalización, el estado de ejecución y cualquier error. Sirve como log de ejecución de nivel superior, enlazando al historial de nivel de tarea y herramienta para un análisis más profundo.
Vistas de historial de tareas

Estas vistas muestran los parámetros de tarea del agente dentro de un equipo. Estas vistas contienen los datos contextuales necesarios para ejecutar una tarea de agente. La tarea lee los parámetros de entrada desde ella cuando se inicia y vuelve a escribir los resultados cuando finaliza. Conecta el sistema de programación con el marco del agente.
Vistas de historial de herramientas

Estas vistas muestran llamadas a herramientas en todo el sistema. Cada fila registra el nombre de la herramienta, disparando el agente y la tarea, el ID de ejecución del equipo, el nombre del paso, los registros de hora y los datos de entrada y salida. Utilícelo para auditar el uso de las herramientas, supervisar las integraciones y depurar el comportamiento de las herramientas.

Nota: El soporte para el paquete DBMS_CLOUD_AI_AGENT está disponible en Oracle Database 19c a partir de la versión 19.29 y en Oracle Database 26ai a partir de la versión 23.26.

Vista DBA_AI_AGENT_TEAM_HISTORY

La vista muestra todas las ejecuciones de equipo de agente en el sistema.

Solo el administrador de la base de datos tiene privilegios para acceder a esta vista. Pueden otorgar acceso a otros usuarios. Las vistas de DBA* muestran los objetos de todos los usuarios de la base de datos.

Columna	Tipo de dato	NULL	Descripción
`TEAM_EXEC_ID`	`VARCHAR2(128)`	`NOT NULL`	Almacena el identificador único de la instancia de ejecución de equipo, normalmente un GUID.
`TEAM_NAME`	`VARCHAR2(128)`	`NOT NULL`	Especifica el nombre del agente que se está ejecutando.
`TEAM_OWNER`	`VARCHAR2(128)`	`NOT NULL`	Especifica el esquema de propietario del equipo.
`START_DATE`	`TIMESTAMP`	`-`	Registro de hora en el que se inició el proceso.
`END_DATE`	`TIMESTAMP`	`NOT NULL`	Registro de hora en que finalizó el proceso. Si el proceso aún se está ejecutando, el valor es NULL.
`STATE`	`VARCHAR2(30)`	`NOT NULL`	Indica el estado de ejecución actual. Los posibles valores son: `RUNNING`: el equipo del agente está procesando activamente la solicitud. `WAITING_FOR_HUMAN`: el equipo del agente se ha detenido y está esperando la entrada o aprobación del usuario. `RESUMING`: el equipo del agente continúa después de una pausa o una entrada humana. `SUCCEEDED`: el equipo del agente ha finalizado la ejecución y ha producido una respuesta final. `FAILED`: el equipo del agente se detuvo debido a un error o una condición no cumplida.
`TEAM_INSTANCE_ID`	`NUMBER`	`-`	Especifica el ID de instancia de sesión en la que se ha ejecutado el equipo del agente.

Vista USER_AI_AGENT_TEAM_HISTORY

La vista muestra todas las ejecuciones de equipo de agente para los equipos que son propiedad del usuario actual.

El usuario actual puede ver el historial del equipo del que es propietario. No puede otorgar acceso a otros usuarios. El administrador de la base de datos puede acceder a estas vistas, pero solo ve los objetos de su propiedad.

Columna	Tipo de dato	NULL	Descripción
`TEAM_EXEC_ID`	`VARCHAR2(128)`	`NOT NULL`	Almacena el identificador único para la instancia de ejecución de equipo, normalmente un GUID.
`TEAM_NAME`	`VARCHAR2(128)`	`NOT NULL`	Especifica el nombre del agente que se está ejecutando.
`START_DATE`	`TIMESTAMP`	`-`	Registro de hora en el que se inició el proceso.
`END_DATE`	`TIMESTAMP`	`NOT NULL`	Registro de hora en que finalizó el proceso. Si el proceso aún se está ejecutando, el valor es NULL.
`STATE`	`VARCHAR2(30)`	`NOT NULL`	Indica el estado de ejecución actual. Los posibles valores son: `RUNNING`: el equipo del agente está procesando activamente la solicitud. `WAITING_FOR_HUMAN`: el equipo del agente se ha detenido y está esperando la entrada o aprobación del usuario. `RESUMING`: el equipo del agente continúa después de una pausa o una entrada humana. `SUCCEEDED`: el equipo del agente ha finalizado la ejecución y ha producido una respuesta final. `FAILED`: el equipo del agente se detuvo debido a un error o una condición no cumplida.
`TEAM_INSTANCE_ID`	`NUMBER`	`-`	Especifica el ID de instancia de sesión en la que se ha ejecutado el equipo del agente.

Vista DBA_AI_AGENT_TASK_HISTORY

Esta vista muestra los parámetros de tarea de agente dentro de un equipo.

Columna	Tipo de dato	NULL	Descripción
`TEAM_EXEC_ID`	`VARCHAR2(128)`	`NOT NULL`	Almacena el identificador único de la instancia de ejecución de equipo, normalmente un GUID.
`TEAM_NAME`	`VARCHAR2(128)`	`NOT NULL`	Especifica el nombre del equipo del agente que se está ejecutando.
`TASK_OWNER`	`VARCHAR2(128)`		Especifica el esquema de propietario del equipo.
`AGENT_NAME`	`VARCHAR2(128)`	`NOT NULL`	Especifica el nombre del agente que se está ejecutando.
`TASK_NAME`	`VARCHAR2(128)`		Indica el nombre de la tarea que se está ejecutando.
`TASK_ORDER`	`NUMBER`		Identifica la posición de la tarea actual en la secuencia de equipo del agente. Debido a que una tarea puede aparecer varias veces, `task_order` distingue esta ocurrencia específica.
`COVERSATION_PARAM`	`CLOB`		Proporciona parámetros JSON para la API de conversación, incluidos: `conversation_id`, `title` y `title`.
`INPUT`	`CLOB`		Especifica los datos de entrada para la tarea.
`RESULT`	`CLOB`		Almacena la salida producida por la tarea. (Por ejemplo, texto, JSON, filas o un mensaje de estado).
`STATE`	`VARCHAR2(30)`	`NOT NULL`	Indica el estado de ejecución actual. Los posibles valores son: `RUNNING`: el equipo del agente está procesando activamente la solicitud. `WAITING_FOR_HUMAN`: el equipo del agente se ha detenido y está esperando la entrada o aprobación del usuario. `RESUMING`: el equipo del agente continúa después de una pausa o una entrada humana. `SUCCEEDED`: el equipo del agente ha finalizado la ejecución y ha producido una respuesta final. `FAILED`: el equipo del agente se detuvo debido a un error o una condición no cumplida.
`START_DATE`	`TIMESTAMP`	`-`	Registro de hora en el que se inició el proceso.
`END_DATE`	`TIMESTAMP`	`NOT NULL`	Registro de hora en que finalizó el proceso. Si el proceso aún se está ejecutando, el valor es NULL.

Vista USER_AI_AGENT_TASK_HISTORY

Esta vista muestra los parámetros de tarea de agente para los equipos del usuario actual.

El usuario actual puede ver el historial de tareas de su propiedad. No puede otorgar acceso a otros usuarios. El administrador de la base de datos puede acceder a estas vistas, pero solo ve los objetos de su propiedad.

Columna	Tipo de dato	NULL	Descripción
`TEAM_EXEC_ID`	`VARCHAR2(128)`	`NOT NULL`	Almacena el identificador único de la instancia de ejecución de equipo, normalmente un GUID.
`TEAM_NAME`	`VARCHAR2(128)`	`NOT NULL`	Especifica el nombre del equipo del agente que se está ejecutando.
`AGENT_NAME`	`VARCHAR2(128)`	`NOT NULL`	Especifica el nombre del agente que se está ejecutando.
`TASK_NAME`	`VARCHAR2(128)`		Indica el nombre de la tarea que se está ejecutando.
`TASK_ORDER`	`NUMBER`		Identifica la posición de la tarea actual en la secuencia de equipo del agente. Debido a que una tarea puede aparecer varias veces, `task_order` distingue esta ocurrencia específica.
`COVERSATION_PARAM`	`CLOB`		Proporciona parámetros JSON para la API de conversación, incluidos: `conversation_id`, `title` y `title`.
`INPUT`	`CLOB`		Especifica los datos de entrada para la tarea.
`RESULT`	`CLOB`		Almacena la salida producida por la tarea. (Por ejemplo, texto, JSON, filas o un mensaje de estado).
`STATE`	`VARCHAR2(30)`	`NOT NULL`	Indica el estado de ejecución actual. Los posibles valores son: `RUNNING`: el equipo del agente está procesando activamente la solicitud. `WAITING_FOR_HUMAN`: el equipo del agente se ha detenido y está esperando la entrada o aprobación del usuario. `RESUMING`: el equipo del agente continúa después de una pausa o una entrada humana. `SUCCEEDED`: el equipo del agente ha finalizado la ejecución y ha producido una respuesta final. `FAILED`: el equipo del agente se detuvo debido a un error o una condición no cumplida.
`START_DATE`	`TIMESTAMP`	`-`	Registro de hora en el que se inició el proceso.
`END_DATE`	`TIMESTAMP`	`NOT NULL`	Registro de hora en que finalizó el proceso. Si el proceso aún se está ejecutando, el valor es NULL.

Vista DBA_AI_AGENT_TOOL_HISTORY

Esta vista muestra las llamadas a las herramientas en todo el sistema.

Columna	Tipo de dato	NULL	Descripción
`invocation_id`	`VARCHAR2(128)`	`NOT NULL`	Almacena el identificador único de la llamada.
`TEAM_EXEC_ID`	`VARCHAR2(128)`	`NOT NULL`	Almacena el identificador único de la instancia de ejecución de equipo, normalmente un GUID.
`TASK_ORDER`	`NUMBER`	`-`	Identifica la posición de la tarea actual en la secuencia de equipo del agente. Debido a que una tarea puede aparecer varias veces, `task_order` distingue esta ocurrencia específica.
`TOOL_OWNER`	`VARCHAR2(128)`	`-`	Esquema del propietario de la herramienta.
`TOOL_NAME`	`VARCHAR2(128)`	`-`	Indica el nombre de la herramienta que se llama.
`AGENT_NAME`	`VARCHAR2(128)`	`-`	Indica el nombre del agente que se utiliza para llamar a la herramienta.
`TASK_NAME`	`VARCHAR2(128)`	`-`	Nombre de la tarea que ha ejecutado la herramienta.
`START_DATE`	`TIMESTAMP`	`-`	El registro de hora cuando la herramienta comenzó a ejecutarse.
`END_DATE`	`TIMESTAMP`	`NOT NULL`	El registro de hora indica cuándo se detuvo la herramienta. Si el proceso aún se está ejecutando, el valor es NULL.
`INPUT`	`CLOB`	`-`	Especifica los datos de entrada para la herramienta.
`OUTPUT`	`CLOB`	`-`	Almacena la salida producida por la herramienta. (Por ejemplo, texto, JSON, filas o un mensaje de estado).
`TOOL_OUTPUT`	`CLOB`	`-`	Mensajes de diagnóstico de la función de herramienta, utilizados para la depuración o la resolución de problemas y el comportamiento de rastreo.

Vista USER_AI_AGENT_TOOL_HISTORY

Esta vista muestra las llamadas a las herramientas que posee el usuario actual.

El usuario actual puede ver el historial de herramientas de su propiedad. No puede otorgar acceso a otros usuarios. El administrador de la base de datos puede acceder a estas vistas, pero solo ve los objetos de su propiedad.

Columna	Tipo de dato	NULL	Descripción
`invocation_id`	`VARCHAR2(128)`	`NOT NULL`	Almacena el identificador único de la llamada.
`TEAM_EXEC_ID`	`VARCHAR2(128)`	`NOT NULL`	Almacena el identificador único de la instancia de ejecución de equipo, normalmente un GUID.
`TASK_ORDER`	`NUMBER`	`-`	Identifica la posición de la tarea actual en la secuencia de equipo del agente. Debido a que una tarea puede aparecer varias veces, `task_order` distingue esta ocurrencia específica.
`TOOL_NAME`	`VARCHAR2(128)`	`-`	Indica el nombre de la herramienta que se llama.
`AGENT_NAME`	`VARCHAR2(128)`	`-`	Indica el nombre del agente que se utiliza para llamar a la herramienta.
`TASK_NAME`	`VARCHAR2(128)`	`-`	Nombre de la tarea que ha ejecutado la herramienta.
`START_DATE`	`TIMESTAMP`	`-`	El registro de hora cuando la herramienta comenzó a ejecutarse.
`END_DATE`	`TIMESTAMP`	`NOT NULL`	El registro de hora indica cuándo se detuvo la herramienta. Si el proceso aún se está ejecutando, el valor es NULL.
`INPUT`	`CLOB`	`-`	Especifica los datos de entrada para la herramienta.
`OUTPUT`	`CLOB`	`-`	Almacena la salida producida por la herramienta. (Por ejemplo, texto, JSON, filas o un mensaje de estado).
`TOOL_OUTPUT`	`CLOB`	`-`	Mensajes de diagnóstico de la función de herramienta, utilizados para la depuración o la resolución de problemas y el comportamiento de rastreo.