RAG Agent 实例的全生命周期管理 API
RAG Agent 是知识检索（
先用管理 API 创建并发布 Agent，获取
所有端点均为 POST + JSON body，路径前缀
Agent 分为两种场景（
两种场景的
写操作（create / update / deploy / delete / copy）需要对应的知识库权限，由业务空间成员管理中的角色决定：
拥有
knowledge/search）和知识问答（knowledge/chat）的运行主体。Agent 管理 API 支持通过代码完成 Agent 的创建、配置、发布、查询和删除，无需前往控制台手动操作。
和运行时 API 的关系
先用管理 API 创建并发布 Agent，获取 agent_id 后，再用运行时 API 发起检索或问答。
生命周期
agent_config 仅支持修改 beta 草稿版本。已发布版本仅能修改 agent_version_desc 字段；如需更新配置，须先通过 update 接口更新草稿，再通过 deploy 接口发布新版本。删除为软删除，接口幂等：重复删除不会报错。API 列表
所有端点均为 POST + JSON body，路径前缀 /api/v1/indices/rag/agent/。
| 操作 | 端点 | 说明 |
|---|---|---|
| 创建 Agent | POST /agent/create | 创建新 Agent，初始状态 draft |
| 更新 Agent | POST /agent/update | 更新名称、描述或草稿配置 |
| 发布 Agent | POST /agent/deploy | 将 beta 草稿发布为新版本 |
| 删除 Agent | POST /agent/delete | 软删除，接口幂等 |
| 查询列表 | POST /agent/list | 分页查询当前租户下的 Agent |
| 查询详情 | POST /agent/get | 获取 Agent 完整信息，支持指定版本 |
| 复制 Agent | POST /agent/copy | 复制已有 Agent，生成新的草稿 |
场景
Agent 分为两种场景（agent_scene）：
| 场景 | 值 | 用途 | 对应运行时 API |
|---|---|---|---|
| 知识问答 | chat | 配置问答模型、引用、拒答等 | knowledge/chat |
| 知识检索 | search | 配置多库路由、混排、检索参数等 | knowledge/search |
agent_config 结构不同，详见各接口文档。
对外使用
chat（内部映射为 general）；search 内外一致。权限要求
写操作（create / update / deploy / delete / copy）需要对应的知识库权限，由业务空间成员管理中的角色决定：
| 操作 | 需要的权限 |
|---|---|
| create | 知识库-创建 |
| update | 知识库-修改 |
| deploy | 知识库-修改 |
| delete | 知识库-删除 |
| copy | 知识库-创建 |
知识库-操作(FullAccess)权限可执行以上所有操作。调用返回 403 时，说明当前用户缺少对应权限，请联系业务空间管理员调整角色。读操作（list / get）仅需 API Key。