Appearance
部署智能体
智能体需要先部署为生产运行版本。部署成功后，可通过 API/SDK 方式接入业务系统；再通过右上角的 发布 将智能体发布到当前账号可用的渠道，为使用者提供页面化的对话入口。部署前应完成多轮对话、工具调用和安全边界测试。
部署前验证
- 使用代表性问题验证正常回答、信息不足时的追问和多轮上下文。
- 检查技能、插件、模型和其他工具是否可用，权限范围是否符合预期。
- 验证违规请求、隐私信息、工具失败和超时等异常场景。
- 确认生产环境变量中已经配置外部服务所需的地址与凭证。
- 选择完成回归测试的智能体版本。
配置部署
- 单击项目右上角的 部署。
- 在 总览 中选择已经验证的部署版本。
- 设置 CPU 和内存规格。
- 智能体使用数据库时，选择需要同步到生产环境的数据表。
- 补齐生产环境变量，并按需同步对象存储。
- 单击 开始部署，等待打包、构建和部署完成。
图 1：智能体项目除“总览、日志、分析、用量管理”外，还提供 Trace 入口。
部署后验证
- 确认页面显示 部署成功，并且打包、构建和部署三个阶段均已完成。
- 在生产运行入口重新执行部署前的核心测试用例。
- 打开 日志，确认模型调用和工具调用没有持续错误。
- 打开 Trace，检查一次请求经过的模型、工具和执行阶段，以及整体耗时和首次响应耗时。
- 确认部署版本与本次验收版本一致。
通过 API/SDK 调用智能体
部署成功页提供生产 API、鉴权方式、参数说明和调用示例，可用于将智能体接入网页、业务系统或其他服务。
- 在 API 请求示例及接口说明 中复制生产接口地址。当前接口以
POST /stream_run形式提供流式运行能力。 - 单击 API Token 查看或生成鉴权凭证，请求时通过
Authorization: Bearer <YOUR_TOKEN>传递。 - 在 输入参数配置 和 返回参数说明 中核对请求字段与响应结构。
- 根据接入技术栈选择 cURL、Python 或 Node.js 调用示例，也可以复制示例后再替换输入内容。
- 使用生产 Token 和代表性问题完成一次真实调用，确认流式响应、工具调用及异常处理符合预期。
图 2：智能体部署成功后，可查看生产接口、API Token、参数说明以及 cURL、Python、Node.js 调用示例。
凭证安全
不要在文档、截图、浏览器前端代码或公开仓库中保存真实 API Token。修改智能体后需要重新部署，并再次验证生产调用。
发布智能体项目
生产验证通过后，单击项目右上角的 发布：
- 核对发布来源是否为刚刚验收的部署版本。
- 填写发布版本和发布描述，并按需上传展示截图。
- 选择当前页面显示为“可发布”的 企业项目 或 模板商店。
- 单击页面右上角的 发布。
- 发布后在发布历史中核对渠道、状态、版本和发布时间。
图 3：智能体发布页面，包括发布来源、版本信息、展示截图、发布渠道和发布历史。
发布成功后，使用者通过发布渠道提供的页面与智能体对话，不需要自行编写 SDK 调用代码。
部署与发布的区别
- 部署：生成生产运行服务，并提供 API Token、接口地址和 SDK 调用示例，适合业务系统集成。
- 发布：将已部署的智能体发布到指定渠道，为最终使用者提供页面化的智能体调用入口。