智能体工具调用的异常处理

企业智能体不只回答问题，还可能查询库存、生成工单、读取项目进度或把线索写入业务系统。对话看起来很顺畅，真正执行时却可能遇到接口超时、权限不足、字段不完整。最危险的不是提示“失败”，而是任务其实没有完成，智能体却回复客户“已经提交”。工具调用要把成功、失败和不确定状态分开设计。

先把“成功”两个字说清楚

点击了接口不等于任务成功。以创建售后工单为例，系统应返回有效工单号并保存必要字段，才可以告诉客户“已提交”。只收到请求、等待后台处理时，应说明正在处理；没有得到明确结果时，则提示暂未完成并提供人工渠道。

每个工具都要列出成功条件、常见失败和客户可见的说法。库存查询失败可以请客户稍后重试，价格和合同相关操作失败则应直接转人工，不能使用缓存或猜测结果。不同任务的风险不同，错误提示也不能套用一句“系统繁忙”。

信息没问全，先别急着调用

很多失败来自缺少字段。客户只说“帮我报修”，却没有产品型号、联系方式和问题现象，智能体如果马上创建工单，后台只能收到一条空记录。调用前应检查必填信息，并用一两个自然问题补齐。客户不清楚的字段允许留空，但要在工单中标记待确认。

格式也要统一。日期、手机号、地区和产品型号应按业务系统要求转换，同时保留客户原始表达供人工核对。不能识别时不要擅自改成相近值。涉及客户身份和账号信息，还要先完成必要的权限确认。

超时以后，别一上来就重试

网络超时时，系统可能已经创建了记录，只是智能体没有及时收到返回。若立即重试，可能出现两个相同工单或重复线索。可以为每次操作生成唯一请求标识，重试前先查询是否已存在。页面端也要防止客户连续点击多次。

失败记录应包含时间、工具、输入摘要、返回状态和后续处理，不需要保存与排查无关的敏感内容。运营人员查看时能够分清是接口故障、业务校验、权限问题，还是客户主动取消，技术人员才知道从哪里开始检查。

失败提示要告诉客户下一步

好的失败提示要回答三个问题：当前有没有完成，客户是否需要再次操作，还可以通过什么方式继续。例如“暂未生成工单，请不要重复提交，我们已保留您填写的信息，可选择转人工确认”。不能保留信息时也要如实说明，不要让客户误以为后台已经收到。

转人工后，应把已收集的内容和失败原因一起交给客服，避免客户重新描述。非工作时间可以记录回访需求，但要说明预计处理方式，不要用虚假的在线状态安抚客户。

验收时故意让它失败几次

验收不能只测试网络正常、信息完整的情况。应模拟接口超时、权限被拒、字段错误、系统重复记录和部分成功，检查智能体回复、日志和人工接手是否一致。工具版本或业务字段变化后，也要重新测试。

企业准备让智能体执行真实业务动作时，建议先从只读查询或可撤销任务开始，把失败处理跑通，再开放更复杂的操作。苏州辉耀网络科技有限公司可结合AI智能体、智能客服和内部系统使用场景，协助梳理工具调用边界、必填信息、异常提示与人工兜底流程。