示例工具

本文提供了三个可直接使用的示例工具，帮助你快速测试工具功能。

重要： 本文提供的示例工具仅供功能测试使用，调用的是公开的模拟 API (jsonplaceholder.typicode.com)，不会对真实业务数据产生影响，请勿在生产环境中使用。
注： 你可以通过以下任一方式将这些工具添加到 PBX：
  • 复制 JSON 配置后将其粘贴到工具的 JSON 编辑器中。更多信息，请参见 手动添加工具。

工具 1：查询订单

  • 使用场景：当来电者想要查询特定订单状态时使用此工具。
  • 示例请求：来电者向 AI 接待员询问 “你能帮我查一下订单 5 的状态吗？”

  • JSON 配置 (下载 JSON 文件 以测试)

    {
    "basic": {
        "name": "query_order",
        "description": "当客户询问“查询订单”、“查看订单状态”或“获取订单详情”时使用此工具。从对话中提取数字类型的 order_id（例如“订单 3”→ order_id=3）。",
        "method": "GET",
        "url": "https://jsonplaceholder.typicode.com/posts/{order_id}",
        "remark": "示例 - 根据 ID 查询订单"
    },
    "response_settings": {
        "disable_interruptions": false,
        "force_pre_tool_speech": true,
        "execution_mode": "immediate",
        "tool_call_sound": "Typing",
        "sound_behavior": "always_play",
        "response_timeout": 20
    },
    "path_params": [
        {
            "parameter": "order_id",
            "data_type": "Integer",
            "value_logic": "llm",
            "description": "从客户请求中提取订单 ID，例如“订单 3”→ 3"
        }
    ],
    "headers": [
        {
            "parameter": "Accept",
            "value": "application/json"
        }
    ],
    "query_params": [],
    "body_description": "",
    "body_params": []
}

工具 2：获取用户订单列表

  • 使用场景：当来电者想要查看自己的全部订单时使用此工具。
  • 示例请求：来电者向 AI 接待员询问 “查看我最近的订单，我的账户 ID 是 1。”

  • JSON 配置 (下载 JSON 文件 以测试)

    {
    "basic": {
        "name": "get_orders_by_user",
        "description": "当客户询问“我的订单列表”、“显示我的记录”或“我最近的请求有哪些”时使用此工具。从对话中提取 userId。",
        "method": "GET",
        "url": "https://jsonplaceholder.typicode.com/posts",
        "remark": "示例 - 根据用户 ID 查询订单"
    },
    "response_settings": {
        "disable_interruptions": false,
        "force_pre_tool_speech": true,
        "execution_mode": "immediate",
        "tool_call_sound": "Typing",
        "sound_behavior": "always_play",
        "response_timeout": 20
    },
    "path_params": [],
     "headers": [
        {
            "parameter": "Accept",
            "value": "application/json"
        }
    ],
    "query_params": [
        {
            "parameter": "userId",
            "required": true,
            "data_type": "Integer",
            "value_logic": "llm",
            "description": "从对话中提取用户 ID，例如“我的用户 ID 是 1”→ 1"
        }
    ],
    "body_description": "",
    "body_params": []
}

工具 3：创建订单

  • 使用场景：当来电者想要上报问题或创建工单时使用此工具。
  • 示例请求：来电者向 AI 接待员告知 “我需要报告一个问题。我的包裹送达时已损坏，要申请退款。”

  • JSON 配置 (下载 JSON 文件 以测试)

    {
    "basic": {
        "name": "create_order",
        "description": "当客户想要创建工单、提交请求或报告问题时使用此工具。从对话中提取标题（简短摘要）和正文（详细描述）。",
        "method": "POST",
        "url": "https://jsonplaceholder.typicode.com/posts",
        "remark": "示例 - 创建订单/工单"
    },
    "response_settings": {
        "disable_interruptions": false,
        "force_pre_tool_speech": false,
        "execution_mode": "immediate",
        "tool_call_sound": "Typing",
        "sound_behavior": "always_play",
        "response_timeout": 20
    },
    "path_params": [],
    "headers": [
        {
            "parameter": "Content-Type",
            "value": "application/json"
        }
    ],
    "query_params": [],
    "body_description": "从客户对话中提取请求信息。",
    "body_params": [
        {
            "parameter": "title",
            "required": true,
            "data_type": "String",
            "value_logic": "llm",
            "description": "从对话中提取问题的简短标题/摘要。保持在 10 个词以内。",
            "optional_values": []
        },
        {
            "parameter": "body",
            "required": true,
            "data_type": "String",
            "value_logic": "llm",
            "description": "从对话中提取问题的完整描述，包括客户提及的所有详细信息。",
            "optional_values": []
        },
        {
            "parameter": "userId",
            "required": true,
            "data_type": "Integer",
            "value_logic": "constant",
            "constant_value": "1"
        }
    ]
}