百宝箱开放平台 ✖️ 调用插件工具

支付宝小程序云2025-10-09 16:08

通过调用本接口，开发者可以在外部系统中使用百宝箱提供的插件工具。

请求地址

POST``https://api.tbox.cn/api/plugin/invoke

请求头

参数名 必填 类型 说明 示例
Authorization 是 String 用于验证客户端身份的访问令牌，你可以在百宝箱中获取，获取方式可参见：授权管理。 pat_2j4e******THUIVRH1

请求参数

参数名 必填 类型 说明 示例
pluginToolId 是 String 工具 ID，由查询官方插件列表接口获取。 -
params 是 Map<String, Object>- key: 参数名 value：参数值 工具调用所需参数，由查询官方插件列表接口获取。 -

请求示例

css 复制代码 
curl --location 'https://api.tbox.cn/api/plugin/invoke' \
--header 'Authorization: {your_token}' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--data '{
    "pluginToolId":{pluginToolId},
    "params": {
          "q": "xxx"
      }
    
}'

返回参数

参数名 类型 说明 示例
errorCode String 错误码，为 0 表示成功。 0
errorMsg String 错误信息。 success
data ToolResponse 插件调用结果详情。 -
traceId String 本次请求的唯一标识，通常用于发生错误时的排查定位。 0b****4d9

data 定义

参数名 类型 说明
success Boolean 是否调用成功
response Object 工具响应结果，结构请参考查询官方插件列表接口获取的工具输出参数定义。

返回示例

成功示例

json 复制代码 
{
    "data": {
        "response": {
            "msg": "操作成功",
            "code": 0,
            "data": [
                {
                    "hostName": "",
                    "publishTime": "1755355752",
                    "extra": {
                        "extraUrl": "https://www.jinjia.com.cn/",
                        "domain": "quark",
                        "sort": 0,
                        "extraTitle": "金价网-今日金价查询表"
                    },
                    "channel": "quark",
                    "articleId": "quark_f9bc6e9d934638a361ec0bc85042aef2",
                    "title": "金价网-今日金价查询表",
                    "url": "https://www.jinjia.com.cn/",
                    "desc": "金价网是一个专业的黄金价格查询平台，提供黄金市场行情，包括国际国内黄金、今日金价、上海黄金、银行黄金价格、香港黄金价格行情行情等内容，全力为广大投资者提供黄金的信息服务。"
                },
                {
                    "hostName": "",
                    "publishTime": "1755579111",
                    "extra": {
                        "extraUrl": "https://www.jinrijinjia.cn/",
                        "domain": "quark",
                        "sort": 1,
                        "extraTitle": "今日黄金价格查询_现在金价黄金多少钱一克_国际金价实时行情_黄金金价网"
                    },
                    "channel": "quark",
                    "articleId": "quark_c1643b6a5b01737aa37ff505fcdee306",
                    "title": "今日黄金价格查询_现在金价黄金多少钱一克_国际金价实时行情_黄金金价网",
                    "url": "https://www.jinrijinjia.cn/",
                    "desc": "国内金价 778.61 -9.58 -1.22% 788.30 777.00 788.00 788.19 克/人民币 国内银价 9388.00 -87.00 -0.92% 9498.00 9355.00 9474.00 9475.00 千克/人民币 24小时黄金实时快讯 2025年7月23日黄金价格多少钱一克今日查询"
                },
                {
                    "hostName": "",
                    "publishTime": "1755404286",
                    "extra": {
                        "extraUrl": "http://guojijinjia.com/",
                        "domain": "quark",
                        "sort": 2,
                        "extraTitle": "国际金价_今日金价实时行情最新黄金价格查询"
                    },
                    "channel": "quark",
                    "articleId": "quark_bf6d40e5c901948bc8c67979df037da5",
                    "title": "国际金价_今日金价实时行情最新黄金价格查询",
                    "url": "http://guojijinjia.com/",
                    "desc": "伦敦金价现货走势图纽约黄金期货走势图中国上海黄金走势图今日国际金价行情使用说明提供今天黄金即时价格走势查询，实时报价更..."
                },
                {
                    "hostName": "",
                    "publishTime": "1755273600",
                    "extra": {
                        "extraUrl": "http://www.huangjinjiage.cn/golden/113761.html",
                        "domain": "quark",
                        "sort": 3,
                        "extraTitle": "国内金价实时查询（24小时行情走势图|回收价格|今日价格）金价查询网"
                    },
                    "channel": "quark",
                    "articleId": "quark_20c83ec8f20e02af69f8ca74b3e828d7",
                    "title": "国内金价实时查询（24小时行情走势图|回收价格|今日价格）金价查询网",
                    "url": "http://www.huangjinjiage.cn/golden/113761.html",
                    "desc": "国内金价今日多少钱一克？提供国内金价实时查询、国内金价行情走势图、国内金价回收多少钱一克、国内金价最低多少钱一克等国内金价今天什么价格查询。今日国内金价实时查询黄金品种回收价格销售..."
                },
                {
                    "hostName": "",
                    "publishTime": "1755273600",
                    "extra": {
                        "extraUrl": "http://www.huangjinjiage.cn/jinrijinjia.html",
                        "domain": "quark",
                        "sort": 4,
                        "extraTitle": "今日金价（实时更新）黄金价格今日多少钱一克_金价查询网"
                    },
                    "channel": "quark",
                    "articleId": "quark_0cc918acaf7b8c7ef28607741439a2c1",
                    "title": "今日金价（实时更新）黄金价格今日多少钱一克_金价查询网",
                    "url": "http://www.huangjinjiage.cn/jinrijinjia.html",
                    "desc": "本页面提供今日金价在线查询，包括国际金价、国内金价、今日金价、上海黄金价格、银行黄金价格、金店黄金价格、黄金回收价格等实时行情报价。黄金价格今日实时报价名称卖出价格今日价格最高价格最低价格价格..."
                },
                {
                    "hostName": "",
                    "publishTime": "1755273600",
                    "extra": {
                        "extraUrl": "http://www.huangjinjiage.cn/quote/113124.html",
                        "domain": "quark",
                        "sort": 5,
                        "extraTitle": "金价国际今日价格（走势图|24小时实时|金条价格|回收）金价查询网"
                    },
                    "channel": "quark",
                    "articleId": "quark_cbf5cbd99ca272cf052d5bc5b8bb1541",
                    "title": "金价国际今日价格（走势图|24小时实时|金条价格|回收）金价查询网",
                    "url": "http://www.huangjinjiage.cn/quote/113124.html",
                    "desc": "提供黄金金价国际今日价格在线查询，通过走势图实时了解金价的变化，还提供金条价格和回收价格的最新报价查询，无论你是购买黄金、投资黄金还是回收黄金，在这里都可以查到实时金价行情。金价..."
                }
            ],
            "success": true
        }
    },
    "errorCode": "0",
    "errorMsg": "success",
    "traceId": "0be8*******e477"
}

失败返回

json 复制代码 
{
    "errorCode": "P_1_03_200",
    "errorMsg": "必传参数缺少参数值",
    "solution": ""
}

错误码

公共错误码

errorCode errorMsg 说明
S40000 系统异常 - 原因：系统出现错误。 解决方案：请稍后重试，若持续报错，请点击此处与我们取得联系，并将错误码与 traceId 一同反馈，帮助我们快速定位问题。
P_1_10_183 授权令牌无效 - 原因：token 不正确。 解决方案：请校验是否输入了有效令牌或配置新令牌。
P_1_10_184 授权令牌已失效 - 原因：当前 token 已过期。 解决方案：请前往百宝箱开放平台申请新令牌并更新到调用配置中。
P_1_10_185 未检测到授权令牌 - 原因：未填写 token 信息 解决方案：请参考授权管理完成授权令牌的申请和配置。
P_1_13_682 非法访问，请联系平台 - 原因：系统检测到异常活动。 解决方案：请稍后重试，若持续报错，请点击此处与我们取得联系，并将错误码与 traceId 一同反馈，帮助我们快速定位问题。

参数校验与业务错误码

errorCode errorMsg 说明
P_1_00_005 不合法的插件类型 - 原因：查询官方插件列表插件类型参数不合法 解决方案：确认插件类型参数是否在合法枚举值内- - 实用工具：UTILITY_TOOL生活服务：LIFE_SERVICE 内容搜索：CONTENT_SEARCH MCP工具：MCP_TOOL
P_1_02_111 工具不存在或已下架 - 原因：调用的工具不存在或已下架 解决方案：请检查入参 pluginToolId 是否正确
P_1_02_111 插件不存在或已下架 - 原因：调用的工具所属插件不存在或已下架 解决方案：请检查入参 pluginToolId 是否正确
P_1_02_111 该工具不支持通过openapi/sdk调用 - 原因：该工具不支持通过 openapi/sdk 调用 解决方案：请检查入参 pluginToolId 是否正确
P_1_03_200 必传参数缺少参数值 - 原因：工具必传入参未填 解决方案：确认必传参数都已传值
P_1_03_200 参数值超出枚举范围 - 原因：工具参数值超出枚举范围 解决方案：确认参数值在枚举值范围内
相关推荐
nbtang202639 分钟前
AI Agent 入门（三）：Tool Use 入门 —— Function Calling 原理与实战
人工智能·ai·agent
新知图书1 小时前
RAG之生成技术
人工智能·agent·ai agent·智能体·langgraph
武子康1 小时前
调查研究-211 AgentBound 深度解析：AI Agent 不只要“有权限”，还要有可验证的行为治理
人工智能·llm·agent
aovenus2 小时前
Skill / Agent / Workflow 使用场景指南及对比
agent·workflow·skill
JouYY3 小时前
聊一下知识答疑Agent的“层次聚类”流程
架构·llm·agent
L3S4 小时前
Agent为什么会死循环？
人工智能·agent
云烟成雨TD4 小时前
LangFlow 1.x 系列【3】入门案例
人工智能·python·agent
墨流藏于库4 小时前
Electron 应用 macOS 自动更新的正确姿势 —— 没有 Apple Developer Program 也能用
agent
新知图书5 小时前
智能体基础架构
人工智能·agent·ai agent·智能体·langgraph
热门推荐
012026 年 AI 编程工具终极横评：Cursor vs Claude Code vs Copilot vs Windsurf02GitHub 镜像站点03【AI】2026 年具身智能模型和世界模型总结04AI科技热点日报 | 2026年07月01日052026 AI 编程工具终极实战指南：Cursor vs Claude Code vs Copilot，开发者该怎么选？062026年6月AI大模型全景报告：GPT-5.6、Claude Opus 4.8、Gemini 3.5，中美AI三足鼎立谁主沉浮？072026 年 AI 大模型 & AI 编程工具实战全总结08Claude Code、Codex、Cursor三分天下：2026年AI编程Agent生态全景剖析092026年6月AI行业全景：从百模大战到Agent元年，这30天发生了什么？10Agnes AI 免费 API 接入指南：文本、生图、生视频，一套接口全免费