DBMS_CLOUD_AI_AGENTの履歴ビュー

DBMS_CLOUD_AI履歴ビューは、次のように分類されます。

チーム履歴ビュー

これらのビューには、システム全体のすべてのエージェント・チーム実行が表示されます。各行には、チーム名、ジョブ名、開始または終了のタイムスタンプ、実行状態、エラーなど、1つのエージェント・チームの実行が記録されます。これは、より深い分析のためにタスクレベルおよびツールレベルの履歴にリンクするトップレベルの実行ログとして機能します。
タスク履歴表示

これらのビューには、チーム内のエージェント・タスク・パラメータが表示されます。これらのビューには、エージェント・タスクの実行に必要なコンテキスト・データが保持されます。タスクは、開始時に入力パラメータを読み取り、終了時に結果を書き戻します。スケジューリング・システムをエージェント・フレームワークに接続します。
ツール履歴ビュー

これらのビューには、システム全体のツールへの呼び出しが表示されます。各行には、ツール名、トリガー・エージェントとタスク、チーム実行ID、ステップ名、タイムスタンプ、入出力データが記録されます。これを使用して、ツールの使用状況の監査、統合の監視およびツールの動作のデバッグを行います。

ノート: DBMS_CLOUD_AI_AGENTパッケージのサポートは、バージョン19.29以降のOracle Database 19cおよびバージョン23.26以降のOracle Database 26aiで使用できます。

DBA_AI_AGENT_TEAM_HISTORYビュー

このビューには、システム全体のすべてのエージェント・チーム実行が表示されます。

このビューにアクセスする権限は、データベース管理者のみです。他のユーザーにアクセス権を付与できます。DBA*ビューには、すべてのデータベース・ユーザーのオブジェクトが表示されます。

列	データ型	NULL	説明
`TEAM_EXEC_ID`	`VARCHAR2(128)`	`NOT NULL`	チーム実行インスタンスの一意の識別子(通常はGUID)を格納します。
`TEAM_NAME`	`VARCHAR2(128)`	`NOT NULL`	実行するエージェントの名前を指定します。
`TEAM_OWNER`	`VARCHAR2(128)`	`NOT NULL`	チームの所有者スキーマを指定します。
`START_DATE`	`TIMESTAMP`	`-`	プロセスが開始したタイムスタンプ。
`END_DATE`	`TIMESTAMP`	`NOT NULL`	プロセスが終了したタイムスタンプ。プロセスがまだ実行中の場合、値はNULLです。
`STATE`	`VARCHAR2(30)`	`NOT NULL`	現在の実行状態を示します。使用可能な値: `RUNNING`: エージェント・チームがリクエストをアクティブに処理しています。 `WAITING_FOR_HUMAN`: エージェント・チームは一時停止し、ユーザーの入力または承認を待機しています。 `RESUMING`: エージェント・チームは、一時停止または人的入力の後も続行します。 `SUCCEEDED`: エージェント・チームは実行を完了し、最終レスポンスを生成しました。 `FAILED`: エラーまたは未対応の状態が原因でエージェント・チームが停止しました。
`TEAM_INSTANCE_ID`	`NUMBER`	`-`	エージェント・チームが実行されたセッション・インスタンスIDを指定します。

USER_AI_AGENT_TEAM_HISTORYビュー

このビューには、現在のユーザーが所有するチームのすべてのエージェント・チーム実行が表示されます。

現在のユーザーは、自分が所有するチーム履歴を表示できます。他のユーザーにアクセス権を付与することはできません。データベース管理者はこれらのビューにアクセスできますが、表示できるのは自分が所有するオブジェクトのみです。

列	データ型	NULL	説明
`TEAM_EXEC_ID`	`VARCHAR2(128)`	`NOT NULL`	チーム実行インスタンスの一意の識別子(通常はGUID)を格納します。
`TEAM_NAME`	`VARCHAR2(128)`	`NOT NULL`	実行するエージェントの名前を指定します。
`START_DATE`	`TIMESTAMP`	`-`	プロセスが開始したタイムスタンプ。
`END_DATE`	`TIMESTAMP`	`NOT NULL`	プロセスが終了したタイムスタンプ。プロセスがまだ実行中の場合、値はNULLです。
`STATE`	`VARCHAR2(30)`	`NOT NULL`	現在の実行状態を示します。使用可能な値: `RUNNING`: エージェント・チームがリクエストをアクティブに処理しています。 `WAITING_FOR_HUMAN`: エージェント・チームは一時停止し、ユーザーの入力または承認を待機しています。 `RESUMING`: エージェント・チームは、一時停止または人による入力の後も続行します。 `SUCCEEDED`: エージェント・チームは実行を完了し、最終レスポンスを生成しました。 `FAILED`: エラーまたは未対応の状態が原因でエージェント・チームが停止しました。
`TEAM_INSTANCE_ID`	`NUMBER`	`-`	エージェント・チームが実行されたセッション・インスタンスIDを指定します。

DBA_AI_AGENT_TASK_HISTORYビュー

このビューには、チーム内のエージェントタスクパラメータが表示されます。

列	データ型	NULL	説明
`TEAM_EXEC_ID`	`VARCHAR2(128)`	`NOT NULL`	チーム実行インスタンスの一意の識別子(通常はGUID)を格納します。
`TEAM_NAME`	`VARCHAR2(128)`	`NOT NULL`	実行するエージェント・チームの名前を指定します。
`TASK_OWNER`	`VARCHAR2(128)`		チームの所有者スキーマを指定します。
`AGENT_NAME`	`VARCHAR2(128)`	`NOT NULL`	実行するエージェントの名前を指定します。
`TASK_NAME`	`VARCHAR2(128)`		実行中のタスクの名前を示します。
`TASK_ORDER`	`NUMBER`		エージェント・チーム・シーケンスにおける現在のタスクの位置を識別します。タスクは複数回出現する可能性があるため、`task_order`はこの特定の発生を区別します。
`COVERSATION_PARAM`	`CLOB`		会話APIのJSONパラメータ(`conversation_id`、`title`および`title`を含む)を提供します。
`INPUT`	`CLOB`		タスクの入力データを指定します。
`RESULT`	`CLOB`		タスクによって生成された出力を格納します。(たとえば、テキスト、JSON、行またはステータス・メッセージ)。
`STATE`	`VARCHAR2(30)`	`NOT NULL`	現在の実行状態を示します。使用可能な値: `RUNNING`: エージェント・チームがリクエストをアクティブに処理しています。 `WAITING_FOR_HUMAN`: エージェント・チームは一時停止し、ユーザーの入力または承認を待機しています。 `RESUMING`: エージェント・チームは、一時停止または人による入力の後も続行します。 `SUCCEEDED`: エージェント・チームは実行を完了し、最終レスポンスを生成しました。 `FAILED`: エラーまたは未対応の状態が原因でエージェント・チームが停止しました。
`START_DATE`	`TIMESTAMP`	`-`	プロセスが開始したタイムスタンプ。
`END_DATE`	`TIMESTAMP`	`NOT NULL`	プロセスが終了したタイムスタンプ。プロセスがまだ実行中の場合、値はNULLです。

USER_AI_AGENT_TASK_HISTORYビュー

このビューには、現在のユーザーのチームのエージェント・タスク・パラメータが表示されます。

現在のユーザーは、自分が所有するタスク履歴を表示できます。他のユーザーにアクセス権を付与することはできません。データベース管理者はこれらのビューにアクセスできますが、表示できるのは自分が所有するオブジェクトのみです。

列	データ型	NULL	説明
`TEAM_EXEC_ID`	`VARCHAR2(128)`	`NOT NULL`	チーム実行インスタンスの一意の識別子(通常はGUID)を格納します。
`TEAM_NAME`	`VARCHAR2(128)`	`NOT NULL`	実行するエージェント・チームの名前を指定します。
`AGENT_NAME`	`VARCHAR2(128)`	`NOT NULL`	実行するエージェントの名前を指定します。
`TASK_NAME`	`VARCHAR2(128)`		実行中のタスクの名前を示します。
`TASK_ORDER`	`NUMBER`		エージェント・チーム・シーケンスにおける現在のタスクの位置を識別します。タスクは複数回出現する可能性があるため、`task_order`はこの特定の発生を区別します。
`COVERSATION_PARAM`	`CLOB`		会話APIのJSONパラメータ(`conversation_id`、`title`および`title`を含む)を提供します。
`INPUT`	`CLOB`		タスクの入力データを指定します。
`RESULT`	`CLOB`		タスクによって生成された出力を格納します。(たとえば、テキスト、JSON、行またはステータス・メッセージ)。
`STATE`	`VARCHAR2(30)`	`NOT NULL`	現在の実行状態を示します。使用可能な値: `RUNNING`: エージェント・チームがリクエストをアクティブに処理しています。 `WAITING_FOR_HUMAN`: エージェント・チームは一時停止し、ユーザーの入力または承認を待機しています。 `RESUMING`: エージェント・チームは、一時停止または人的入力の後も続行します。 `SUCCEEDED`: エージェント・チームは実行を完了し、最終レスポンスを生成しました。 `FAILED`: エラーまたは未対応の状態が原因でエージェント・チームが停止しました。
`START_DATE`	`TIMESTAMP`	`-`	プロセスが開始したタイムスタンプ。
`END_DATE`	`TIMESTAMP`	`NOT NULL`	プロセスが終了したタイムスタンプ。プロセスがまだ実行中の場合、値はNULLです。

DBA_AI_AGENT_TOOL_HISTORYビュー

このビューには、システム全体のツールへの呼び出しが一覧表示されます。

列	データ型	NULL	説明
`invocation_id`	`VARCHAR2(128)`	`NOT NULL`	コールの一意の識別子を格納します。
`TEAM_EXEC_ID`	`VARCHAR2(128)`	`NOT NULL`	チーム実行インスタンスの一意の識別子(通常はGUID)を格納します。
`TASK_ORDER`	`NUMBER`	`-`	エージェント・チーム・シーケンスにおける現在のタスクの位置を識別します。タスクは複数回出現する可能性があるため、`task_order`はこの特定の発生を区別します。
`TOOL_OWNER`	`VARCHAR2(128)`	`-`	ツールの所有者スキーマ。
`TOOL_NAME`	`VARCHAR2(128)`	`-`	呼び出されるツール名を示します。
`AGENT_NAME`	`VARCHAR2(128)`	`-`	ツールのコールに使用されるエージェント名を示します。
`TASK_NAME`	`VARCHAR2(128)`	`-`	ツールを実行したタスクの名前。
`START_DATE`	`TIMESTAMP`	`-`	ツールの実行開始時のタイムスタンプ。
`END_DATE`	`TIMESTAMP`	`NOT NULL`	ツールが停止した時点のタイムスタンプ。プロセスがまだ実行中の場合、値はNULLです。
`INPUT`	`CLOB`	`-`	ツールの入力データを指定します。
`OUTPUT`	`CLOB`	`-`	ツールによって生成された出力を格納します。(たとえば、テキスト、JSON、行またはステータス・メッセージ)。
`TOOL_OUTPUT`	`CLOB`	`-`	デバッグまたはトラブルシューティングおよびトレース動作に使用される、ツール機能からの診断メッセージ。

USER_AI_AGENT_TOOL_HISTORYビュー

このビューには、現在のユーザーが所有するツールへのコールがリストされます。

現在のユーザーは、所有しているツール履歴を表示できます。他のユーザーにアクセス権を付与することはできません。データベース管理者はこれらのビューにアクセスできますが、表示できるのは自分が所有するオブジェクトのみです。

列	データ型	NULL	説明
`invocation_id`	`VARCHAR2(128)`	`NOT NULL`	コールの一意の識別子を格納します。
`TEAM_EXEC_ID`	`VARCHAR2(128)`	`NOT NULL`	チーム実行インスタンスの一意の識別子(通常はGUID)を格納します。
`TASK_ORDER`	`NUMBER`	`-`	エージェント・チーム・シーケンスにおける現在のタスクの位置を識別します。タスクは複数回出現する可能性があるため、`task_order`はこの特定の発生を区別します。
`TOOL_NAME`	`VARCHAR2(128)`	`-`	呼び出されるツール名を示します。
`AGENT_NAME`	`VARCHAR2(128)`	`-`	ツールのコールに使用されるエージェント名を示します。
`TASK_NAME`	`VARCHAR2(128)`	`-`	ツールを実行したタスクの名前。
`START_DATE`	`TIMESTAMP`	`-`	ツールの実行開始時のタイムスタンプ。
`END_DATE`	`TIMESTAMP`	`NOT NULL`	ツールが停止した時点のタイムスタンプ。プロセスがまだ実行中の場合、値はNULLです。
`INPUT`	`CLOB`	`-`	ツールの入力データを指定します。
`OUTPUT`	`CLOB`	`-`	ツールによって生成された出力を格納します。(たとえば、テキスト、JSON、行またはステータス・メッセージ)。
`TOOL_OUTPUT`	`CLOB`	`-`	デバッグまたはトラブルシューティングおよびトレース動作に使用される、ツール機能からの診断メッセージ。