智能体管理 ★
一句话：智能体 = 人设 + 模型 + 知识库 + 工具的一份配置包；本页管全租户智能体的清单、版本与状态——草稿随便改，已发布的不可就地修改、只能派生新版本。
功能在哪
- 菜单路径：AI → AI 助手 → 智能体管理
- 地址栏路由：列表
/ai/agent/def；编辑器/agent-def/editor?id=<智能体id>（只读态加&mode=view） - 主要权限：
agent:def:query（新增 / 编辑 / 删除等按钮另受对应写权限控制）
界面认识
| 区域 | 作用 | 常用操作 |
|---|---|---|
| 查询区 | 编码 / 名称 / 状态（草稿 / 已发布 / 已停用） | 「搜索」「重置」 |
| 列表 | 勾选 / 序号 / 编码 / 名称 / 版本 / 状态 / 描述 / 创建时间 / 操作 | 「新增」「批量删除（勾选 N 后亮起）」 |
行内操作随状态变化（前三个恒为「查看 / 编辑 / 复制」，其余收进「更多」）：
| 状态 | 行内操作 | 「更多」里 |
|---|---|---|
| 草稿 | 查看 / 编辑 / 复制 / 更多 | 发布、删除 |
| 已发布 | 查看 / 编辑 / 复制 / 停用 | — |
| 已停用 | 查看 / 编辑 / 复制 / 更多 | 重新发布、删除 |
内置单例「默认平台助手」不在本列表
平台内置的智能体（编码是代码常量）由系统按编码单独取用、直接在智能助手里对话，不进入本列表——所以列表里看到的都是租户自建的智能体。
编辑器（智能体设计器）：左配置、右挂载
点草稿行的「编辑」或「新增」进入编辑器，两栏布局：
| 卡片 | 字段与要点 |
|---|---|
| 基本信息 | 名称；编码创建后不可修改，提示原话：「编码不可修改（改编码等于换一个 Agent）；要改已发布 Agent 请基于它派生一个新版本。」 |
| 人设（系统提示词） | 8000 字上限；定义智能体的身份、职责、语气与边界，是对话质量的根 |
| 描述 | 列表「描述」列与选择器里展示的简介 |
| 模型 | 下拉选一个启用中的模型；留空 = 用平台动态默认模型（不可用时自动切换下一个） |
| 知识库 | 绑定后聊天会从库中检索并把命中片段作为「参考资料」注入回答；不绑定 = 不检索（仅凭人设作答） |
| 工具（只读） | 多选只读工具；绑定后聊天会先「思考 → 调工具查现状 → 再思考」直到给出结论，而非凭空作答。仅可绑定只读工具（写操作须走 Plan 确认或工作流 tool 节点）；留空 = 直问直答。已被管理员停用的工具在候选里是灰的、挑不动 |
页头两个提交按钮：「保存草稿」（状态保持 / 变为草稿）与「保存并发布」（直接可用）。
常用操作
发布 / 停用：状态三态流转
草稿「更多 → 发布」后进入已发布、可被选用；已发布行点「停用」变为已停用（对话入口下架）；已停用「更多 → 重新发布」恢复。删除只开放给草稿与已停用。
编辑已发布智能体：不就地改，派生新版本
点已发布行的「编辑」不会进编辑器，而是弹确认：
「制度问答助手」当前是已发布状态，不可就地修改。将基于它派生一个新草稿版本（同编码、版本 v2），原版本保持不变。确认继续？
点「确定」后带着新草稿进编辑器；原版本继续服役，新草稿发布后才接替。点「取消」什么都不发生。
复制：整套配置搬成一个独立新草稿
行内「复制」弹窗，信息条原话：「将复制成一个独立的新智能体（草稿）：人设、模型、知识库、工具配置整份搬过来，编码与名称需另起。」
「源」只读展示来源与版本；新编码 / 新名称已预填 _copy / （副本） 后缀，改完点「确定」得到一个新草稿，与原智能体再无联动。
查看：只读态过一遍配置
行内「查看」以只读模式打开编辑器（地址加 mode=view），用于交接与排查「这个智能体到底绑了什么」。
视角对照
| 视角 | 看到什么 |
|---|---|
租户管理员 docadmin | 全租户智能体的增删改与发布 |
业务角色（如 salesman01） | 角色未授 agent:def:query 时看不到本菜单，他们只在智能助手里使用已发布的智能体；演示环境为场景教程 4给 salesman / doc_sales 补了这条授权，故这两个账号能看到本菜单但只有查看权限 |
进阶
- 「版本」列是该行智能体的版本号：每次派生 +1，列表按行展示，老版本不会被新草稿覆盖；
- 工具候选池来自工具管理（内置 + 自定义），且只放只读工具进来；写能力要靠流程编排里的工具节点；
- 人设写得越具体（身份、职责、语气、边界四要素齐），对话越稳；模型留空适合「跟着平台默认走」的通用助手；
- 编码是智能体的身份证：外部引用（工作流、会话）认编码 + 版本，所以编码不可改、改配置靠派生。
常见问题
Q：为什么列表里没有「默认平台助手」？ A：内置单例按编码常量单独取用、不进列表；它在智能助手里直接可用。
Q：点已发布智能体的「编辑」为什么弹确认而不是进编辑器？ A：已发布不可就地修改，确认后会派生一个同编码的新草稿版本，原版本保持不变（见派生确认一节）。
Q：编码能改吗？ A：不能。编码创建后锁定（改编码等于换一个智能体）；要「改名换姓」请用复制。
Q：工具列候选里为什么有灰选项？ A：该工具已被管理员在工具管理里停用，候选里保留展示但挑不动。
Q：批量删除能删已发布的吗？ A：删除只针对草稿与已停用；已发布的先「停用」再删。
相关页面
- 工具管理：智能体工具候选池的维护处；
- 用量看板：智能体对话消耗的 token 与费用台账；
- 助手配置：AI 助手总开关与用量配额；
- 模型配置：编辑器「模型」下拉的数据来源；
- 让 AI 助手安全读写业务数据：绑只读工具的智能体如何被业务数据问答消费。