> ## Documentation Index > Fetch the complete documentation index at: https://docs.qoder.com/llms.txt > Use this file to discover all available pages before exploring further. # Agent の作成 > 新しい Agent 設定を作成します。 `POST /api/v1/cloud/agents` 新しい Agent 設定を作成します。 ## リクエストヘッダー | ヘッダー | 必須 | 説明 | | ----------------- | --- | ------------------ | | `Authorization` | はい | `Bearer ` | | `Content-Type` | はい | `application/json` | | `Idempotency-Key` | いいえ | 冪等キー。重複作成を防止します | ## リクエストボディ | フィールド | 型 | 必須 | 説明 | | ------------- | --------------------------------------------------------------------------- | --- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `name` | string | はい | Agent 名。1〜256 文字 | | `model` | string \| object | はい | モデル識別子。`"ultimate"` のような文字列、または model ID と併せて `effort` や `context_window` を設定する [Agent model](/ja/cloud-agents/api/agents/schemas#agent-model) オブジェクトを渡します。利用可能な値は [モデル一覧](/ja/cloud-agents/api/models/list) で確認できます | | `system` | string | いいえ | システムプロンプト。最大 100000 文字 | | `description` | string | いいえ | Agent の説明。最大 2048 文字 | | `tools` | [Agent tool](/ja/cloud-agents/api/agents/schemas#agent-tool) の配列 | いいえ | ツール設定リスト。最大 128 件 | | `mcp_servers` | [MCP server](/ja/cloud-agents/api/agents/schemas#mcp-server) の配列 | いいえ | MCP サーバー設定リスト。最大 20 件。認証は [Vault](/ja/cloud-agents/vaults) で設定します | | `skills` | [Skill binding](/ja/cloud-agents/api/agents/schemas#skill-binding) の配列 | いいえ | Skill バインディングリスト。最大 20 件 | | `metadata` | [Metadata オブジェクト](/ja/cloud-agents/api/conventions/schemas#metadata-object) | いいえ | カスタムメタデータ。省略時は `{}` | | `multiagent` | [Multiagent](/ja/cloud-agents/api/agents/schemas#multiagent) | いいえ | Agents 設定。設定する場合は `agent_toolset_20260401` ツールエントリも必要です | ## リクエスト例 ```bash theme={null} 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": "You are a documentation testing 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/mcp" } ] }' ``` 推論の effort やコンテキストウィンドウを設定するには、`model` をオブジェクトとして渡します: ```bash theme={null} 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-tuned", "model": { "id": "ultimate", "effort": "high", "context_window": 400000 }, "system": "You are a documentation testing assistant." }' ``` ## レスポンス例 **HTTP 200 OK** ```json theme={null} { "type": "agent", "id": "agent_019eXXXXXXXXXXXXXXXXXXXXXXXXXXXX", "name": "doc-test-agent", "description": "", "model": "ultimate", "system": "You are a documentation testing 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/mcp" } ], "skills": [], "metadata": {}, "multiagent": null, "version": 1, "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 の一意識別子。プレフィックスは `"agent_"` | | `name` | string | Agent 名 | | `description` | string | Agent の説明 | | `model` | string \| object | モデル識別子。[Agent model](/ja/cloud-agents/api/agents/schemas#agent-model) を参照 | | `system` | string | システムプロンプト | | `tools` | [Agent tool](/ja/cloud-agents/api/agents/schemas#agent-tool) の配列 | ツール設定リスト | | `mcp_servers` | [MCP server](/ja/cloud-agents/api/agents/schemas#mcp-server) の配列 | MCP サーバー設定 | | `skills` | [Skill binding](/ja/cloud-agents/api/agents/schemas#skill-binding) の配列 | Skill バインディングリスト | | `metadata` | [Metadata オブジェクト](/ja/cloud-agents/api/conventions/schemas#metadata-object) | カスタムメタデータ | | `multiagent` | [Multiagent](/ja/cloud-agents/api/agents/schemas#multiagent) \| null | Agents 設定。未設定時は `null` | | `version` | integer | 現在のバージョン番号。1 から開始 | | `archived_at` | string\|null | アーカイブ日時（ISO 8601）。未アーカイブ時は `null` | | `created_at` | string | 作成日時（ISO 8601） | | `updated_at` | string | 最終更新日時（ISO 8601） | ## エラー | HTTP | type | 発生条件 | | ---- | ----------------------- | -------------------------------------------------------------------- | | 400 | `invalid_request_error` | 必須フィールド `name` が未指定 | | 400 | `invalid_request_error` | `name` が 256 文字を超過 | | 400 | `invalid_request_error` | 必須フィールド `model` が未指定 | | 400 | `invalid_request_error` | `model.effort` が `none`、`low`、`medium`、`high`、`xhigh`、`max` のいずれでもない | | 400 | `invalid_request_error` | `model.context_window` が正の整数でない | | 400 | `invalid_request_error` | `model.speed` が指定された。代わりに `model.effort` を使用する | | 400 | `invalid_request_error` | `tools` が上限の 128 件を超過 | | 400 | `invalid_request_error` | `mcp_servers` または `skills` の設定形式が不正 | | 400 | `invalid_request_error` | `skills` が上限の 20 件を超過 | | 400 | `invalid_request_error` | `multiagent.type` が `"coordinator"` ではない | | 400 | `invalid_request_error` | `multiagent.agents` が空、または上限の 20 件を超過 | | 400 | `invalid_request_error` | `multiagent` が設定されているが `tools` に `agent_toolset_20260401` エントリがない | | 400 | `invalid_request_error` | `multiagent.agents` で参照された Agent ID が存在しない | | 401 | `authentication_error` | PAT が無効または期限切れ | | 403 | `permission_error` | この操作を実行する権限がありません | エラーレスポンスの完全なエンベロープについては [エラー](/ja/cloud-agents/api/conventions/errors) を参照してください。 ### エラーレスポンス例 ```json theme={null} { "type": "error", "request_id": "cb80235f-76a2-4ff3-9e28-5aa2da12dc14", "error": { "type": "invalid_request_error", "message": "name must be between 1 and 256 characters" } } ``` ## 関連 再利用可能でバージョン管理された Agent 構成を作成する。