For AI agents: the complete documentation index is available at /apps-plugin/docs/llms.txt, the full documentation bundle is available at /apps-plugin/docs/llms-full.txt, and this page is available as Markdown at /apps-plugin/docs/overview/introduction.md.

认识豆包应用插件

特别提示

本材料仅限定向受邀方内部使用,请注意严格保密。未经双方同意,严禁向第三方披露、转发或用于约定范围之外的其他用途。

1. 豆包应用插件是什么

豆包应用插件是运行在豆包对话环境中的智能体应用。它通过 MCP 协议连接开发者的服务,让用户用自然语言和轻量界面完成查询与操作。

豆包应用插件由 Skill 说明书、MCP Server 和对话内卡片组成,也可以接入全页、登录、支付与主动通知。

应用插件由豆包主模型根据用户意图分发,用户无需先安装。服务也可以出现在插件中心和豆包工作模式中。主要分发方式包括:

  • 搜索:用户提出明确需求时,豆包可以展示对应的商品或服务卡片。
  • 推荐:用户先咨询问题时,豆包可以在回答后推荐相关的追问。
  • 固定入口:用户可以从插件中心等入口再次访问服务。

下面的示例分别展示搜索、推荐和固定入口:

搜索推荐固定入口
豆包根据“我想喝冰美式”展示多家商家的商品卡片。豆包回答做菜问题,并提供后续操作入口。出行场景的固定入口提供服务分类和推荐问题。

2. 开发者能获得什么

豆包可以在用户咨询、比较和决定购买的过程中发现其需求,并把相关服务带入对话。开发者可以提供商品、知识或操作能力,让用户在对话内完成后续流程。

  • 更早触达用户:用户尚未指定品牌或打开独立应用时,服务就有机会回应其需求。
  • 获得增量入口:应用插件可以与开发者现有的 App 或小程序并行提供服务。
  • 降低试用成本:开发者可以先交付一个完整的小流程,再逐步扩展能力。
  • 支持再次访问:用户可以通过固定入口回到应用插件。

开发者的权利与义务见平台协议。

3. 开发者需要做什么

开发者需要提供能让豆包主模型调用的服务。服务应覆盖明确的用户意图,并让用户在对话中完成查询或操作。开发者可以结合平台提供的参考场景和脱敏查询,确定需要实现的能力。

组成部分接入要求作用
MCP Server必备封装业务接口,定义工具、参数和返回结果。
Skill 说明书必备告诉模型何时使用服务、调用哪个工具,以及如何填写参数。
对话内卡片建议接入在对话中展示工具结果,并承载关键节点的轻量操作。使用平台提供的模板和组件。
全页按需接入承载选座、改单、填单等复杂交互。
主动通知必备在必要环节告知用户和模型任务进展。
对话内登录必备在识别用户、读取私域数据或下单时完成身份认证。
对话内支付涉及收款时必备在对话中向用户收款。

工具可以提供两类能力:

  • 查询检索:找门店、找商品、查订单、查专业知识或查询历史记录。
  • 动作执行:下单、改单、支付或处理售后。

4. 接入流程与周期

接入通常经过“提交对齐、开发提审、评测放量”三个阶段。参考周期约为 4~6 周。实际进度取决于能力范围、测试结果和审核反馈。

  1. 阅读快速开始及平台提供的参考场景和查询示例。
  2. 设计工具的输入与输出、Skill 说明书、卡片、接口能力和主动通知内容,并提交方案。
  3. 根据反馈调整方案,使用开发工具完成开发、调试和验证。
  4. 使用真机调试工具完成端到端自测,固定版本并提交产物审核。
  5. 根据审核反馈修改并重新提交,直至通过准出检查。
  6. 提交工具说明与内测名单,进入小流量实验;后续放量取决于实验结果。

具体要求见审核标准。

5. 常见问题

Q1. 如何获取开发文档与工具?

当前接入采用邀请制。开发者可以联系对接人获取邀请码。

Q2. 应用插件与一般插件有什么区别?

应用插件面向豆包对话中的服务流程。豆包主模型可以按用户意图分发能力,开发者则通过 MCP Server、Skill 和卡片提供服务。应用插件还支持对话内登录、支付,以及按需使用全页。一般插件的接入方式和交互要求可能不同。

Q3. 必须提供界面吗?

开发者可以在关键节点使用官方卡片模板,例如商品卡或订单卡。复杂的选座、改单和填单流程可以放在半屏页或全页中。对话能完成的步骤可以继续留在对话中。

Q4. 必须接入豆包支付吗?

如果应用插件在对话中向用户收款,就需要接入豆包对话内支付。目前支持抖音支付和聚合支付两种方式。涉及提现等资金流出的能力,需要先与豆包及双方风控团队对齐。

Q5. 可以跳回开发者自己的 App 吗?

应用插件以对话内完成服务为目标。当前原则上不支持跳回开发者的 App,包括客服、售后和发票等流程。复杂页面可以按需使用内嵌 H5 承载。

Q6. 开发时如何排查问题?

先使用 dbx、本地模拟器和真机调试工具查看日志及 LogID。排查时,应确保代码、令牌和 AppID 属于同一环境。如果仍无法解决,可以向平台答疑机器人或开发者平台工单提供复现步骤、环境和 LogID。

如何提高审核通过率

  • 让工具的输入与输出覆盖一个完整的自然语言服务流程。
  • 使用平台提供的卡片模板,并只在必要节点展示卡片。
  • 提交前按工具准出标准检查 Schema、Skill、返回结果和错误码。
  • 使用平台提供的查询示例完成端到端自测。
  • 使用真机调试工具走通完整流程后再提交审核。