:エージェントの作成

リクエストヘッダー

ヘッダー	必須	説明
Authorization	はい	Bearer <PAT>
Content-Type	はい	application/json
Idempotency-Key	いいえ	重複作成を防止するためのべき等キー。

リクエストボディ

フィールド	型	必須	説明
name	string	はい	エージェント名。1～256 文字。
model	string | object	はい	モデル識別子。 "ultimate" などの文字列、またはオブジェクト。
instructions	string	いいえ	システムプロンプト。
description	string	いいえ	エージェントの説明。
tools	array	いいえ	ツール構成リスト。以下の tools 要素の構造をご参照ください。
mcp_servers	array	いいえ	MCP サーバー構成リスト。 形式は [{"name":"[name]","type":"url","url":"[mcp_server_url]"}]。 認証は Vault を通じて構成されます。
skills	array	いいえ	スキルバインディング。 形式は [{"type":"custom","skill_id":"[skill_id]"}]。 最大 20 エントリ。
metadata	object	いいえ	カスタムメタデータのキーと値のペア。

tools 要素の構造

{
  "type": "agent_toolset_20260401",
  "enabled_tools": ["Bash", "Read", "Write", "Edit", "Glob", "Grep", "WebFetch", "WebSearch"]
}

フィールド	型	必須	説明
type	string	はい	ツールセットタイプ識別子。
enabled_tools	array	いいえ	有効にするアトミックツールの許可リスト。フィールドを省略するか、空の配列 [] を渡すと、すべての組み込みツールが有効になります。空でない配列は厳密な許可リストとして機能し、リスト外のツールはモデルに表示されません。

リクエスト例

curl -X POST "https://api.qoder.com.cn/api/v1/cloud/agents" \
  -H "Authorization: Bearer $QODER_PAT" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "doc-test-agent",
    "model": "ultimate",
    "instructions": "You are a documentation test assistant.",
    "tools": [
      {
        "type": "agent_toolset_20260401",
        "enabled_tools": ["Bash", "Read", "Write", "Edit", "Glob", "Grep", "WebFetch", "WebSearch"]
      }
    ],
    "mcp_servers": [
      {
        "type": "url",
        "name": "weather-service",
        "url": "https://mcp.example.com/sse"
      }
    ]
  }'

レスポンス例

HTTP 201 Created

{
  "type": "agent",
  "id": "agent_019eXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
  "name": "doc-test-agent",
  "description": "",
  "model": "ultimate",
  "system": "You are a documentation test assistant.",
  "instructions": "You are a documentation test assistant.",
  "tools": [
    {
      "type": "agent_toolset_20260401",
      "enabled_tools": ["Bash", "Read", "Write", "Edit", "Glob", "Grep", "WebFetch", "WebSearch"]
    }
  ],
  "mcp_servers": [
    {
      "type": "url",
      "name": "weather-service",
      "url": "https://mcp.example.com/sse"
    }
  ],
  "default_environment": "",
  "version": 1,
  "archived": false,
  "archived_at": null,
  "created_at": "2026-05-18T15:26:39.61669Z",
  "updated_at": "2026-05-18T15:26:39.61669Z"
}

レスポンスフィールド

フィールド	型	説明
type	string	常に "agent"。
id	string	一意のエージェント識別子。接頭辞は "agent_"。
name	string	エージェント名。
description	string	エージェントの説明。
model	string	モデル識別子。
instructions	string	システムプロンプト。
system	string	instructions のエイリアス (非推奨。 代わりに instructions を使用してください)。
tools	array	ツール構成リスト。
mcp_servers	array	MCP サーバー構成。
default_environment	string	デフォルトのランタイム環境。
version	integer	現在のバージョン番号。 1 から開始します。
archived	boolean	エージェントがアーカイブされているかどうか。
archived_at	string | null	アーカイブ時刻 (ISO 8601 形式)。アーカイブされていない場合は null。
created_at	string	作成時刻 (ISO 8601 形式)。
updated_at	string	最終更新時刻 (ISO 8601 形式)。

エラー

HTTP	タイプ	トリガー
400	invalid_request_error	必須フィールド name が欠落しています。
400	invalid_request_error	name が 256 文字を超えています。
400	invalid_request_error	必須フィールド model が欠落しています。
400	invalid_request_error	mcp_servers または skills の構成が不正な形式です。
400	invalid_request_error	skills が最大 20 エントリを超えています。
401	authentication_error	PAT が無効であるか、有効期限が切れています。
403	permission_error	呼び出し元はこの操作に対する認可がありません。

エラーレスポンス例：

{
  "type": "error",
  "error": {
    "type": "invalid_request_error",
    "message": "name must be between 1 and 256 characters"
  }
}

完全なエラーエンベロープについては、「エラー」をご参照ください。