部署智能体

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

使用限制

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

准备工作

在开始部署之前，请确保你已通过扣子编程开发智能体，且试运行通过。具体可参考开发智能体。

部署操作

1. 在扣子编程左侧导航栏选择项目管理，筛选带有 New 标签的智能体，单击目标项目。

2. 在 AI 编程开发界面的右上角，单击部署。

3. 确认部署渠道。
   智能体的可用渠道可以在 部署 > 渠道 页面配置，此处仅展示。

4. 填写部署配置。

   配置	说明
   部署版本	选择要部署的开发版本。
   部署域名	Agent API 的访问域名，默认由扣子分配，你也可以根据页面提示自行调整域名前缀。 如果此项目已部署上线，修改前缀后将立即生效，无需重新部署。Agent 的旧域名将失效，建议修改前后及时通知被分享过的用户。
   服务器资源	默认规格为 1C2G，2 个实例、每个实例 100 并发，可满足基础运行的需求。 说明 套餐限制：仅限个人高阶版及以上版本订阅套餐用户灵活调整部署的服务器资源。 部分订阅套餐的用户还可以根据项目的复杂度、规模、预期访问量，选择合适的服务器资源、实例数和单实例并发数。部署后也可以根据访问情况随时扩容。设置说明如下： CPU 和 内存：单个服务实例可使用的计算资源，包括 CPU 和内存。配置越高，应用能承载的任务越重，运行也更稳定。 实例数：表示应用在高流量情况下最多可启动的服务实例数量。平台会根据实际访问流量自动扩缩容：当请求量超过单个实例的并发承载能力时，会逐步增加实例来共同处理请求；当没有访问流量时，服务可缩容至 0 个实例，以减少资源占用和成本。 单实例并发：表示每个实例允许同时处理的最大请求数量。最大总并发通常可按 实例数 × 单实例并发 估算。 如何合理为项目设置服务器资源，可参考如何合理设置部署的服务器资源？

5. 确认更多配置。
   数据库、生产环境变量、构建指令、端口等高级部署配置，你可以展开更多配置，查看或修改配置详情。

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

6. 单击开始部署。
   扣子编程将自动进行部署相关操作。你可以在部署页面查看部署的进展和部署日志。部署过程可能需要几分钟，请耐心等待。部署过程中，你可以随时取消部署。
   部署 > 总览页面可查看每个部署版本的状态。
   

调用渠道

通过 API 调用

智能体部署成功后，系统为其自动启用 API 渠道。该渠道默认开启且无法关闭，确保智能体始终可以通过 API 方式调用。具体调用方式，请参见通过 API 调用智能体。

通过 Web SDK 调用

如果你希望在网页中直接与智能体进行交互，需要手动开启 Web SDK 渠道。该渠道支持按需随时关闭。

1. 在部署页面，单击渠道。
2. 在渠道页签，开启 Web SDK。
   
3. 开启 Web SDK 后，你可以按需选择嵌入方式（如 JavaScript、React 组件或 Iframe），将智能体嵌入到你的网页中。详情请参见Web SDK（AI 编程）。

分享智能体

• 将智能体的 API 请求示例分享给其他用户
  在智能体开发页面右上角单击分享按钮，即可获取智能体的 API 请求示例并分享给其他用户。你需要将创建的 API Token 提供给对方，对方调用时需将该 API Token 包含在请求头的Authorization参数中。更多信息，请参见创建 API Token。
  
• 将智能体的 Web SDK 分享链接分享给其他用户
  在智能体开发页面右上角单击分享按钮，然后在分享产物页签，单击设为公开可见，即可获取智能体的 Web SDK 分享链接并分享给其他用户，其他用户可通过该链接在 Web 页面可视化体验该智能体。
  :::
  

常见问题

• 能调用历史部署版本的智能体或工作流吗？
• 重新部署后，之前的 API Token 还能继续使用吗？
• 忘了 API Token 怎么办？
• 部署失败时如何修复？
• 首次部署和二次部署的数据库同步策略有什么不同？