建立 Agent 私有 Skill

可以透過該 API，建立目前 Agent API Key 所屬 LoopAgent 的私有 Skill。

僅支援 LoopAgent；普通 Agent、Flow Agent 和 Workflow 不支援。
僅建立目前 Agent API Key 所屬 Agent 的私有 Skill。
僅接受 .skill、.zip；壓縮包最大 20 MiB，最多 200 個有效檔案，單檔解壓後最大 5 MiB，整包解壓後最大 64 MiB。
包內根目錄或唯一頂層目錄下必須包含 SKILL.md，且 frontmatter 必須包含 name。
建立不會自動把 Skill 掛載到 Agent，也不會自動儲存或發布 Agent 版本。

請求方式

POST

調用地址

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

調用驗證

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

請求

請求範例

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

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

此代碼塊在浮窗中顯示

請求標頭

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

請求參數（Form Data）

參數	類型	必填	說明
`file`	File	是	`.skill` 或 `.zip` 技能包。
`category_id`	String	否	Skill 分類 ID；不傳時建立為空分類。

回應

回應範例

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

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

此代碼塊在浮窗中顯示

成功回應

欄位	類型	說明
skill_id	String	新建 Skill ID。
name	String	Skill 名稱。
version	String	Skill 版本號。

失敗回應

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

狀態碼

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