DBMS_CLOUD_AI_AGENT 历史记录视图

DBMS_CLOUD_AI 历史记录视图分为以下几类：

• 团队历史记录视图

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

• 任务历史记录查看

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

• 工具历史记录视图

  这些视图显示对整个系统的工具的调用。每行记录工具名称、触发代理和任务、团队执行 ID、步骤名称、时间戳以及输入和输出数据。可用于审计工具使用情况、监视集成和调试工具行为。

注：从版本 19.29 开始的 Oracle Database 19c 以及从版本 23.26 开始的 Oracle Database 26ai 中提供了对 DBMS_CLOUD_AI_AGENT 程序包的支持。

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	-	来自工具函数的诊断消息，用于调试或故障排除和跟踪行为。

相关内容

• 使用 Select AI Agent 构建自治代理

• DBMS_CLOUD_AI_AGENT 程序包

• DBMS_CLOUD_AI_AGENT 视图