DBMS_CLOUD_AI_AGENT 历史记录视图

DBMS_CLOUD_AI 历史记录视图分为团队历史记录视图、任务历史记录视图和工具历史记录视图。

注意：

Oracle Database 19c（从版本 19.29 开始）和 Oracle Database 26ai（从版本 23.26 开始）中提供了对 DBMS_CLOUD_AI_AGENT 软件包的支持。

另请参阅：

团队历史记录视图

这些视图显示整个系统中的所有代理团队运行。每行记录一个代理团队运行，包括团队名称、职务名称、开始或结束时间戳、运行状态和任何错误。它充当顶层运行日志，链接到任务和工具级历史记录，以便进行更深入的分析。

任务历史记录查看

这些视图显示团队内的座席任务参数。这些视图保存运行代理任务所需的上下文数据。任务在启动时从其读取输入参数，并在完成时回写结果。它将调度系统与代理框架连接起来。

工具历史记录视图

这些视图显示对整个系统的工具的调用。每行记录工具名称、触发代理和任务、团队执行 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_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 视图

此视图列出对整个系统的工具的调用。

只有数据库管理员有权访问此视图。他们可以向其他用户授予访问权限。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 -

来自工具函数的诊断消息，用于调试或故障排除和跟踪行为。