软归档：智能体保留但默认不出现在列表中，且不可用于新建会话；已有会话不受影响。
前提
已完成 Endpoint 与鉴权配置，详见API 总览与认证。
接口
POST /agents/{agent_id}/archive
语义
软归档：响应返回完整 agent 对象，archived_at 字段被填入归档时间。归档后默认不出现在列表中（除非 include_archived=true），不可用于新建会话，已有会话不受影响。
请求示例
响应说明
响应为 Agent 对象，结构同创建 Agent响应，唯一差异是 archived_at 字段被填入归档时间（不再为 null）。字段如下：
响应字段
字段 | 类型 | 说明 |
|---|---|---|
| string | 智能体 ID |
| string | 固定为 |
| int | 当前版本号（归档不改变版本） |
| string | 智能体名称、用途说明、系统提示词 |
| object / array | 模型、工具包、MCP 引用、技能、业务元数据 |
| string | 归档时间，ISO 8601；归档接口返回的对象中该字段一定非空 |
| string | 创建/最近更新时间 |
| string | 所属工作空间 ID |
| string | 本次请求的唯一标识 |