歸檔 Agent - Qoder CN 系列

歸檔指定 Agent。歸檔後不再出現在預設列表中，但仍可通過 ID 訪問。

POST /api/v1/cloud/agents/{agent_id}/archive

歸檔指定的 Agent。歸檔後 Agent 不會出現在預設列表中，但仍可通過 ID 直接擷取。

要求標頭

頭部	必選	說明
`Authorization`	是	`Bearer <PAT>`

路徑參數

參數	類型	必選	說明
`agent_id`	string	是	Agent 唯一標識

請求體

無需請求體。

樣本請求

curl -X POST "https://api.qoder.com.cn/api/v1/cloud/agents/agent_019eXXXX.../archive" \
  -H "Authorization: Bearer $QODER_PAT"

樣本響應

HTTP 200 OK

{
  "type": "agent",
  "id": "agent_019eXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
  "name": "doc-test-agent-updated",
  "description": "用於 API 文檔測試",
  "model": "ultimate",
  "system": "你是更新後的文檔測試助手",
  "tools": [],
  "mcp_servers": [],
  "skills": [],
  "metadata": {},
  "multiagent": null,
  "version": 2,
  "archived_at": "2026-05-18T15:27:22.698411Z",
  "created_at": "2026-05-18T15:26:39.61669Z",
  "updated_at": "2026-05-18T15:27:22.698411Z"
}

響應欄位

返迴歸檔後的完整 Agent 對象。updated_at 欄位會更新為歸檔操作的時間。

欄位	類型	說明
`type`	string	固定值 `"agent"`
`id`	string	Agent 唯一標識
`name`	string	Agent 名稱
`description`	string	Agent 描述
`model`	string	模型標識
`system`	string	系統提示詞
`tools`	Agent tool 數組	工具配置列表
`mcp_servers`	MCP server 數組	MCP 伺服器配置
`skills`	Skill binding 數組	Skill 繫結資料行表
`metadata`	Metadata 對象	自訂中繼資料
`multiagent`	Multiagent \| null	Agents 配置，未設定時為 `null`
`version`	integer	目前的版本號
`archived_at`	string\|null	歸檔時間（ISO 8601），未歸檔時為 `null`
`created_at`	string	建立時間（ISO 8601）
`updated_at`	string	最後更新時間（ISO 8601），歸檔時重新整理

錯誤碼

HTTP	type	觸發條件
401	`authentication_error`	PAT 無效或到期
403	`permission_error`	無許可權歸檔此 Agent
404	`not_found_error`	指定 ID 的 Agent 不存在

注意事項

歸檔會保留 Agent 資料
歸檔後的 Agent 不會出現在 GET /api/v1/cloud/agents 的預設列表中
在 GET /api/v1/cloud/agents 傳 include_archived=true 可讓列表包含已歸檔 Agent
仍可通過 GET /api/v1/cloud/agents/{agent_id} 直接存取已歸檔的 Agent
歸檔操作是等冪的，重複歸檔不會報錯
歸檔不會遞增 Agent 的 version，也不會新增版本快照