查看 Trace、指标和运行记录
使用控制台中的真实运行数据定位模型、工具、能力和渠道问题。可以使用智能体实例 Trace、工作台指标、沙箱记录、知识库任务日志和后台任务。
查看智能体实例 Trace
在智能体实例中打开 Trace，按调用检查：
- 输入和模型执行。
- 工具调用及结果。
- 运行耗时。
- 错误位置。
- 中断和恢复。
处理敏感业务时限制 Trace 访问，并避免把密钥或不必要个人数据放入提示词和工具参数。
查看工作台指标
工作台 提供调用量、调用成功情况、Token 用量和沙箱相关指标。使用它们发现趋势，再进入具体实例 Trace 定位原因。
工作台指标用于查看调用、Token 和沙箱趋势。计费、成本分摊、服务等级报表和业务告警需要通过组织现有的外部监控或管理系统补充。
查看沙箱运行记录
在 沙箱运行记录 中检查：
- 执行是否启动。
- 使用的沙箱和环境。
- 运行状态和结果。
- 超时或资源问题。
把沙箱记录与智能体实例 Trace 的工具调用时间关联，可以区分模型没有调用工具、权限中断和沙箱执行失败。
查看知识库任务和日志
在 知识库管理 的 构建历史 中查看任务的 状态，并选择 日志 查看详情。网页、Sitemap 或飞书来源更新后，确认重新运行任务成功。
刚完成的智能体调用没有出现在 Trace 列表中时，刷新智能体实例详情页，再重新打开该页签。刷新后仍没有记录，再检查调用是否完成以及实例和租户筛选是否正确。
检索回答异常时先确认：
- 文档已经入库。
- 目标集合属于智能体实例使用的知识库组。
- 最近任务成功。
- 知识检索参数中的
collection_name与目标 Collection 的资源 ID 一致，实际top_k和检索结果符合预期。
要用固定问题追踪答案对应的检索参数和结果时，参见构建可追溯的企业知识助手。
查看后台任务
智能体实例的 后台任务 显示委派或后台运行任务。结合任务状态和 Trace 判断是否仍在处理、已经完成或发生错误。
子代理请求确认时，后台任务显示为 等待审批。在飞书渠道中，审批卡片出现在主智能体所在会话；批准或拒绝后，再回到后台任务确认状态已经变化。确认型审批不同于用户工具包中断，后者仍由 Invoke API 或 WebSocket 接入的业务系统处理。
补充生产观测和治理
一体化智能体运行与协同平台（AgentWorks）提供智能体实例 Trace、工作台指标和能力运行记录。生产环境还应通过外部系统管理：
- 评测数据集、自动评分和质量门禁。
- 预算控制、成本分摊和超额处置。
- 合规审计日志及其保留策略。
- 跨 AgentWorks、模型服务和外部能力的统一告警与 SLO 管理。
生产上线前，为所需的外部观测和治理系统指定负责人，并记录排查所需的 AgentWorks 关联 ID 和运行记录。