本文介绍如何在 DataBuddy 中发布和部署 Agent，覆盖部署来源、部署流程、运行状态监控、版本管理与下载。
概述
Agent 在平台上以 App 形态 部署运行：代码、依赖、运行状态、版本和权限统一由 App 管理。当前支持从 Studio 部署，从 Git 部署后续版本支持。
部署完成后，Agent 即可通过 ChatUI、API 或被其他 Agent 调用。
前提条件
已创建 Agent，详见 创建与管理 Agent。
高代码 Agent 的代码已在 Studio 中完成开发与基本调试。
关联的 MLflow 实验有
CAN_EDIT 权限。平台基础模型已在白名单中。
使用限制
限制项 | 说明 |
部署来源 | 当前仅支持从 Studio 部署；从 Git 部署后续版本支持 |
部署文件管理 | 支持点击下载 Agent 代码包 |
平台基础模型 | 通过白名单开通，可统计用量 |
计费 | 当前暂不计费，正式商用上线后另行通知 |
操作步骤
步骤 1：在 Studio 中开发、调整代码
1. 进入 Agent 概览页，点击 代码开发 模块快捷入口，或顶部导航 代码开发 Tab。
2. Studio 自动打开 Agent 关联的代码模板（OpenAI / LangGraph）。
3. 在 Studio 中：
编辑代码、调试。
修改环境变量。
通过 Studio 的 AI 辅助能力（代码生成、工具发现等）辅助开发。
提示
代码同步规则：
Studio 中的代码会同步到 COS。
在 Agent 详情页点击下载按钮时，平台会调用 Studio 接口拉取最新代码 打包下载。
部署始终以 Studio 中最新代码 为准；用户在本地修改后回传，应同步到 Studio。
步骤 2：触发部署
平台执行以下动作：
1. 从 Studio 拉取 Agent 最新代码。
2. 安装代码依赖、应用环境变量。
3. 启动 Agent 运行实例。
4. 自动注册调用端点（Endpoint），可被 ChatUI、API 等调用。
部署进度通过进度条实时展示。
注意
部署过程中 Agent 不可对外提供服务。如需保证可用性，建议错峰部署或提前通知用户。
步骤 3：在概览页观察运行状态
部署完成后回到 Agent 概览页，可查看：
指标 | 说明 |
今日调用 | 当日 0:00 至当前的总请求次数（含成功 / 失败），点击跳转到追踪评测 |
成功率 | 成功响应数 / 总请求数 × 100%（成功 = HTTP 2xx 且正常返回），点击跳转到运行监控 |
平均延迟 | 成功请求的端到端响应时间算术平均值，点击跳转到运行监控 |
当前版本 | 线上运行的部署版本号，点击跳转到部署状态 |
今日 Token 消耗 | 当日所有 Trace 的 Token 消耗之和，按千分位（k / m / b）展示 |
近 30 日 Token 消耗 | 近 30 日所有 Trace 的 Token 消耗之和，按千分位展示 |
步骤 4：测试部署后的 Agent
通过以下任一方式测试：
方式 | 说明 |
ChatUI 预览体验 | Agent 概览页右侧直接对话 |
API 调用 | 通过 Endpoint URL（在 Agent 概览页 info 浮层中查看 / 复制）发起 HTTP 请求 |
步骤 5：必要时下载代码包
在 Agent 概览页或代码开发模块点击 下载 ，平台会从 Studio 拉取最新代码并打包为 zip 文件下载到本地。
状态流转
Agent 在生命周期中存在以下状态：
当前状态 | 可执行操作 | 下一状态 |
已停止 | 启动 | 启动中 |
启动中 | — | 部署中（仅首次创建完智能体后）/ 运行中 |
部署中 | 部署 | 运行中（成功）/ 上一状态（失败） |
运行中 | 停止 / 部署 | 停止中 / 部署中 |
停止中 | — | 已停止 |
出错 | 启动 / 停止 | 启动中 / 停止中 |
不同状态下页面显示对应的运行视图与可执行操作；当 Agent 处于「出错」状态时，点击错误信息会展示具体的错误原因。
部署进度展示
部署中页面会展示进度条，分阶段标注：
拉取代码
安装依赖
启动实例
注册端点
每个阶段失败时，会回退到部署前的上一状态，并保留错误信息便于排查。
权限管理
通过 Agent 详情页右上角配置部署相关权限：
权限点 | 含义 |
可使用 | 可对话调用、可查看 Trace |
可管理 | 可触发部署 / 启动 / 停止、可下载代码、可修改配置 |
授权范围覆盖整个主账号下跨工作空间 的成员。
版本管理
Agent 部署后，每次重新部署会生成一个新的版本：
概览页「当前版本」展示线上运行版本号。
点击进入部署状态页可查看历史版本列表。
提示
当前版本管理主要用来追溯「当前线上运行的是哪一次部署」。完整的版本回滚、多版本灰度等能力以后续版本上线时间为准。
运行监控
进入 Agent 详情页 部署运维 Tab，可查看：
模块 | 说明 |
运行监控 | 调用量趋势、成功率趋势、平均延迟趋势 |
部署状态 | 当前部署进度、历史部署记录 |
调用方式
部署成功后，Agent 提供以下调用方式：
方式 | 适用场景 | 说明 |
ChatUI | 业务用户直接对话 | 平台预置的前端模板，开发者可二次开发 |
HTTP API | 集成到自有应用 | 通过 Endpoint URL + 鉴权调用 |
模型服务节点 | 在 Agent 之间互相调用 / 在 SQL Editor 中调用 | 通过 MCP 协议调用，需对应配置 |
常见问题
Q：部署失败如何排查？
A：常见原因有：① 代码依赖安装失败（查看部署进度条上的错误提示）；② MLflow 实验权限不足（确认账号对实验有
CAN_EDIT 权限）；③ 平台基础模型未开通白名单（联系管理员）；④ 调用的 MCP 服务不可用（在 MCP 概述 列表确认服务状态）。Q：如何回滚到上一个版本？
A：当前主要支持「重新部署」。如需回滚，建议：① 在 Studio 中通过 Git 切换到对应版本的代码；② 或下载之前版本的代码包，本地修改后回传 Studio 再部署。完整版本管理与回滚能力以后续上线时间为准。
Q：部署时是否支持灰度？
A：当前暂不支持灰度发布。建议在测试阶段使用一个独立的「测试 Agent」，验证完成后再部署到生产 Agent。后续版本会引入多版本与灰度能力。
Q：Agent 处于「运行中」状态但调用没有响应怎么办？
A：先在概览页查看「今日调用」和「成功率」是否异常下降；再到 Trace 列表查看最近的 Trace 状态，定位具体失败原因（多数是工具调用失败、模型不可用）。如果状态指标异常，建议先停止 Agent 再重新启动。
Q：从 Git 部署什么时候支持？
A：当前仅支持 Studio 部署。Git 部署在后续版本中提供，具体时间以平台 Roadmap 公告为准。
相关文档
创建与管理 Agent
