本文介绍如何在 DataBuddy 中创建并管理 Agent，覆盖高代码开发创建方式，以及 Agent 的状态流转、权限管理和列表过滤。
概述
Agent 模块当前提供创建方式：
高代码开发 Agent ：基于 OpenAI / LangChain·LangGraph 等框架的代码模板，开发者通过 Studio 编辑代码并部署。
所有 Agent 创建完成后都会进入「我的智能体」列表，并以 App 形态部署运行。
前提条件
在开始创建 Agent 前，请确保满足以下条件：
已开通 DataBuddy 服务并完成空间初始化。
当前账号在目标工作空间中拥有 Agent 管理权限 （详见 成员与权限管理）。
已准备好 Agent 所需的 MLflow 实验（GenAI 应用程序和 Agent 类型，可在创建过程中即时新建）。
如需调用 Catalog 中的资产（数据表等），需具备对应的 Catalog 访问权限。
操作步骤
步骤 1：进入 Agent 列表
1. 登录 DataBuddy 控制台。
2. 点击某个工作空间进入。
3. 在左侧导航栏选择智能体开发 。
步骤 2：选择搭建方式
根据您的使用场景选择对应卡片：
卡片 | 进入后流程 |
代码开发 Agent （OpenAI 框架） | 跳转到 App 安装界面，选择 OpenAI 模板创建 |
代码开发 Agent （LangGraph 框架） | 跳转到 App 安装界面，选择 LangGraph 模板创建 |
步骤 3：填写创建表单
不同搭建方式的表单字段不同， 按照界面提示输入相关信息。
步骤 4：保存并跳转到 Agent 概览
创建成功后会自动跳转到 Agent 概览页 ，您可以在概览页：
查看 Agent 身份信息（名称、类型、APPID）。
查看运行状态（已停止、启动中、部署中、运行中、出错）。
通过右侧预览体验窗口（ChatUI）直接对话。
跳转到 代码开发 / 部署运维 / 追踪评测 / 智能调优 等子模块。
创建参数
高代码开发 Agent
入口：在 Agent 列表点击「高代码开发 Agent」卡片，跳转到 App 安装界面。
参数 | 说明 | 是否必填 | 默认值 | 取值范围 |
智能体名称 | 智能体唯一标识 | 是 | - | 大小写英文字母、数字、 -，最长 30 字符 |
MLflow 实验 | Agent 关联的 GenAI 实验，承载 Trace、评估等数据 | 是 | - | 当前用户具备 CAN_MANAGE 权限的 GenAI&Agent 实验；可在选择器中即时新建 |
智能体描述 | 描述智能体的作用 | 否 | - | 500字以内 |
说明：
即时新建 MLflow 实验：在实验下拉中单击创建，弹窗输入实验名称（最长 50 字），创建完成后自动选中。如未指定项目位置，实验默认存放在当前用户的个人主目录下。
创建完成后进入 Studio 中的 Agent 代码模板，可直接编辑代码、调试、部署。
我的智能体列表
列表展示当前用户具备使用、管理权限的智能体（同一主账号下跨工作空间）：
字段 | 说明 |
Agent 名称 | 创建时填写 |
Agent 类型 | 自定义代码 Agent |
Agent 描述 | 创建时填写的描述 |
Owner | Agent 所有者 |
调用端点 | Agent 的端点名称，App 类型 Agent 即为 App 名称 |
最近更新 | 最近一次更新时间，按从新到旧排序，可切换升序 / 降序 |
状态流转
Agent 在生命周期中存在以下状态：
当前状态 | 可执行操作 | 下一状态 |
已停止 | 启动 | 启动中 |
启动中 | — | 部署中（首次创建）/ 运行中 |
部署中 | 部署 | 运行中（成功）/ 上一状态（失败） |
运行中 | 停止 / 部署 | 停止中 / 部署中 |
停止中 | — | 已停止 |
出错 | 启动 / 停止 | 启动中 / 停止中 |
说明：
首次创建完 Agent 后，启动时会先进入「部署中」完成代码部署，再进入「运行中」。后续每次修改代码后通过单击部署按钮重新部署即可。
不同状态下页面会有相应的运行显示和部署进度条，便于您直观确认当前进度。
权限管理
Agent 平台沿用 DataBuddy 通用的权限管理：在 Agent 详情页右上角配置权限。
权限点 | 说明 |
可使用 | 可对话、可查看 Trace |
可管理 | 可修改、删除、部署、配置权限 |
授权范围覆盖整个主账号下跨工作空间 的成员。
说明：
创建的 Agent 不会出现在工作空间的资产列表中 ，但会出现在全局搜索结果 和最近访问 中。
Agent 不出现在收藏夹 中。
修改与删除
修改 ：进入 Agent 概览页，通过左侧导航跳转到对应子模块（代码开发、工具配置、智能调优）即可修改。
重命名 ：在概览页 info 浮层中编辑名称。
删除 ：在 Agent 列表行操作中删除（删除前会有二次确认）。
警告：
删除 Agent 不可恢复，建议在概览中先关闭 Agent、确认无线上调用后再执行删除。
常见问题
Q：为什么我创建的 Agent 长时间停留在「部署中」？
A：常见原因有三种：① 关联的 MLflow 实验权限不足；② 代码模板中的依赖包安装失败；③ 平台基础模型白名单未开通。建议查看部署进度条上的错误提示，或联系管理员确认白名单。
