DBMS_CLOUD_AI_AGENT履歴ビュー

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

チーム履歴ビュー

これらのビューには、システム全体のすべてのエージェント・チーム実行が表示されます。各行には、チーム名、ジョブ名、開始タイムスタンプまたは終了タイムスタンプ、実行状態、エラーなど、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ビュー

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

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

データ型 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_idtitleおよび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_idtitleおよび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ビュー

このビューには、システム全体のツールへのコールがリストされます。

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

データ型 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 -

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