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 | サーバーエラー |
