AI 智能体运行记录
每当 AI 智能体运行时(无论是通过 AI 智能体节点还是通过 API),MonoChat 都会记录这次运行:使用了哪个 Harness 和哪些模型、收到了什么任务、发起了哪些模型调用和工具调用、用掉了多少预算,以及最终如何结束。
您可以在 设置 › 自动化 › AI 智能体运行记录 中查看这些运行。拥有 Read AI agent runs in automation 权限的用户才会看到该菜单项。
运行记录表
| 列 | 显示内容 |
|---|---|
| AI Harness | 运行该智能体的 Harness。将鼠标悬停可查看 Harness 类型。 |
| 状态 | 排队中、运行中、已完成、失败、超出预算、已超时或已取消。将鼠标悬停在失败的运行上可查看其错误信息。 |
| 模型调用次数 | 已使用的模型调用次数 / 预算中的最大模型调用次数。 |
| 工具调用次数 | 已使用的工具调用次数 / 预算中的最大工具调用次数。 |
| 令牌 | 令牌总数。将鼠标悬停可查看输入和输出令牌;如果服务提供方有上报,还会显示缓存读取和写入。 |
| 时长 | 运行所用的时间。 |
| 创建时间 | 运行开始的时间。 |
每一行都有三个按钮:
- 复制 ID 复制运行 ID,例如用于通过
aiAgentRuns.show查询,或发送给支持团队。 - 聊天 打开该运行所处理的对话。只有属于某个会话的运行才会显示此按钮。
- 显示 打开该运行的详情。
使用筛选条件,可按 AI 运行框架、状态和创建时间(日期范围)缩小列表范围。表格不会自动更新;请使用表头中的刷新按钮来加载新的运行和状态变化。
运行详情
点击显示会打开 AI 智能体运行记录抽屉。
概要
| 行 | 显示内容 |
|---|---|
| ID | 运行 ID,旁边带有复制按钮。 |
| AI Harness | Harness 的名称和类型。 |
| 状态 | 运行如何结束,或者仍在排队或运行中。 |
| 错误 | 未完成的运行的错误信息。 |
| 主模型、备用模型(达到软限制后)、快速模型(轻量后台任务) | 节点所设置的 AI 模型(适用于使用 AI 模型的 Harness)。 |
| 模型(Harness 允许的模型之一) | 托管 Harness 所使用的模型。 |
| 创建时间、开始时间、完成时间 | 运行排队、开始和结束的时间。 |
| 时长 | 已用时间 / 最长时长(秒)。 |
| 模型调用次数 | 已用调用次数 / 最大次数;如果设置了软限制,也会一并显示。 |
| 工具调用次数 | 已用调用次数 / 最大次数。 |
| 令牌 | 输入和输出令牌(以及缓存令牌),以及总数 / 最大总令牌数。 |
步骤
步骤按顺序列出智能体所做的事情,右侧显示自运行开始以来经过的时间:
| 步骤 | 显示内容 |
|---|---|
| 模型调用 n | 所用模型、输入和输出令牌,以及模型请求的工具(Requested tools: …)或最终回答。 |
| 工具调用 | 工具名称及其耗时。 |
| 已切换到备用模型 | 运行达到软限制后,改用备用模型继续运行。 |
| 中间消息 | 智能体在工作过程中写下的消息,按其发送给客户的方式或作为内部备注添加的方式显示。 |
| 重试 | 被重试的失败模型调用,附带其错误信息。 |
如果 Harness 没有上报任何步骤,抽屉中会显示“No steps were recorded for this run.”
说明、输入、结果和 JSON 数据
- 说明:智能体收到的节点说明。
- 输入:任务内容,其中的标签已填充完毕。
- 结果:智能体的最终回答。
- JSON 数据:完整的运行记录。可使用复制按钮将其分享给您的开发人员或 MonoChat 支持团队。
调试智能体
| 您看到的情况 | 需要检查的内容 |
|---|---|
| 超出预算,且模型调用次数已达最大值 | 查看各个步骤。如果智能体不断调用工具却无法得出结论,请把说明和工具描述写得更精确。如果任务确实需要更多步骤,请提高最大模型调用次数。 |
| 超出预算,且令牌已达最大值 | 过长的对话历史或体积很大的工具结果会占满令牌预算。请降低消息历史上限,让工具返回更少的数据,或提高最大总令牌数。 |
| 超出预算,且工具调用次数已达最大值 | 智能体请求调用的工具超过了允许的数量。请提高最大工具调用次数,或者在说明中告诉它何时使用哪个工具。 |
| 已超时 | 在步骤中检查各次工具调用的耗时。缓慢的 API 或 MCP 服务器会耗尽最长时长(秒)。 |
| 失败,错误为 “An AI scope or MCP tool was not found in this workspace.” | 节点上的某个范围或 MCP 工具已被删除。请更新节点的工具设置。 |
| 失败,错误为 “Choose one of the AI harness's allowed models.” | 节点所用的模型已从托管 Harness 的允许的模型中移除。 |
| 失败,错误为 “This harness is not available on this server.” | 该 Harness 需要 MonoChat 的智能体运行器,而当前不可用。请选择其他 Harness。 |
| 客户没有收到回答 | 请检查运行是否已完成、节点中的发送回答是否已开启,以及结果是否为空。 |
| 客户看到了您不希望出现的“思考中”消息 | 请关闭将中间消息转发给客户;这样这些消息将作为内部备注留给您的团队。 |
提示
在调整预算之前,请先对比同一个节点的几次运行。通过步骤可以判断智能体是需要更多空间,还是需要更好的说明。