Agent 非公開 Skill の更新

本インターフェースを使用して、現在の LoopAgent API Key が所属する Agent の非公開 Skill を更新できます。Skill ID は multipart フォームフィールド skill_id で渡し、URL パスには含めません。

• LoopAgent のみサポートし、更新できるのは現在の Agent API Key が所属する Agent 配下の非公開 Skill のみです。
• 対象の検索は skill_id + projectId + botId で限定され、現在の Agent に属さない Skill は拒否されます。
• ファイル形式は作成インターフェースと同じで、受け付けるのは .skill、.zip のみ、アーカイブの最大サイズは 20 MiB です。
• 更新では Skill コンテンツのバージョンのみを保存し、Skill の自動マウント、Agent 下書きバージョンの保存、本番 Agent バージョンの公開は行いません。

リクエストメソッド

POST

リクエストURL

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'

                    

リクエストヘッダー

リクエストパラメータ（Form Data）

サーバー側は対象 Skill の現在のファイルとメタデータを比較します。完全に一致する場合は現在のバージョンをそのまま返し、オブジェクトストレージや MongoDB への書き込みは行われず、呼び出し側が冪等リクエストヘッダーを渡す必要もありません。

レスポンス

レスポンス例

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

                    

成功時のレスポンス

エラー時のレスポンス

ステータスコード