【企业智能体开发】记录工具调用链与操作审计

培训结束后，小林反馈：“服务台刚才说工单建好了，可现场同事查不到。”团队需要回答一连串具体问题：模型当时提议了什么，员工是否确认，写入工具有没有真正调用，工单系统返回了什么，页面最后展示了哪句话。若日志只有一行“Agent 回复成功”，这件事几乎无法复盘。本篇给企业服务台 Agent 建立可追踪的调用链与操作审计。调用链帮助定位一次任务在哪个环节耗时或失败；操作审计帮助说明是谁在什么条件下触发了有业务影响的动作。两者相关，但不能混为一谈。示例使用 Python 标准库生成结构化事件，不把员工原始对话和完整文档无差别写入日志。文章目录先区分任务、请求、工具调用和写入操作一条完整的调用链长什么样结构化事件的最小实现既要查得清，也要少记不该记的内容复盘小林的“工单去哪了”用故障注入验收审计链总结先区分任务、请求、工具调用和写入操作小林的一次投屏求助可能跨多轮对话、多个页面请求和几次工具调用。一个task_id代表持续的业务任务；每次网页请求可以有自己的trace_id；每次工具调用有span_id；创建工单这样的写入还需要稳定的operation_id或幂等键。它们不能互相代替。标识回答的问题生命周期task_id这件投屏求助整体发生了什么可跨会话和多次请求trace_id当前一次处理请求走过哪些步骤通常只覆盖一次入口请求span_id哪一次检索、模型或工单查询调用出了问题属于某条调用链operation_id某次写入是否重复提交随同一业务写入意图保持稳定ticket_id外部工