logo
Development
検索
Agent 非公開 Skill の作成

Agent 非公開 Skill の作成

本インターフェースを使用して、現在の 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

リクエストURL

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 Skill パッケージファイルをフォーム形式でアップロードします。

リクエストパラメータ(Form Data)

パラメータ タイプ 必須 説明
file File はい .skill または .zip の Skill パッケージ。
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 サーバーエラー