Appearance
让 AI 直接查询和操作你的业务系统
给它一个接口，它就能自己动手办事，而不是只能告诉客户「我帮你转人工」。
它卡在哪里
机器人再会说话，也有一类事永远办不了。
客户问「我这单到哪了」，处理流程其实是三步：问订单号 → 查订单系统 → 告知物流状态。头尾两步 AI 都能做，它们只是打字。中间那步不行：客服查订单是打开后台输单号，AI 打不开你的后台。
结果就是流程写得清清楚楚，每次还是转人工。
自定义工具解决的就是这一步。你提供一个接口，在工作台配好，AI 就能自己调。
它能做到什么程度
不止是查。请求方法五种全都能选：
意味着只要你的系统有这个接口，AI 就能做这件事：
| 类型 | 例子 |
|---|---|
| 查询 | 订单状态、物流进度、库存、会员等级、积分余额、预约时间 |
| 修改 | 改收货地址、修改预约时间、更新客户资料 |
| 创建 | 下单、提交退款申请、发优惠券、生成取件码 |
| 取消 | 取消订单、取消预约、退订服务 |
能力边界不在合从这边，在你给它什么接口。
开始之前
- 你需要管理员权限。
- 需要一位开发同事配合，提供接口。半天到一天的工作量。
- 已经创建好机器人。
- 这个机器人的回答方式是 AI 应答，或者是 知识库优先（后者只在交给 AI 兜底的那次生效）。知识库应答 档下机器人不经过 AI，这一整套都不会触发。
第一步：跟开发同事要接口
把这段发给他，需要的信息都在里面：
需要一个给 AI 客服调用的接口：
- 公网能访问的 https 地址，13 秒内返回
- 入参：<订单号>
- 返回：<状态、承运商、单号、预计到达时间>，只返回这几个字段，越精简越好
- 加一个固定的密钥请求头供你校验来源
- 完整规范：https://docs.aihecong.com/dev/http-tool
接口必须是公网能访问的地址
内网地址、本机地址、局域网 IP 都配不了，保存时会被拒绝。开发同事在本地跑的服务需要先部署到公网，或者用内网穿透工具映射出来。
返回内容越精简越好是有原因的：接口返回的内容超过 1000 个字符会被截断，超出的部分 AI 看不到。返回一整个订单对象很容易撞到这个上限，让它只返回客户会问的那几个字段。
第二步：在工作台配置
在左侧栏选择 AI Agent，再选择 工具。
选择 添加自定义工具。
填写配置。左边填，右边可以直接测。
其中三个字段决定成败：
| 字段 | 填什么 |
|---|---|
| 工具描述（给 AI 看） | 什么情况下该用这个工具。这段话直接决定 AI 会不会想到调用它 |
| AI 参数 | 需要从客户那里问到的信息，比如订单号。标为必填的，客户没说 AI 会主动追问 |
| 系统变量参数 | 系统自动填的客户信息，比如客户 ID、手机号。不需要 AI 参与，也不需要问客户 |
工具描述要写「什么时候用」，不是「这个接口是什么」：
- ✅
客户询问订单物流进度、包裹到哪了、什么时候送到时，用这个工具查询 - ❌
订单物流查询接口
自建工具没有合从预置的说明，AI 全靠这段话判断。写成接口名，它就不知道什么时候该调。
第三步：先测试，再绑给机器人
配置页右侧有 测试工具。填入测试值，选择 发送，能看到真实的请求结果。在这里跑通再保存，不要配完直接上线。
保存之后还要绑定：到机器人详情页的 工具 卡片上选择 管理，把这个工具打开。不绑定等于没配，机器人看不到它。
让 AI 在对的时候调用它
配好、绑上，AI 就「有」这个工具了，但不一定主动想到用。两件事推它一把：
- 工具描述写清楚使用时机（上一步已经做了）。
- 在机器人的 场景处理 里明确写出这一步，例如「客户问订单进度：先要订单号，再用『查询订单』确认」。写法见场景处理、回复规则与人设。
只配工具不引导，很容易出现「工具在那儿它就是不用」。
写操作类接口的风险控制
AI 调用工具没有二次确认环节
它判断该调就直接调，不会先问客户「确定要取消吗」，也不会等你审批。配了取消订单的接口，就意味着 AI 可以真的取消订单。
防线只能建在你自己的接口里：校验参数、限制金额上限、加幂等键防重复提交、记录操作日志。合从不会替你拦。
建议的上手顺序：
- 先配只读的接口，跑一两周，观察 AI 的判断准不准。翻几条对话的推理记录看它什么时候调、传了什么参数。
- 确认可靠之后，再上会改数据的接口。
- 高风险动作（退款、大额优惠）先做成「提交申请」而不是「直接执行」，留一道人工审核。
另外两件相关的事：
- AI 会拿到接口返回的内容并转述给客户。别在返回里放成本价、内部备注这类不该让客户看到的字段。
- 合从不会在请求里带任何身份标识。你的接口没法靠请求来源判断是不是合从调的，只能靠你自己配的那个密钥请求头。这个头要当密码管。
限制
| 项 | 值 |
|---|---|
| 每个团队的自定义工具总数 | 20 个 |
| 每个机器人能绑定 | 10 个 |
| 单次调用超时 | 15 秒 |
| 返回内容上限 | 超过 1000 字符会被截断 |
| 调用失败 | 不会自动重试 |
调用失败时，客服能在对话里看到一条系统提示（客户看不到），AI 则会改用文字向客户说明，不会假装办成了。
还有一种接入方式：MCP
如果你的技术团队已经在用 MCP（一种让 AI 调用外部服务的标准协议），可以直接接入现成的 MCP 服务，不用一个个配接口。在 添加自定义工具 里选择 MCP，粘贴配置即可，做法见接入 MCP 服务。
常见问题
工具配好了，机器人从来不用
症状：测试工具能跑通，实际对话里 AI 从不调用。
成因：工具没绑给这个机器人；或者工具描述写成了接口名，AI 不知道什么时候该用。
解决：先到机器人详情页的 工具 卡片确认它是打开状态。再把工具描述改成「客户问……时用这个工具」的写法，并在场景处理里写出这一步。
保存时提示地址不可用
症状：填了接口地址，保存被拒绝。
成因：填的是内网地址、本机地址或局域网 IP，这类地址一律不接受。
解决：换成公网能访问的 https 地址。本地开发中的服务先用内网穿透映射出来再配。
AI 拿到了数据，但回复给客户的内容不全
症状：测试工具里返回正常，实际对话中 AI 只说了一部分。
成因：接口返回内容超过 1000 字符被截断，AI 只看到了前面那段。
解决：让开发同事精简返回字段，只留客户会问的那几个。
下一步
- 用 HTTP 接口扩展 AI 能力 —— 完整协议规范，发给开发同事
- 场景处理、回复规则与人设 —— 引导 AI 在对的时候调用
- 怎么训练 AI 机器人 —— 哪些环节最值得做成接口