工具概述

工具功能使你的 AI 接待员能够在通话过程中通过调用外部 API 与第三方系统交互 (如查询订单状态或预约)。你可以定义一组自定义工具，并将其分配给 AI 接待员。在通话过程中，AI 接待员将基于通话内容自动触发相应的工具，构建并发送 HTTP 请求至工具中预先定义的 API 端点，从而从第三方系统获取实时数据或执行指定操作。

使用要求

Yeastar P 系列云 PBX 的固件为 84.23.0.123 或更高版本。

限制条件

PBX 最多支持 100 个自定义工具。
对于外部 API 调用，自定义工具仅支持静态配置的凭证 (如 API Key、基本身份验证、静态 Bearer Token) 或无需认证的公共 API。
注：不支持动态认证 (如 OAuth 2.0)，因其需要动态获取 token，无法预先配置。

添加工具的方式

你可以通过以下任一方式添加自定义工具：


方式	说明
手动配置	在 PBX 管理网页中手动填写所有工具设置，包括基本信息、执行规则和请求参数。此方式适用于单个工具的创建或测试。更多信息，请参见手动添加工具。
JSON 文件上传	上传一个或多个 JSON 文件，以快速添加工具。每个文件需包含一个自定义工具的完整配置。系统会自动解析文件，并在上传成功后创建工具。此方式适用于批量配置或工具的备份还原。更多信息，请参见通过上传文件添加工具。