Vues d'historique DBMS_CLOUD_AI_AGENT

Les vues d'historique DBMS_CLOUD_AI sont classées dans les catégories suivantes :

Vues de l'historique de l'équipe

Ces vues affichent toutes les exécutions d'équipe des agents sur l'ensemble du système. Chaque ligne enregistre une exécution d'équipe d'agent, y compris le nom de l'équipe, les noms de travail, les horodatages de début ou de fin, l'état d'exécution et toutes les erreurs. Il sert de journal d'exécution de niveau supérieur et de lien vers l'historique de niveau tâche et outil pour une analyse plus approfondie.
Vues d'historique des tâches

Ces vues affichent les paramètres de tâche d'agent au sein d'une équipe. Ces vues contiennent les données contextuelles nécessaires à l'exécution d'une tâche d'agent. La tâche lit les paramètres d'entrée lorsqu'elle démarre et réécrit les résultats lorsqu'elle se termine. Il connecte le système de planification à la structure d'agent.
Vues de l'historique des outils

Ces vues affichent les appels aux outils dans l'ensemble du système. Chaque ligne consigne le nom de l'outil, l'agent déclencheur et la tâche, l'ID d'exécution de l'équipe, le nom de l'étape, les horodatages et les données d'entrée et de sortie. Utilisez-le pour auditer l'utilisation des outils, surveiller les intégrations et déboguer le comportement des outils.

Remarque : la prise en charge du package DBMS_CLOUD_AI_AGENT est disponible dans Oracle Database 19c à partir de la version 19.29 et dans Oracle Database 26ai à partir de la version 23.26.

Vue DBA_AI_AGENT_TEAM_HISTORY

La vue affiche toutes les exécutions d'équipe d'agent dans le système.

Seul l'administrateur de base de données est autorisé à accéder à cette vue. Ils peuvent accorder l'accès à d'autres utilisateurs. Les vues DBA* affichent les objets de tous les utilisateurs de base de données.

Colonne	Type de données	NULL	Description
`TEAM_EXEC_ID`	`VARCHAR2(128)`	`NOT NULL`	Stocke l'identificateur unique de l'instance de traitement d'équipe, généralement un GUID.
`TEAM_NAME`	`VARCHAR2(128)`	`NOT NULL`	Indique le nom de l'agent en cours d'exécution.
`TEAM_OWNER`	`VARCHAR2(128)`	`NOT NULL`	Spécifie le schéma propriétaire de l'équipe.
`START_DATE`	`TIMESTAMP`	`-`	Horodatage du début du traitement.
`END_DATE`	`TIMESTAMP`	`NOT NULL`	Horodatage de fin du traitement. Si le traitement est toujours en cours d'exécution, la valeur est NULL.
`STATE`	`VARCHAR2(30)`	`NOT NULL`	Indique l'état d'exécution actuel. Les valeurs possibles sont les suivantes : `RUNNING` : l'équipe de l'agent traite activement la demande. `WAITING_FOR_HUMAN` : l'équipe de l'agent a été mise en pause et attend la saisie ou l'approbation de l'utilisateur. `RESUMING` : l'équipe de l'agent continue après une pause ou une entrée humaine. `SUCCEEDED` : l'équipe de l'agent a terminé l'exécution et a produit une réponse finale. `FAILED` : l'équipe de l'agent s'est arrêtée en raison d'une erreur ou d'une condition non remplie.
`TEAM_INSTANCE_ID`	`NUMBER`	`-`	Indique l'ID d'instance de session où l'équipe d'agent a été exécutée.

USER_AI_AGENT_TEAM_HISTORY - Vue

La vue affiche toutes les exécutions d'équipe d'agent pour les équipes appartenant à l'utilisateur actuel.

L'utilisateur actuel peut voir l'historique de l'équipe qu'il possède. Vous ne pouvez pas accorder l'accès à d'autres utilisateurs. L'administrateur de base de données peut accéder à ces vues mais ne voit que les objets qu'il possède.

Colonne	Type de données	NULL	Description
`TEAM_EXEC_ID`	`VARCHAR2(128)`	`NOT NULL`	Stocke l'identificateur unique de l'instance d'exécution d'équipe, généralement un GUID.
`TEAM_NAME`	`VARCHAR2(128)`	`NOT NULL`	Indique le nom de l'agent en cours d'exécution.
`START_DATE`	`TIMESTAMP`	`-`	Horodatage du début du traitement.
`END_DATE`	`TIMESTAMP`	`NOT NULL`	Horodatage de fin du traitement. Si le traitement est toujours en cours d'exécution, la valeur est NULL.
`STATE`	`VARCHAR2(30)`	`NOT NULL`	Indique l'état d'exécution actuel. Les valeurs possibles sont les suivantes : `RUNNING` : l'équipe de l'agent traite activement la demande. `WAITING_FOR_HUMAN` : l'équipe de l'agent a été mise en pause et attend la saisie ou l'approbation de l'utilisateur. `RESUMING` : l'équipe de l'agent continue après une pause ou une entrée humaine. `SUCCEEDED` : l'équipe de l'agent a terminé l'exécution et a produit une réponse finale. `FAILED` : l'équipe de l'agent s'est arrêtée en raison d'une erreur ou d'une condition non remplie.
`TEAM_INSTANCE_ID`	`NUMBER`	`-`	Indique l'ID d'instance de session où l'équipe d'agent a été exécutée.

Vue DBA_AI_AGENT_TASK_HISTORY

Cette vue affiche les paramètres de tâche d'agent au sein d'une équipe.

Colonne	Type de données	NULL	Description
`TEAM_EXEC_ID`	`VARCHAR2(128)`	`NOT NULL`	Stocke l'identificateur unique de l'instance de traitement d'équipe, généralement un GUID.
`TEAM_NAME`	`VARCHAR2(128)`	`NOT NULL`	Spécifie le nom de l'équipe d'agent en cours d'exécution.
`TASK_OWNER`	`VARCHAR2(128)`		Spécifie le schéma propriétaire de l'équipe.
`AGENT_NAME`	`VARCHAR2(128)`	`NOT NULL`	Indique le nom de l'agent en cours d'exécution.
`TASK_NAME`	`VARCHAR2(128)`		Indique le nom de la tâche à exécuter.
`TASK_ORDER`	`NUMBER`		Identifie la position de la tâche actuelle dans la séquence d'équipe de l'agent. Une tâche pouvant apparaître plusieurs fois, `task_order` distingue cette occurrence spécifique.
`COVERSATION_PARAM`	`CLOB`		Fournit des paramètres JSON pour l'API de conversation, notamment : `conversation_id`, `title` et `title`.
`INPUT`	`CLOB`		Spécifie les données d'entrée de la tâche.
`RESULT`	`CLOB`		Stocke la sortie produite par la tâche. (Par exemple, texte, JSON, lignes ou message d'état).
`STATE`	`VARCHAR2(30)`	`NOT NULL`	Indique l'état d'exécution actuel. Les valeurs possibles sont les suivantes : `RUNNING` : l'équipe de l'agent traite activement la demande. `WAITING_FOR_HUMAN` : l'équipe de l'agent a été mise en pause et attend la saisie ou l'approbation de l'utilisateur. `RESUMING` : l'équipe de l'agent continue après une pause ou une entrée humaine. `SUCCEEDED` : l'équipe de l'agent a terminé l'exécution et a produit une réponse finale. `FAILED` : l'équipe de l'agent s'est arrêtée en raison d'une erreur ou d'une condition non remplie.
`START_DATE`	`TIMESTAMP`	`-`	Horodatage du début du traitement.
`END_DATE`	`TIMESTAMP`	`NOT NULL`	Horodatage de fin du traitement. Si le traitement est toujours en cours d'exécution, la valeur est NULL.

Vue USER_AI_AGENT_TASK_HISTORY

Cette vue affiche les paramètres de tâche d'agent pour les équipes de l'utilisateur en cours.

L'utilisateur actuel peut voir l'historique des tâches qu'il possède. Vous ne pouvez pas accorder l'accès à d'autres utilisateurs. L'administrateur de base de données peut accéder à ces vues mais ne voit que les objets qu'il possède.

Colonne	Type de données	NULL	Description
`TEAM_EXEC_ID`	`VARCHAR2(128)`	`NOT NULL`	Stocke l'identificateur unique de l'instance de traitement d'équipe, généralement un GUID.
`TEAM_NAME`	`VARCHAR2(128)`	`NOT NULL`	Spécifie le nom de l'équipe d'agent en cours d'exécution.
`AGENT_NAME`	`VARCHAR2(128)`	`NOT NULL`	Indique le nom de l'agent en cours d'exécution.
`TASK_NAME`	`VARCHAR2(128)`		Indique le nom de la tâche à exécuter.
`TASK_ORDER`	`NUMBER`		Identifie la position de la tâche actuelle dans la séquence d'équipe de l'agent. Une tâche pouvant apparaître plusieurs fois, `task_order` distingue cette occurrence spécifique.
`COVERSATION_PARAM`	`CLOB`		Fournit des paramètres JSON pour l'API de conversation, notamment : `conversation_id`, `title` et `title`.
`INPUT`	`CLOB`		Spécifie les données d'entrée de la tâche.
`RESULT`	`CLOB`		Stocke la sortie produite par la tâche. (Par exemple, texte, JSON, lignes ou message d'état).
`STATE`	`VARCHAR2(30)`	`NOT NULL`	Indique l'état d'exécution actuel. Les valeurs possibles sont les suivantes : `RUNNING` : l'équipe de l'agent traite activement la demande. `WAITING_FOR_HUMAN` : l'équipe de l'agent a été mise en pause et attend la saisie ou l'approbation de l'utilisateur. `RESUMING` : l'équipe de l'agent continue après une pause ou une entrée humaine. `SUCCEEDED` : l'équipe de l'agent a terminé l'exécution et a produit une réponse finale. `FAILED` : l'équipe de l'agent s'est arrêtée en raison d'une erreur ou d'une condition non remplie.
`START_DATE`	`TIMESTAMP`	`-`	Horodatage du début du traitement.
`END_DATE`	`TIMESTAMP`	`NOT NULL`	Horodatage de fin du traitement. Si le traitement est toujours en cours d'exécution, la valeur est NULL.

Vue DBA_AI_AGENT_TOOL_HISTORY

Cette vue répertorie les appels aux outils dans l'ensemble du système.

Colonne	Type de données	NULL	Description
`invocation_id`	`VARCHAR2(128)`	`NOT NULL`	Stocke l'identificateur unique de l'appel.
`TEAM_EXEC_ID`	`VARCHAR2(128)`	`NOT NULL`	Stocke l'identificateur unique de l'instance de traitement d'équipe, généralement un GUID.
`TASK_ORDER`	`NUMBER`	`-`	Identifie la position de la tâche actuelle dans la séquence d'équipe de l'agent. Une tâche pouvant apparaître plusieurs fois, `task_order` distingue cette occurrence spécifique.
`TOOL_OWNER`	`VARCHAR2(128)`	`-`	Schéma propriétaire de l'outil.
`TOOL_NAME`	`VARCHAR2(128)`	`-`	Indique le nom de l'outil appelé.
`AGENT_NAME`	`VARCHAR2(128)`	`-`	Indique le nom de l'agent utilisé pour appeler l'outil.
`TASK_NAME`	`VARCHAR2(128)`	`-`	Nom de la tâche qui a exécuté l'outil.
`START_DATE`	`TIMESTAMP`	`-`	Horodatage du démarrage de l'exécution de l'outil.
`END_DATE`	`TIMESTAMP`	`NOT NULL`	Horodatage de l'arrêt de l'outil. Si le traitement est toujours en cours d'exécution, la valeur est NULL.
`INPUT`	`CLOB`	`-`	Spécifie les données d'entrée de l'outil.
`OUTPUT`	`CLOB`	`-`	Stocke la sortie produite par l'outil. (Par exemple, texte, JSON, lignes ou message d'état).
`TOOL_OUTPUT`	`CLOB`	`-`	Messages de diagnostic de la fonction d'outil, utilisés pour le débogage ou le dépannage et le suivi du comportement.

USER_AI_AGENT_TOOL_HISTORY - Vue

Cette vue répertorie les appels aux outils dont l'utilisateur actuel est propriétaire.

L'utilisateur actuel peut voir l'historique des outils qu'il possède. Vous ne pouvez pas accorder l'accès à d'autres utilisateurs. L'administrateur de base de données peut accéder à ces vues mais ne voit que les objets qu'il possède.

Colonne	Type de données	NULL	Description
`invocation_id`	`VARCHAR2(128)`	`NOT NULL`	Stocke l'identificateur unique de l'appel.
`TEAM_EXEC_ID`	`VARCHAR2(128)`	`NOT NULL`	Stocke l'identificateur unique de l'instance de traitement d'équipe, généralement un GUID.
`TASK_ORDER`	`NUMBER`	`-`	Identifie la position de la tâche actuelle dans la séquence d'équipe de l'agent. Une tâche pouvant apparaître plusieurs fois, `task_order` distingue cette occurrence spécifique.
`TOOL_NAME`	`VARCHAR2(128)`	`-`	Indique le nom de l'outil appelé.
`AGENT_NAME`	`VARCHAR2(128)`	`-`	Indique le nom de l'agent utilisé pour appeler l'outil.
`TASK_NAME`	`VARCHAR2(128)`	`-`	Nom de la tâche qui a exécuté l'outil.
`START_DATE`	`TIMESTAMP`	`-`	Horodatage du démarrage de l'exécution de l'outil.
`END_DATE`	`TIMESTAMP`	`NOT NULL`	Horodatage de l'arrêt de l'outil. Si le traitement est toujours en cours d'exécution, la valeur est NULL.
`INPUT`	`CLOB`	`-`	Spécifie les données d'entrée de l'outil.
`OUTPUT`	`CLOB`	`-`	Stocke la sortie produite par l'outil. (Par exemple, texte, JSON, lignes ou message d'état).
`TOOL_OUTPUT`	`CLOB`	`-`	Messages de diagnostic de la fonction d'outil, utilisés pour le débogage ou le dépannage et le suivi du comportement.