> ## Documentation Index
> Fetch the complete documentation index at: https://docs.coze.cn/llms.txt
> Use this file to discover all available pages before exploring further.

本文介绍如何将你在扣子 AI 编程开发的智能体，部署为 API 服务或 Web SDK。部署为 API 服务，让你可以通过 OpenAPI 方式将智能体的 AI 功能灵活集成到应用中。部署为 Web SDK，将提供网页嵌入式聊天窗口，用户可直接在网页中与智能体进行对话。
## **使用限制** {#f39c8076}

* 仅智能体的**所有者**有权限执行部署操作，且可创建的项目数量、部署次数等均存在配额限制。详情请参见[配额与限制](/guides/vibe_coding_limit)。
* 如需部署 Web SDK 渠道，只需将智能体部署到 API 渠道，然后在**部署** > **渠道** 页面打开 Web SDK 渠道即可，无需重新部署。
* 调整智能体的发布渠道，也只需在**部署** > **渠道** 页面开启或关闭对应的渠道，无需重新部署。

## **准备工作** {#28c4e405}
在开始部署之前，请确保你已通过扣子编程开发智能体，且试运行通过。具体可参考[开发智能体](/guides/vibe_coding_agent)。
## **部署操作** {#db68177a}

1. 在[扣子编程](https://code.coze.cn/home)左侧导航栏选择**项目管理**，筛选带有 **New** 标签的智能体，单击目标项目。
2. 在 AI 编程开发界面的右上角，单击**部署**。
3. 确认部署渠道。
   智能体的可用渠道可以在 **部署** > **渠道** 页面配置，此处仅展示。
4. 填写部署配置。
   <!-- @cols-width: 193,580 -->
   | | | \
   |**配置** |**说明** |
   |---|---|
   | | | \
   |部署版本 |选择要部署的开发版本。 |
   | | | \
   |部署域名 |Agent API 的访问域名，默认由扣子分配，你也可以根据页面提示自行调整域名前缀。 |\
   | |如果此项目已部署上线，修改前缀后将立即生效，无需重新部署。Agent 的旧域名将失效，建议修改前后及时通知被分享过的用户。 |
   | | | \
   |服务器资源 |默认规格为 1C2G，2 个实例、每个实例 100 并发，可满足基础运行的需求。 |\
   | |:::tip 说明 |\
   | |**套餐限制**：仅限**个人高阶版及以上版本**订阅套餐用户灵活调整部署的服务器资源。 |\
   | |::: |\
   | |部分订阅套餐的用户还可以根据项目的复杂度、规模、预期访问量，选择合适的服务器资源、实例数和单实例并发数。部署后也可以根据访问情况随时扩容。设置说明如下： |\
   | | |\
   | |* **CPU 和 内存**：单个服务实例可使用的计算资源，包括 CPU 和内存。配置越高，应用能承载的任务越重，运行也更稳定。 |\
   | |* **实例数**：表示应用在高流量情况下最多可启动的服务实例数量。平台会根据实际访问流量自动扩缩容：当请求量超过单个实例的并发承载能力时，会逐步增加实例来共同处理请求；当没有访问流量时，服务可缩容至 0 个实例，以减少资源占用和成本。 |\
   | |* **单实例并发**：表示每个实例允许同时处理的最大请求数量。最大总并发通常可按 `实例数 × 单实例并发` 估算。 |\
   | | |\
   | |如何合理为项目设置服务器资源，可参考[如何合理设置部署的服务器资源？](/guides/vibe_coding_faq#96e2bba7) |

5. 确认**更多配置**。
   数据库、生产环境变量、构建指令、端口等高级部署配置，你可以展开**更多配置**，查看或修改配置详情。
   <!-- @cols-width: 193,580 -->
   | | | \
   |**配置** |**说明** |
   |---|---|
   | | | \
   |数据库 |仅在集成了数据库能力时需要配置。用于设置是否隔离生产环境和开发环境的数据。 |\
   | |首次部署时，你可以设置是否将开发环境的数据同步至生产环境。 |\
   | | |\
   | |* **关闭**：仅同步开发环境中的数据表结构，不同步数据。 |\
   | |* **开启**：将开发环境中的数据表结构和数据完全同步到生产环境。 |\
   | | |\
   | |后续部署时，扣子编程仅同步开发环境的表结构变更，不同步具体数据。 |
   | | | \
   |生产环境变量 |在生产环境中为项目配置特定的环境变量，例如 API Key、数据库连接字符串、飞书文档地址等敏感信息，以免将这些信息硬编码在代码中导致安全风险。 |\
   | |展开环境变量的下拉列表，你可以新建环境变量、查看本次部署新增和变更的环境变量。关于环境变量的具体说明请参考[管理环境变量](/guides/environment_variables)。 |\
   | |:::tip 说明 |\
   | |部署时新建的变量，仅在生产环境生效，不会被添加至开发环境。 |\
   | |::: |
   | | | \
   |其他配置 |构建指令、端口等高级部署配置。这些配置不支持修改，只能查看。 |

6. 单击**开始部署**。
   扣子编程将自动进行部署相关操作。你可以在部署页面查看部署的进展和部署日志。部署过程可能需要几分钟，请耐心等待。部署过程中，你可以随时取消部署。
   **部署** > **总览**页面可查看每个部署版本的状态。
   ![Image=518x328](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/021ae8dd3ff446258119aa2821dc5f3e~tplv-goo7wpa0wc-image.image)

## 调用渠道 {#69c6d08f}
### 通过 API 调用 {#69c6d08f}
智能体部署成功后，系统为其**自动启用** API 渠道。该渠道默认开启且无法关闭，确保智能体始终可以通过 API 方式调用。具体调用方式，请参见[通过 API 调用智能体](/dev_how_to_guides/qeesmmos)。
### 通过 Web SDK 调用 {#69c6d08f}
如果你希望在网页中直接与智能体进行交互，需要**手动开启** Web SDK 渠道。该渠道支持按需随时关闭。

1. 在**部署**页面，单击**渠道**。
2. 在**渠道**页签，开启 **Web SDK**。
   ![Image=372x146](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/29844d2089f7494d9963a63d6532546f~tplv-goo7wpa0wc-image.image)
3. 开启 Web SDK 后，你可以按需选择嵌入方式（如 JavaScript、React 组件或 Iframe），将智能体嵌入到你的网页中。详情请参见[Web SDK（AI 编程）](/developer_guides/vibe_coding_websdk)。

## 分享智能体 {#3a7996d2}

* 将智能体的 API 请求示例分享给其他用户
   在智能体开发页面右上角单击**分享**按钮，即可获取智能体的 API 请求示例并分享给其他用户。你需要将创建的 API Token 提供给对方，对方调用时需将该 API Token 包含在请求头的`Authorization`参数中。更多信息，请参见[创建 API Token](/dev_how_to_guides/qeesmmos#ebedfe84)。
   ![Image=559x206](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/45cad38f9a304db4acee96b1025066ea~tplv-goo7wpa0wc-image.image)
* 将智能体的 Web SDK 分享链接分享给其他用户
   在智能体开发页面右上角单击**分享**按钮，然后在分享产物页签，单击**设为公开可见**，即可获取智能体的 Web SDK 分享链接并分享给其他用户，其他用户可通过该链接在 Web 页面可视化体验该智能体。
   :::
   ![Image=567x174](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/ac6577011b6a4f7f88ff5d166c1f23c6~tplv-goo7wpa0wc-image.image)

## 常见问题 {#9c8fe75e}

* [能调用历史部署版本的智能体或工作流吗？](/guides/vibe_coding_faq#550fcf6e)
* [重新部署后，之前的 API Token 还能继续使用吗？](/guides/vibe_coding_faq#570e9e90)
* [忘了 API Token 怎么办？](/guides/vibe_coding_faq#df52326f)
* [部署失败时如何修复？](/guides/vibe_coding_faq#89da6f6a)
* [首次部署和二次部署的数据库同步策略有什么不同？](/guides/vibe_coding_faq#2e9ac852)