Agent オブジェクト
create、list、update、archive、およびversion を省略した GET /v1/agents/{agent_id} で返却されます。
| フィールド | 型 | 説明 |
|---|---|---|
id | string | agent_ プレフィックス付きの Agent ID |
type | string | 固定値 "agent" |
name | string | Agent 名、1-256 文字 |
description | string | Agent の説明、最大 2048 文字 |
model | string | モデル識別子。リクエストおよびレスポンスでは文字列値を使用 |
system | string | システムプロンプト、最大 100000 文字 |
tools | Agent ツールの配列 | ツール設定リスト、最大 128 件。デフォルトは [] |
mcp_servers | MCP サーバーの配列 | MCP サーバーリスト、最大 20 件。デフォルトは [] |
skills | Skill バインディングの配列 | Skill バインディング、最大 20 件。デフォルトは [] |
metadata | object | メタデータオブジェクト。デフォルトは {} |
version | integer | 現在の Agent バージョン、1 から開始 |
archived | boolean | Agent がアーカイブ済みかどうか |
archived_at | string | null | UTC でのアーカイブ時刻、未アーカイブの場合は null |
created_at | string | UTC での作成時刻 |
updated_at | string | UTC での最終更新時刻 |
Agent バージョンスナップショット
version を指定した GET /v1/agents/{agent_id} および GET /v1/agents/{agent_id}/versions で返却されます。
| フィールド | 型 | 説明 |
|---|---|---|
id | string | agent_ プレフィックス付きの Agent ID |
type | string | 固定値 "agent" |
name | string | Agent 名 |
description | string | Agent の説明 |
model | string | モデル識別子 |
system | string | システムプロンプト |
tools | Agent ツールの配列 | ツール設定リスト |
mcp_servers | MCP サーバーの配列 | MCP サーバーリスト |
skills | Skill バインディングの配列 | Skill バインディング |
metadata | object | メタデータオブジェクト |
version | integer | このスナップショットのバージョン番号 |
archived_at | string | null | UTC でのアーカイブ時刻、スナップショット時点で未アーカイブの場合は null |
created_at | string | UTC での Agent 作成時刻 |
updated_at | string | UTC でのこのスナップショットの最終更新時刻 |
Agent ツール
tools[] は type で区別されるユニオン型です。
| フィールド | 型 | 対象 | 説明 |
|---|---|---|---|
type | string | すべて | 必須。有効な値: agent_toolset_20260401、mcp_toolset、custom |
enabled_tools | string の配列 | agent_toolset_20260401 | 組み込みツールの許可リスト。非空の配列は厳密な許可リストとして機能します。省略するか [] を渡すとデフォルトの組み込みツールセットが使用され、disallowed_tools と configs[].enabled は引き続き適用されます。値は以下の組み込みツール名のいずれかを使用してください |
disallowed_tools | string の配列 | agent_toolset_20260401 | 非表示および拒否する組み込みツール。値は以下の組み込みツール名のいずれかを使用してください。同じツールを enabled_tools と disallowed_tools の両方に含めることはできません |
configs | ツール設定の配列 | agent_toolset_20260401、mcp_toolset | ツールごとの有効化と権限ルール。ツールごとの権限はここで設定します |
mcp_server_name | string | mcp_toolset | 必須。mcp_servers[].name のいずれかの値と一致する必要があります |
name | string | custom | 必須のカスタムツール名。組み込みツール名と衝突してはならず、mcp__ で始めることはできません |
description | string | custom | 必須のカスタムツールの説明 |
input_schema | object | custom | 必須の JSON Schema オブジェクト。input_schema.type は "object" でなければなりません |
permission_policy をサポートしていません。権限は agent_toolset_20260401 または mcp_toolset エントリの configs[].permission_policy で設定してください。
組み込みツール名
以下の組み込みツール名を使用してください:| ツール名 |
|---|
Bash |
DeliverArtifacts |
Edit |
Glob |
Grep |
Read |
WebFetch |
WebSearch |
Write |
ツール設定
tools[].configs[] で使用されます。
| フィールド | 型 | 必須 | 説明 |
|---|---|---|---|
name | string | はい | 設定するツール名。agent_toolset_20260401 の場合は組み込みツール名を使用します。mcp_toolset の場合は MCP サーバーが公開するツール名をそのまま使用します |
enabled | boolean | いいえ | false で指定したツールを非表示かつ拒否します。true で明示的に有効化します |
permission_policy | 権限ポリシー | いいえ | このツールの実行時の権限動作 |
権限ポリシー
| フィールド | 型 | 必須 | 説明 |
|---|---|---|---|
type | string | はい | 有効な値: always_allow、always_ask、always_deny |
always_allow は一時停止せずに実行し、always_ask は user.tool_confirmation イベントを待って一時停止し、always_deny は拒否されたツール結果を返します。
MCP サーバー
mcp_servers[] で使用されます。
| フィールド | 型 | 必須 | 説明 |
|---|---|---|---|
name | string | はい | この Agent 内で一意の MCP サーバー名 |
type | string | はい | サポートされる値: "http" |
url | string | はい | Streamable HTTP MCP エンドポイント URL |
Skill バインディング
skills[] で使用されます。
| フィールド | 型 | 必須 | 説明 |
|---|---|---|---|
type | string | はい | 有効な値: qoder、custom |
skill_id | string | はい | Skill 識別子 |
version | string | いいえ | 任意の非空バージョン文字列 |
関連項目
Agent の定義
再利用可能でバージョン管理された Agent 構成を作成します。