AI 工具
把你自己系统的接口或 MCP 服务器交给 AI 用：查库存、会员积分、自家物流等实时数据，身份由系统填，AI 只看到你允许的字段。
AI 默认能查知识库、店铺政策、同步进来的商品和已登录顾客的订单。你自己系统里的数据，比如海外仓库存、会员积分、自家物流商的轨迹，可以通过「AI 工具」交给 AI 查询。
入口在「AI 客服 → 工具」。只有店主和管理员能管理，Growth 及以上套餐可用：Growth 最多同时启用 10 个工具，Scale 不限。
连接
先添加一个连接，有两种：
- HTTP 接口：你的接口地址，例如
https://erp.example.com/api/。 - MCP 服务器：支持 Streamable HTTP 的 MCP 服务器地址。添加后点「从服务器选工具」，purser 会列出服务器提供的工具，你挑要用的。
两种都要填鉴权方式：Bearer 令牌、自定义请求头，或者不需要。
- 密钥加密保存，保存后不会再显示，只显示最后几位。
- purser 只访问连接地址所在的域名，只走 https，不跟随跳转，不访问内网地址。
- 建议给 purser 单独建一个只读密钥，出问题时可以单独吊销。
工具
每个工具要设置：
- 工具名：AI 调用时用的名字，小写字母和下划线，例如
check_stock。 - 什么时候用：写给 AI 看的说明，例如「查询某个商品在海外仓的实时库存和预计补货日期；顾客问有没有货、什么时候到货时用」。
- 请求方式和路径（HTTP）：
GET把参数放在查询字符串里，POST放在 JSON 请求体里。路径里可以用{参数名}，例如/stock/{sku}。 - 参数，以及每个参数「谁来填」：
| 谁来填 | 说明 |
|---|---|
| AI | AI 根据对话填写，例如商品编号、尺码 |
| 顾客编号、顾客邮箱（系统） | 系统填入已登录顾客的信息，AI 改不了。顾客没登录时，AI 看不到这个工具 |
| 顾客自己的订单号 | AI 说出订单号，系统核对它确实是这位已登录顾客的订单，否则不调用 |
| 对话编号、顾客语言、渠道、市场 | 系统按当前对话填写 |
| 固定值 | 你填的常量，例如仓库代码 |
- 可以告诉顾客的返回字段：一行一个，嵌套用点号，数组用
[]，例如in_stock、eta.date、items[].name。没列出的字段 AI 看不到，也就不会说给顾客。
AI 怎么用
- AI 只能调用你启用的工具，这一版的工具都是只读的。
- 每个工具可以选「在哪些问题上提供」（和技能一样按问题类型）：不选就是所有对话都提供；选了就只在这些类型的问题上交给 AI。每条回复最多提供 8 个工具，工具多的时候 AI 更快、更不容易用错。
- 顾客问到需要实时数据的问题时，AI 调用合适的工具，按返回内容回答。每条回复最多调用 3 次。
- 返回内容和知识库一样，要经过发送前的核对：回复里的数字和状态必须来自工具返回。
- 工具调用失败、超时（5 秒）或报错时，AI 不会编答案，而是交给人工。
测试和发布
- 保存的工具先是草稿：在「试聊」里可以直接试，发布之后顾客才用得到，和技能一样。
- 每个工具下面有「测试」：按保存的设置真实调用一次，显示原始返回和「AI 能看到的」内容。需要顾客身份的工具，可以填一位示例顾客。
- 「最近的调用」列出每次调用的时间、成功与否、耗时和错误，保留 90 天。
MCP 工具变了怎么办
purser 每天检查一次你启用的 MCP 工具：服务器上某个工具的说明或参数变了，或者工具没了，这个工具会被自动停用，店主和管理员会收到通知。重新确认后再启用即可。