> 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.

# 认识豆包应用插件

:::warning 特别提示

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

:::

## 1. 豆包应用插件是什么

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

![豆包应用插件由 Skill 说明书、MCP Server 和对话内卡片组成，也可以接入全页、登录、支付与主动通知。](//lf-flow-web-cdn.doubao.com/obj/flow-doubao/goofy_deploy_edenx/flow/doubao-apps--plugin-doc/static/image/apps-plugin-overview-diagram.93e05a444f.jpg)
应用插件由豆包主模型根据用户意图分发，用户无需先安装。服务也可以出现在插件中心和豆包工作模式中。主要分发方式包括：

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

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

| 搜索                                                  | 推荐                                             | 固定入口                                             |
| --------------------------------------------------- | ---------------------------------------------- | ------------------------------------------------ |
| <img alt="豆包根据“我想喝冰美式”展示多家商家的商品卡片。" src={image1} /> | <img alt="豆包回答做菜问题，并提供后续操作入口。" src={image2} /> | <img alt="出行场景的固定入口提供服务分类和推荐问题。" src={image3} /> |

## 2. 开发者能获得什么

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

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

开发者的权利与义务见[平台协议](/apps-plugin/docs/payment-legal/agreements.md)。

## 3. 开发者需要做什么

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

| 组成部分                                                                  | 接入要求    | 作用                                    |
| --------------------------------------------------------------------- | ------- | ------------------------------------- |
| [MCP Server](/apps-plugin/docs/skill-development/mcp-server.md)       | 必备      | 封装业务接口，定义工具、参数和返回结果。                  |
| [Skill 说明书](/apps-plugin/docs/core-concepts/skill-guidelines.md)      | 必备      | 告诉模型何时使用服务、调用哪个工具，以及如何填写参数。           |
| [对话内卡片](/apps-plugin/docs/design-principles/card-design.md)           | 建议接入    | 在对话中展示工具结果，并承载关键节点的轻量操作。使用平台提供的模板和组件。 |
| [全页](/apps-plugin/docs/frontend-development/full-page.md)             | 按需接入    | 承载选座、改单、填单等复杂交互。                      |
| [主动通知](/apps-plugin/docs/backend-development/service-notification.md) | 必备      | 在必要环节告知用户和模型任务进展。                     |
| [对话内登录](/apps-plugin/docs/backend-development/login.md)               | 必备      | 在识别用户、读取私域数据或下单时完成身份认证。               |
| [对话内支付](/apps-plugin/docs/backend-development/payment.md)             | 涉及收款时必备 | 在对话中向用户收款。                            |

工具可以提供两类能力：

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

## 4. 接入流程与周期

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

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

具体要求见[审核标准](/apps-plugin/docs/release/review-guidelines.md)。

## 5. 常见问题

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

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

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

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

### Q3. 必须提供界面吗？

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

### Q4. 必须接入豆包支付吗？

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

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

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

### Q6. 开发时如何排查问题？

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

### 如何提高审核通过率

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