DBMS_CLOUD_AI_AGENT履歴ビュー

DBMS_CLOUD_AI履歴ビューは、チーム履歴ビュー、タスク履歴ビューおよびツール履歴ビューに分類されます。

ノート

関連項目: Select AI Agent

チーム履歴ビュー

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

タスク履歴表示

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

ツール履歴ビュー

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

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`	`-`	デバッグまたはトラブルシューティングおよびトレース動作に使用される、ツール機能からの診断メッセージ。

Oracle Cloud Infrastructureドキュメント