更新 Agent 私有 Skill

可以透過該 API，更新目前 LoopAgent API Key 所屬 Agent 的私有 Skill。Skill ID 透過 multipart 表單欄位 skill_id 傳入，不出現在 URL 路徑中。

僅支援 LoopAgent，且只能更新目前 Agent API Key 所屬 Agent 名下的私有 Skill。
目標查詢按 skill_id + projectId + botId 限定，不屬於目前 Agent 的 Skill 會被拒絕。
檔案格式與建立 API 一致：僅接受 .skill、.zip，壓縮包最大 20 MiB。
更新只儲存 Skill 內容版本，但不會自動掛載 Skill、儲存 Agent 草稿版本或發布生產 Agent 版本。

請求方式

POST

調用地址

https://api.${endpoint}/v1/agent/skill/update

調用驗證

使用目標 LoopAgent 的 Agent Key，且該 Key 必須開啟版本管理權限。詳情請參閱 API 概述的驗證方式說明。

請求

請求範例

curl -X POST 'https://api.${endpoint}/v1/agent/skill/update' \ -H 'Authorization: Bearer ${API Key}' \ -F 'skill_id=skill-xxxx' \ -F 'file=@/path/to/refund-policy-v2.skill'

                      
                      curl -X POST 'https://api.${endpoint}/v1/agent/skill/update' \
  -H 'Authorization: Bearer ${API Key}' \
  -F 'skill_id=skill-xxxx' \
  -F 'file=@/path/to/refund-policy-v2.skill'

此代碼塊在浮窗中顯示

請求標頭

欄位	類型	說明
Authorization	Bearer ${API Key}	使用目標 LoopAgent 的 API Key 驗證，且該 Key 必須開啟版本管理權限。
Content-Type	multipart/form-data	以表單形式上傳技能包檔案。

請求參數（Form Data）

參數	類型	必填	說明
`skill_id`	String	是	要更新的 Agent 私有 Skill ID。
`file`	File	是	`.skill` 或 `.zip` 技能包。
`category_id`	String	否	更新後的分類 ID；可省略，省略時保持原分類。

伺服器端會比較目標 Skill 的目前檔案和元資料；完全一致時直接返回目前版本，不寫入物件儲存或 MongoDB，調用方也不需要傳冪等請求標頭。

回應

回應範例

{ "code": 0, "message": "OK", "data": { "skill_id": "skill-xxxx", "name": "refund_policy", "version": "1.0.2" } }

                      
                      {
  "code": 0,
  "message": "OK",
  "data": {
    "skill_id": "skill-xxxx",
    "name": "refund_policy",
    "version": "1.0.2"
  }
}

此代碼塊在浮窗中顯示

成功回應

欄位	類型	說明
skill_id	String	更新的 Skill ID，保持不變。
name	String	Skill 名稱。
version	String	更新後的 Skill 版本號。

失敗回應

欄位	類型	說明
code	Integer	錯誤碼。
message	String	錯誤詳情。

狀態碼

狀態碼	說明
200	成功
400	參數錯誤
401	未授權
403	權限不足
429	請求過於頻繁
500	伺服器錯誤