智能体管理：创建、调试与上线
「智能体管理」是智能体从想法到上线的唯一入口。列表页管理所有智能体卡片；单击卡片进入智能体工作台，一个页面覆盖智能体的完整旅程：创建（填写配置）→ 构建（人设/技能/知识）→ 调试（对话试效果）→ 发布版本 → 部署上线（运行）→ 分析（用量与质量）。已上线的智能体可以继续修改配置、发布并升级或回滚。
前提条件
- 已登录控制台，拥有智能体的创建权限（系统管理员、平台管理员或运维人员）
- 已规划好智能体的：名称、引擎类型（Hermes / OpenClaw / Dify / Claude Code）、人设描述、要装的技能
创建智能体
登录 VeyraOS 控制台，在左侧导航栏单击智能体管理。
进入智能体列表页，顶部平铺三张创建路径卡片。
单击自定义创建卡片。
在创建表单中填写：
- 基本信息：名称、头像、引擎类型（按类别分组选择——通用智能体引擎（Hermes / OpenClaw）、低码编排引擎（Dify）、编码智能引擎（Claude Code））、描述、开场白与推荐问题。头像支持 AI 生成或本地上传，两种方式在创建与编辑时都可用；单击 AI 生成按名称与描述生成画面体现该智能体职能形象的头像（如客服智能体呈现客服形象），未设置头像时展示默认机器人头像。开场白是用户进入对话页时看到的欢迎语（支持多行文本）；推荐问题最多 3 条，在对话页以卡片形式展示，用户单击即可发送。开场白与推荐问题均可留空，留空时对话页不展示推荐问题
- 模型配置：选择模型组（从模型管理中已注册的模型中选择）
人设、技能、MCP 服务与知识库在创建后于工作台「构建」页签配置。
单击保存，自动进入智能体工作台。
创建完成后系统会自动部署好调试实例，可直接在工作台「调试」页签试效果；此时智能体尚未上线，终端用户看不到它。
智能体工作台
工作台由头部信息卡与七个页签组成。头部展示头像、名称、状态、当前版本、未发布修改标记与描述，名称旁的编辑按钮可修改名称、头像（支持 AI 生成或上传）、描述、开场白、推荐问题与模型配置；右侧提供调试 / 发布 / 部署快捷按钮（单击直达对应页签），其后是红色的删除按钮；下方配置行展示引擎类型（单击切换引擎可更换）与模型组、创建人、最近更新时间。
切换引擎
更换引擎类型不影响已发布版本与运行中实例；切换后需重新配置并发布，运行中的实例按原版本继续运行。
删除智能体
单击头部红色的删除按钮发起删除：
- 无实例：弹窗确认后删除，智能体的配置与版本记录将无法恢复。
- 已有实例：弹窗会列出将一并删除的实例清单（实例过多时仅展示前若干个），并明确提示实例数据（含归档）将一并清除、不可恢复；确认后智能体与其全部实例一并删除。
- 若部分实例删除失败，弹窗会提示失败清单，其余实例已删除，可重试删除或先到「部署」页签手动处理对应实例。
概览
一屏掌握智能体全貌：
- 指标卡：已启用技能数、知识库数、MCP 服务数、调用量
- 生命周期：创建 → 配置 → 调试 → 评测 → 发布 → 运行 六步进度
- 当前版本信息：版本号、发布状态、发布说明、发布时间
构建
左侧是按引擎类型组织的配置树，单击树节点在右侧编辑对应配置：
- Hermes / OpenClaw：人设 / 提示词 / 技能 / MCP 服务 / 知识库 / 记忆 / 模型 / 运行配置
- Dify：工作流编排 / 数据集 / 工具插件 / 变量 / 模型 / 运行配置
- Claude Code：代码仓库 / 技能 / MCP 服务 / 模型 / 运行配置
编辑人设或提示词后若未保存，切换到其他配置项或离开工作台时会提示选择保存并继续 / 不保存继续 / 取消，避免辛苦填写的内容意外丢失。
常用面板说明：
- 人设：Markdown 源码编辑（SOUL.md），支持模板 / 样例 / AI 生成（AI 生成内容逐字流式展示，可随时重新生成覆盖）
- 提示词：上半部分人设内容随「人设」配置自动更新，下半部分工程提示词可直接编辑（Markdown 编辑器默认展示源码，可随时切换预览）
- 技能 / MCP 服务 / 知识库：绑定与管理，含安装、开关等操作。MCP 服务目录分为系统预置（平台提供，所有用户均可见、可接入）与本组接入（本用户组自行接入的服务，仅本组可见）；部分系统预置服务为系统内置（如知识库检索
kb_retrieval），由平台按绑定关系自动挂载，普通用户在目录中不可见，也不可手动绑定/解绑。绑定后需重新部署或应用配置生效。 - 知识库检索设置：在「知识库」面板可配置智能体级的检索参数（返回数量 TopK、相似度阈值、检索模式、重排序开关），保存后自动同步到运行中的实例；未绑定知识库时也可预存，绑定后生效。
- 模型：查看与更换绑定的模型组
最低门槛
基本信息 + 模型 + 人设配好就能开始调试；技能 / MCP / 知识库都可以先跑起来再补。
调试
- 调试实例在创建智能体时已自动部署（共享运行、常驻），面板状态条显示「调试实例运行中」即可直接对话；存量定义没有调试实例时可单击启动调试，一键完成创建并部署；实例未就绪时可单击部署重新拉起。
- 直接在对话框输入消息试效果；智能体的工具调用轨迹会逐步展示。
- 切到「构建」页签修改配置后，回到「调试」：此时同步调试按钮带红点提示（有修改未同步）；单击后改动生效，其中涉及模型组或 MCP 服务的变更会让调试实例自动重启（稍候片刻再继续对话），其余改动免重启立即生效。
- 调试实例常驻运行，无需手动暂停释放资源。
评测
评测中心用于系统化评测智能体的回答质量与任务完成率。当前页面为预览形态（含准确率、事实一致性等指标与测试集管理），评测功能上线前数据仅供演示。
版本
发布并查看版本历史：
单击发布，填写版本说明（系统会根据未发布的改动自动预填，如「人设已更新」「技能已更新」，可自行修改），提交后一步完成发布与上线：
- 无生产实例：自动创建并部署首个实例。首次发布时可在弹窗内展开「实例配置」设置运行参数（资源池 / 运行模式「共享运行或独立运行」/ 云浏览器 / 命令沙箱，默认折叠，一般无需改动），已有生产实例后发布为自动升级，不涉及运行配置
- 已有生产实例：自动将改动同步到生产实例（人设/技能/模型变更热更新，无需重启）
- 单个实例升级失败不阻断其他实例；失败的实例可稍后在「部署」页签手动升级
无未发布的修改时「发布」按钮不可用；版本发布后内容固定，后续改动可再次发布。智能体的各项配置（含人设、技能、模型、开场白与推荐问题）都在发布后才对终端用户生效，编辑保存的只是草稿。
版本管理：当前版本、发布状态、最近发布说明，下方时间轴依次展示所有历史版本（当前版本高亮并带「当前」标记）。
渠道
以长条卡片纵向展示各渠道的接入状态：HTTP API 与 SDK 并排置顶，Web 网页 紧随其后，再下方是企业微信自建应用、企业微信智能机器人、飞书机器人、钉钉机器人；接入后卡片上会显示回调地址并可一键复制。IM 渠道单击配置直接打开该渠道的配置表单；HTTP API 单击生成直接创建 API Key（完整 Key 仅展示一次，请注意保存）；Web 网页渠道默认开启，发布后即可拷贝链接分享或在终端门户跳转体验；单击查看文档打开 SDK 接入文档。
部署
一个智能体只对应一个生产实例。本页展示该实例的单实例部署配置卡，部署成功（状态「运行中」）后智能体正式上线，终端门户中即可看到并可对话：
- 指标卡：引擎、资源池、实例数量、运行状态
- 部署配置卡：展示生产实例的部署状态（引擎 / 资源池 / 运行状态 / 当前版本）与运行配置摘要（运行模式「共享运行或独立运行」/ 云浏览器 / 命令沙箱），单击编辑运行配置可修改运行参数（保存后重启生效）
- 实例操作：详情（进入实例深度运维页）、日志、暂停 / 恢复、销毁，以及更多操作中的重启 / 升级版本 / 回滚
- 未部署时显示引导，单击去发布直达「版本」页签发布首个版本
分析
运营视角的用量与质量：活跃会话、调用量、成功率、Token 消耗四项指标（活跃会话按近 30 天去重会话数统计）；失败原因分析即将上线。
修改已上线的智能体
- 在工作台「构建」页签编辑人设、技能等配置，在「调试」页签验证效果。
- 验证通过后，在「版本」页签单击发布，填写新的版本说明（如"v1.1：增加天气技能"）。
- 完成部署后生产实例自动升级到新版本。
- 新版本不符合预期时，在「部署」页签该实例的更多操作中单击回滚切回上一个版本。
后续步骤
- 实例深度运维 — 查看 Pod 与日志、接入 IM 渠道、排查异常
- 管理模型与 API Key — 维护模型列表与调用凭证