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

简介: 开发者可通过调用百宝箱插件接口,在外部系统中使用其提供的各类工具。需在请求头中提供有效授权令牌,并在请求体中指定工具ID及参数,支持JSON格式通信,返回结果包含执行状态与数据详情。

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

请求地址

POSThttps://api.tbox.cn/api/plugin/invoke

请求头

参数名

必填

类型

说明

示例

Authorization

String

用于验证客户端身份的访问令牌,你可以在百宝箱中获取,获取方式可参见:授权管理

pat_2j4e******THUIVRH1

请求参数

参数名

必填

类型

说明

示例

pluginToolId

String

工具 ID,由查询官方插件列表接口获取。

-

params

Map<String, Object>

  • key: 参数名
  • value:参数值

工具调用所需参数,由查询官方插件列表接口获取。

-

请求示例

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

插件调用结果详情,详细说明可参见:data 定义

-

traceId

String

本次请求的唯一标识,通常用于发生错误时的排查定位。

0b****4d9

data 定义

参数名

类型

说明

success

Boolean

是否调用成功

response

Object

工具响应结果,结构请参考查询官方插件列表接口获取的工具输出参数定义。

返回示例

{
    "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"
}


{
    "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

参数值超出枚举范围

  • 原因:工具参数值超出枚举范围
  • 解决方案:确认参数值在枚举值范围内


相关文章
|
4月前
|
搜索推荐 API 开发工具
百宝箱开放平台 ✖️ Python SDK
百宝箱提供Python SDK,支持开发者集成其开放能力。需先发布应用,安装Python 3.6+环境后,通过pip安装tboxsdk,即可调用对话型、生成型智能体及文件上传等功能。
844 87
百宝箱开放平台 ✖️  Python SDK
|
4月前
|
SQL XML Java
Mybatis基础使用知识(注解)
mybatis 通过 xml 或注解的方式将要执行的各种 statement 配置起来,并通过java对象和statement中sql的动态参数进行映射生成最终执行的sql语句。 最后 mybatis 框架执行sql 并将结果映射为java对象并返回。采用ORM(对象关系映射)思想解决了实体和数据库映射问题,对jdbc进行了封装,屏蔽了jdbc api 底层访问细节,使我们不用与jdbc api 打交道,就可以完成对数据库的持久化操作。
433 1
|
6月前
|
存储 缓存 中间件
《金融对账系统雪崩隐患的深度复盘与架构重生》
本文复盘了金融级支付对账系统因分布式缓存设计缺陷引发的隐性危机:系统上线后,对账高峰时段出现节点“假死”、数据不一致问题,却无明显资源耗尽迹象,且问题间歇性发生。排查发现,高并发下任务调度框架返回异常商户ID,生成无效缓存Key,叠加缓存客户端“批量合并请求”与“无限重试”设计,导致线程池阻塞;节点恢复后又因任务状态未同步,引发数据重复处理或遗漏。通过全链路数据校验、缓存交互优化(分段查询+降级熔断)、分布式锁与全局状态同步,系统问题得以解决,最终提炼出分布式系统开发的四大核心原则,为后端架构设计提供参考。
240 33
|
3月前
|
人工智能 搜索推荐 API
蚂蚁百宝箱联手深铁打造全国首个地铁 AI 智能体「深铁宝」:你的全能城市向导来啦~
蚂蚁百宝箱联合深铁集团、深圳通推出全国首个“公共出行+城市服务”AI智能体「深铁宝」,上线于深圳地铁、深圳通及支付宝APP,实现一句话直达、秒级响应的智慧出行体验,涵盖出行规划、乘车码快捷调取、周边生活服务推荐等一站式功能,助力城市交通与服务数字化升级。
538 30
|
4月前
|
自然语言处理 JavaScript API
百宝箱开放平台 ✖️ 开发流程
本文介绍通过开放平台集成智能体能力的流程,包括创建发布应用、获取授权令牌及调用API/SDK三步。涵盖智能体调用、模型测评、文件操作等接口,并提供Java、Python、Node.js及Web SDK支持,助力开发者快速实现智能对话与内容生成功能集成。(239字)
367 0
百宝箱开放平台 ✖️ 开发流程
|
4月前
|
Java API 开发工具
蚂蚁百宝箱 ✖️ 调用对话型智能体
通过调用本接口,开发者可以向指定智能体发起对话,支持在对话时添加上下文消息,便于智能体做出合理的回复。
133 0
|
3月前
|
人工智能 API 开发工具
蚂蚁百宝箱首届「插件开发大赛」,赛事持续至12月7日,最高赢取3W奖金!
首届「MCP插件开发大赛」由蚂蚁百宝箱联合通义灵码发起,聚焦企业场景,鼓励开发者基于AI Agent打造高效、创新的MCP插件。赛事持续至2025年12月7日,提供最高3万元现金奖励、免费AI工具支持及全程技术指导。参赛者可借助通义灵码开发,通过蚂蚁百宝箱发布部署,并在NeMo Agent Toolkit平台验证智能体效果。无论新手或专家,皆可实战练兵,推动AI技术落地,赢取丰厚回报。
207 1
|
4月前
|
API 开发工具 开发者
百宝箱开放平台 ✖️ API 使用过程中的常见问题
本文介绍了百宝箱OpenAPI调用的关键步骤与常见问题处理,涵盖会话ID获取、授权令牌配置、用户ID填写及多轮对话参数匹配等核心要点,帮助开发者快速定位并解决接口报错问题。
480 1