RAG Agent 实例的全生命周期管理 API
RAG Agent 是知识检索（
所有端点均为 POST + JSON body，路径前缀
Agent 分为两种场景（
两种场景的
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/app/。
| 操作 | 端点 | 说明 |
|---|---|---|
| 创建 Agent | POST /app/create | 创建新 Agent，初始状态 draft |
| 更新 Agent | POST /app/update | 更新名称、描述或草稿配置 |
| 发布 Agent | POST /app/deploy | 将 beta 草稿发布为新版本 |
| 删除 Agent | POST /app/delete | 软删除，接口幂等 |
| 查询列表 | POST /app/list | 分页查询当前租户下的 Agent |
| 查询详情 | POST /app/get | 获取 Agent 完整信息，支持指定版本 |
| 复制 Agent | POST /app/copy | 复制已有 Agent，生成新的草稿 |
场景
Agent 分为两种场景（agent_scene）：
| 场景 | 值 | 用途 | 对应运行时 API |
|---|---|---|---|
| 知识问答 | chat | 配置问答模型、引用、拒答等 | knowledge/chat |
| 知识检索 | search | 配置多库路由、混排、检索参数等 | knowledge/search |
agent_config 结构不同，详见各接口文档。
对外使用
chat（内部映射为 general）；search 内外一致。