智能体管理模型

Agent 管理至少包含基本信息、类型、提示词、模型引用、工具/Skill 绑定、知识库引用、渠道策略、配额和发布状态。草稿可编辑，已发布版本供执行读取；修改草稿不应改变正在运行的 session。

自动注册需区分有效实现和历史方案：Feign 工具和 Nacos MCP 同步是当前重点；旧 AiAgentAutoRegistrationConfig 整段注释，不能作为运行中的自动注册入口。

真实接口与服务行为

AiAgentManagementController 的根路径是 /v1/agent，当前提供创建、分页、列表、按 ID/UID 查询、按类型查询、发布、下线、删除、模型配置和 Agent 配置读取等入口。创建时服务会生成 UID，写入当前用户，再保存 Agent 与模型关联；未指定模型时会寻找启用的默认 CHAT 模型，没有默认模型会直接失败。

更新并不是一次简单的单表 update。AiAgentManagementServiceImpl 会分别处理 memoryNodeId、toolIds、Agent 模型关联和 Dataset 关系，Dataset 关系在批量设置前会清理旧绑定并按列表顺序写入 priority。更新和删除后会使 chatbotAgentFactory 缓存失效，下一次执行才重新组装 Agent。

字段与运行时语义

AiAgentEntity 的 agentType 决定 dispatcher 路由；publish 控制是否出现在已发布列表；datasetIds、toolIds、subAgentIds、skillIds 使用 JSON 类型字段保存引用；systemPrompt、userPrompt、openingRemark 参与提示词；memoryNodeId 在未启用沙箱时代表 DocSpace 节点，启用沙箱时代表 FileRoom；enableWebSearch 为 null 时按兼容策略允许搜索。

修改场景	服务端必须检查
切换 agentType	是否有对应执行器和 graph，不能把 WORKFLOW 当作已支持类型
修改 toolIds	工具存在、租户可见、Schema 可解析、平台搜索是否被重复绑定
修改 datasetIds	Dataset 所属租户、关系启用状态和检索配置
修改 memoryNodeId	room/DocSpace ACL、相对路径和沙箱开关
发布/下线	运行中 session 的历史快照、异步任务和缓存失效

版本隔离与排障

发布后的 Agent 应在执行轨迹中记录 Agent 配置摘要、模型、toolset hash 和 Dataset/Skill 版本。草稿修改不会中断当前 LoopRuntime；恢复时如果工具权限、模型能力或图版本不兼容，应进入 RECOVERY_BLOCKED，而不是清空状态重跑。Agent 查不到先看租户和逻辑删除，工具不显示再看绑定和 Web Search 过滤，模型失败再看默认模型、用户模型和计费冻结。