AI 工具

把你自己系统的接口或 MCP 服务器交给 AI 用：查库存、会员积分、自家物流等实时数据，身份由系统填，AI 只看到你允许的字段。

AI 默认能查知识库、店铺政策、同步进来的商品和已登录顾客的订单。你自己系统里的数据，比如海外仓库存、会员积分、自家物流商的轨迹，可以通过「AI 工具」交给 AI 查询。

入口在「AI 客服 → AI 能力」的「工具」标签。只有店主和管理员能管理，Growth 及以上套餐可用：Growth 最多同时启用 10 个工具，Scale 不限。

连接

先添加一个连接，有两种：

HTTP 接口：你的接口地址，例如 https://erp.example.com/api/。
MCP 服务器：支持 Streamable HTTP 的 MCP 服务器地址。添加后点「从服务器选工具」，purser 会列出服务器提供的工具，你挑要用的。

两种都要填鉴权方式：Bearer 令牌、自定义请求头，或者不需要。

每个工具要设置：

工具名：AI 调用时用的名字，小写字母和下划线，例如 check_stock。
什么时候用：写给 AI 看的说明，例如「查询某个商品在海外仓的实时库存和预计补货日期；顾客问有没有货、什么时候到货时用」。
请求方式和路径（HTTP）：GET 把参数放在查询字符串里，POST 放在 JSON 请求体里。路径里可以用 {参数名}，例如 /stock/{sku}。
参数，以及每个参数「谁来填」：

谁来填	说明
AI	AI 根据对话填写，例如商品编号、尺码
顾客编号、顾客邮箱（系统）	系统填入已登录顾客的信息，AI 改不了。顾客没登录时，AI 看不到这个工具
顾客自己的订单号	AI 说出订单号，系统核对它确实是这位已登录顾客的订单，否则不调用
对话编号、顾客语言、渠道、市场	系统按当前对话填写
固定值	你填的常量，例如仓库代码

可以告诉顾客的返回字段：一行一个，嵌套用点号，数组用 []，例如 in_stock、eta.date、items[].name。没列出的字段 AI 看不到，也就不会说给顾客。

AI 只能调用你启用的工具。
每个工具可以选「在哪些问题上提供」（和技能一样按问题类型）：不选就是所有对话都提供；选了就只在这些类型的问题上交给 AI。每条回复最多提供 8 个工具，工具多的时候 AI 更快、更不容易用错。
顾客问到需要实时数据的问题时，AI 调用合适的工具，按返回内容回答。每条回复最多调用 3 次。
返回内容和知识库一样，要经过发送前的核对：回复里的数字和状态必须来自工具返回。
工具调用失败、超时（5 秒）或报错时，AI 不会编答案，而是交给人工。

工具默认是「只读（查询）」。像建换货单、登记保修、改预约这类会改东西的操作，把工具设为「会改东西（办理）」：

AI 不会直接执行。 顾客明确要办时，AI 在回复里说明要办什么，下面附一张「要帮您办理吗？」的确认卡片。
顾客点确认后，默认交给人工审批：审批入口在收件箱这段对话的动作区，店主和管理员也会收到通知。
工具设为「可以自动执行」时，只有同时满足以下两条才自动执行，否则仍交人工审批：
- 这类问题的 AI 自主程度是 R4；
- 今天自动执行的次数没超过你设的上限（默认 20 次）。
执行时请求带 Idempotency-Key（每个请求一个固定值）。你的接口没有响应、超时或返回 5xx 时，purser 会用同一个键重试；返回 4xx 视为拒绝，不再重试。
办成、没办成、交给团队确认，都会在对话里告诉顾客；没办成时对话转人工。

补充说明：

purser 每天检查一次你启用的 MCP 工具：服务器上某个工具的说明或参数变了，或者工具没了，这个工具会被自动停用，店主和管理员会收到通知。重新确认后再启用即可。