メインコンテンツへスキップ
POST /v1/agents 新しい Agent 設定を作成します。

​
ヘッダー

ヘッダー必須説明
AuthorizationはいBearer <PAT>
Content-Typeはいapplication/json
Idempotency-Keyいいえ冪等キー、重複作成を防止

​
リクエストボディ

フィールド型必須説明
namestringはいAgent 名、1-256 文字
modelstringはいモデル識別子（"ultimate" など）。利用可能な値は モデル一覧 で確認できます
systemstringいいえシステムプロンプト、最大 100000 文字
descriptionstringいいえAgent の説明、最大 2048 文字
toolsarray of Agent toolいいえツール設定リスト、最大 128 件
mcp_serversarray of MCP serverいいえMCP サーバー設定リスト、最大 20 件。認証は Vault で設定
skillsarray of Skill bindingいいえSkill バインディング、最大 20 件
metadataMetadata objectいいえカスタムメタデータ。デフォルトは {}
multiagentMultiagentいいえManaged Agents 設定。設定時は agent_toolset_20260401 ツールエントリが必要

​
リクエスト例

curl -X POST "https://api.qoder.com/api/v1/cloud/agents" \
  -H "Authorization: Bearer $QODER_PAT" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "doc-test-agent",
    "model": "ultimate",
    "system": "あなたはドキュメントテストアシスタントです",
    "tools": [
      {
        "type": "agent_toolset_20260401",
        "enabled_tools": ["Bash", "Read", "Write", "Edit", "Glob", "Grep", "WebFetch", "WebSearch"]
      }
    ],
    "mcp_servers": [
      {
        "type": "http",
        "name": "weather-service",
        "url": "https://mcp.example.com/mcp"
      }
    ]
  }'

​
レスポンス例

HTTP 201 Created 
{
  "type": "agent",
  "id": "agent_019eXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
  "name": "doc-test-agent",
  "description": "",
  "model": "ultimate",
  "system": "あなたはドキュメントテストアシスタントです",
  "tools": [
    {
      "type": "agent_toolset_20260401",
      "enabled_tools": ["Bash", "Read", "Write", "Edit", "Glob", "Grep", "WebFetch", "WebSearch"]
    }
  ],
  "mcp_servers": [
    {
      "type": "http",
      "name": "weather-service",
      "url": "https://mcp.example.com/mcp"
    }
  ],
  "skills": [],
  "metadata": {},
  "version": 1,
  "archived": false,
  "archived_at": null,
  "created_at": "2026-05-18T15:26:39.61669Z",
  "updated_at": "2026-05-18T15:26:39.61669Z"
}

​
レスポンスフィールド

フィールド型説明
typestring固定値 "agent"
idstringAgent の一意識別子、プレフィックス agent_
namestringAgent 名
descriptionstringAgent の説明
modelstringモデル識別子
systemstringシステムプロンプト
toolsarray of Agent toolツール設定リスト
mcp_serversarray of MCP serverMCP サーバー設定
skillsarray of Skill bindingSkill バインディング
metadataMetadata objectカスタムメタデータ
multiagentMultiagent | nullManaged Agents 設定。未設定時は null
versioninteger現在のバージョン番号、1 から開始
archivedbooleanアーカイブ済みかどうか（デフォルト false）
archived_atstring|nullアーカイブ時刻（ISO 8601）、未アーカイブの場合は null
created_atstring作成時刻（ISO 8601）
updated_atstring最終更新時刻（ISO 8601）

​
エラーコード

HTTPtypeトリガー条件
400invalid_request_error必須フィールド name の欠落
400invalid_request_errorname の長さが 256 文字を超過
400invalid_request_error必須フィールド model の欠落
400invalid_request_errortools が上限の 128 件を超過
400invalid_request_errormcp_servers または skills の設定形式エラー
400invalid_request_errorskills が上限の 20 件を超過
400invalid_request_errormultiagent.type が "coordinator" ではない
400invalid_request_errormultiagent.agents が空、または上限の 20 件を超過
400invalid_request_errormultiagent が設定されているが tools に agent_toolset_20260401 エントリがない
400invalid_request_errormultiagent.agents で参照された Agent ID が存在しない
401authentication_errorPAT が無効または期限切れ
403permission_errorこの操作を実行する権限がない

​
エラーレスポンス例

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

​
関連項目

Agent の定義

再利用可能でバージョン管理された Agent 構成を作成します。