查看 Trace、指标和运行记录

连接 AI 助手

使用控制台中的真实运行数据定位模型、工具、能力和渠道问题。可以使用智能体实例 Trace、工作台指标、沙箱记录、知识库任务日志和后台任务。

查看智能体实例 Trace

使用 Trace 查看一次调用的输入、回复和工具消息，也可以核对会话、耗时和模型用量。

1. 打开 智能体实例，选择目标实例。

   打开智能体实例

2. 打开 Trace，核对预期调用记录是否已经出现。

   • 列表为空或加载失败时，确认当前租户、目标实例和资源访问权限。
   • 新记录未出现时，刷新页面，再核对消息是否已提交到这个实例。

   不要仅凭没有 Trace 就认定工具没有执行。

3. 按调用时间找到目标调用记录，点击该行打开详情，核对输入消息和回复。

   详情顶部显示该条 Trace 的延迟、环境、时间和 Session。延迟是整条 Trace 的耗时，不是某个工具的单独耗时；Session 用于识别调用所属的会话。

   有用量数据时，顶部还会显示 Token 消耗 汇总。AI 消息中记录了模型名称（如 deepseek-v4.1-flash）和用量时，也可以逐条查看。

   需要确认调用者时，查看标签或 完整元数据 中记录的调用者信息。共享实例的创建者不一定是这次调用者。

4. 展开更多消息，检查工具名称、调用参数和工具返回内容。

   输出默认只显示最后一条消息。如果看到 Show N more...，点击它展开其余消息；N 是折叠的消息条数。

   AI 消息中的 工具调用 显示工具名称和参数，工具消息显示返回内容。

   下图以一次文档搜索为例，展示消息之间的关系。消息正文和调用 ID 均为示例，省略了历史消息。

   图表预览

   图中的 id 与 tool_call_id 相同，表示这条工具消息对应前面的工具调用。工具名称和参数也可以帮助你判断调用的用途，例如：

   • read_file 表示读取文件，参数 file_path 是要读取的文件路径。
   • search_docs 表示搜索文档，参数 query 是搜索内容。

   长消息只显示部分内容时，点击 展开全部 查看完整文本。

   注意

   更多消息也可能包含历史对话

   展开的消息可能包含同一会话此前的问题和回复。按本轮输入找到对应消息，再往后核对工具调用和返回。顶部 Token 汇总也可能包含历史用量；只看本轮用量时，查看对应 AI 消息。

   工具调用只表示模型提出了请求，执行结果要看工具返回。任务是否已结束、是否还在等待审批或工具结果，可结合对话和运行进度判断。

5. 需要保存消息或进一步分析时，点击详情右上角的下载图标，下载这条记录的输入和输出 JSON。

   下载文件包含全部输入和输出消息。

   下载的 JSON 不包含 Session、延迟、环境和标签；这些信息可在 Trace 详情页查看。

   注意

   分享 Trace 前检查敏感内容

   下载的 JSON 可能包含密钥或个人信息。分享前，请删除或遮盖敏感内容。

查看工作台指标

工作台 提供调用量、调用成功情况、Token 用量和沙箱相关指标。使用它们发现趋势，再进入具体实例 Trace 定位原因。

工作台指标用于查看调用、Token 和沙箱趋势。计费、成本分摊、服务等级报表和业务告警需要通过组织现有的外部监控或管理系统补充。

查看沙箱运行记录

在 沙箱运行记录 中检查：

• 执行是否启动。
• 使用的沙箱和环境。
• 运行状态和结果。
• 超时或资源问题。

把沙箱记录与智能体实例 Trace 的工具调用时间关联，可以区分模型没有调用工具、权限中断和沙箱执行失败。

记录中的耗时以秒显示；有开始时间和耗时时，结束时间按两者计算。结束时间尚未显示时，先检查运行状态，不要把空值当作已经结束。有权使用沙箱但看不到其记录时，请管理员核对该沙箱的资源授权。

查看知识库任务和日志

在 知识库管理 的 构建历史 中查看任务的 状态，并选择 日志 查看详情。网页、Sitemap 或飞书来源更新后，确认重新运行任务成功。

检索回答异常时先确认：

1. 文档已经入库。
2. 目标集合属于智能体实例使用的知识库组。
3. 最近任务成功。
4. 知识检索参数中的 collection_name 与目标 Collection 的资源 ID 一致，实际 top_k 和检索结果符合预期。

要用固定问题追踪答案对应的检索参数和结果时，参见构建可追溯的企业知识助手。

查看后台任务

智能体实例的 后台任务 显示任务 ID、子代理 ID、状态、时间和取消操作。结合任务状态和 Trace 判断是否仍在处理、已经完成或发生错误。该页当前不显示最终结果正文或完整错误；结果应在主智能体回答、相关 Trace 中核对。

子代理请求确认时，后台任务显示为 等待审批。在飞书渠道中，审批卡片出现在主智能体所在会话；批准或拒绝后，再回到后台任务确认状态已经变化。确认型审批不同于用户工具包中断，后者由通过 HTTP 与 WebSocket 接入的业务系统处理。完整的状态、取消和排查方法参见运行和管理子代理委托。

区分运行进度和最终结果

对话中的进度提示用于帮助用户了解正在发生什么，不代替运行记录。模型已提出工具调用，也不等于工具已经执行；还可能等待人工审批或调用方返回工具结果。

API 客户端应匹配事件帧的 mid 与输入的 msg_id，跟踪主智能体生命周期：success、error 或 cancelled 才是终止阶段；retry 表示正在重试，has_pending_interrupt 表示等待处理，都不是结束。带有 sub 的事件属于子任务，不要用子任务完成代替主请求完成。具体字段见接收运行事件。

涉及写入、发送消息或其他业务操作时，还要核对工具结果和外部系统记录。运行成功不能单独证明业务结果已送达预期接收者。

补充生产观测和治理

智能体开发服务平台（AgentWorks）提供智能体实例 Trace、工作台指标和能力运行记录。生产环境还应通过外部系统管理：

• 评测数据集、自动评分和质量门禁。
• 预算控制、成本分摊和超额处置。
• 合规审计日志及其保留策略。
• 跨 AgentWorks、模型服务和外部能力的统一告警与 SLO 管理。

生产上线前，为所需的外部观测和治理系统指定负责人，并记录排查所需的 AgentWorks 关联 ID 和运行记录。