认识豆包应用插件
本材料仅限定向受邀方内部使用,请注意严格保密。未经双方同意,严禁向第三方披露、转发或用于约定范围之外的其他用途。
1. 豆包应用插件是什么
豆包应用插件是运行在豆包对话环境中的智能体应用。它通过 MCP 协议连接开发者的服务,让用户用自然语言和轻量界面完成查询与操作。

应用插件由豆包主模型根据用户意图分发,用户无需先安装。服务也可以出现在插件中心和豆包工作模式中。主要分发方式包括:
- 搜索:用户提出明确需求时,豆包可以展示对应的商品或服务卡片。
- 推荐:用户先咨询问题时,豆包可以在回答后推荐相关的追问。
- 固定入口:用户可以从插件中心等入口再次访问服务。
下面的示例分别展示搜索、推荐和固定入口:
2. 开发者能获得什么
豆包可以在用户咨询、比较和决定购买的过程中发现其需求,并把相关服务带入对话。开发者可以提供商品、知识或操作能力,让用户在对话内完成后续流程。
- 更早触达用户:用户尚未指定品牌或打开独立应用时,服务就有机会回应其需求。
- 获得增量入口:应用插件可以与开发者现有的 App 或小程序并行提供服务。
- 降低试用成本:开发者可以先交付一个完整的小流程,再逐步扩展能力。
- 支持再次访问:用户可以通过固定入口回到应用插件。
开发者的权利与义务见平台协议。
3. 开发者需要做什么
开发者需要提供能让豆包主模型调用的服务。服务应覆盖明确的用户意图,并让用户在对话中完成查询或操作。开发者可以结合平台提供的参考场景和脱敏查询,确定需要实现的能力。
工具可以提供两类能力:
- 查询检索:找门店、找商品、查订单、查专业知识或查询历史记录。
- 动作执行:下单、改单、支付或处理售后。
4. 接入流程与周期
接入通常经过“提交对齐、开发提审、评测放量”三个阶段。参考周期约为 4~6 周。实际进度取决于能力范围、测试结果和审核反馈。
- 阅读快速开始及平台提供的参考场景和查询示例。
- 设计工具的输入与输出、Skill 说明书、卡片、接口能力和主动通知内容,并提交方案。
- 根据反馈调整方案,使用开发工具完成开发、调试和验证。
- 使用真机调试工具完成端到端自测,固定版本并提交产物审核。
- 根据审核反馈修改并重新提交,直至通过准出检查。
- 提交工具说明与内测名单,进入小流量实验;后续放量取决于实验结果。
具体要求见审核标准。
5. 常见问题
Q1. 如何获取开发文档与工具?
当前接入采用邀请制。开发者可以联系对接人获取邀请码。
Q2. 应用插件与一般插件有什么区别?
应用插件面向豆包对话中的服务流程。豆包主模型可以按用户意图分发能力,开发者则通过 MCP Server、Skill 和卡片提供服务。应用插件还支持对话内登录、支付,以及按需使用全页。一般插件的接入方式和交互要求可能不同。
Q3. 必须提供界面吗?
开发者可以在关键节点使用官方卡片模板,例如商品卡或订单卡。复杂的选座、改单和填单流程可以放在半屏页或全页中。对话能完成的步骤可以继续留在对话中。
Q4. 必须接入豆包支付吗?
如果应用插件在对话中向用户收款,就需要接入豆包对话内支付。目前支持抖音支付和聚合支付两种方式。涉及提现等资金流出的能力,需要先与豆包及双方风控团队对齐。
Q5. 可以跳回开发者自己的 App 吗?
应用插件以对话内完成服务为目标。当前原则上不支持跳回开发者的 App,包括客服、售后和发票等流程。复杂页面可以按需使用内嵌 H5 承载。
Q6. 开发时如何排查问题?
先使用 dbx、本地模拟器和真机调试工具查看日志及 LogID。排查时,应确保代码、令牌和 AppID 属于同一环境。如果仍无法解决,可以向平台答疑机器人或开发者平台工单提供复现步骤、环境和 LogID。
如何提高审核通过率
- 让工具的输入与输出覆盖一个完整的自然语言服务流程。
- 使用平台提供的卡片模板,并只在必要节点展示卡片。
- 提交前按工具准出标准检查 Schema、Skill、返回结果和错误码。
- 使用平台提供的查询示例完成端到端自测。
- 使用真机调试工具走通完整流程后再提交审核。


