コーディングエージェントの構成スキーマ
このリファレンスでは、コーディングエージェントの構成におけるすべてのフィールドについて説明します。構成を公開および管理するには、「コーディングエージェントの構成」を参照してください。
次の構成では、サポートされているすべてのフィールドを使用します。実際の構成では、チームに必要なフィールドのみを設定し、エージェントごとにモデルのソースを正確に1つ設定してください。フィールド名は、JSONエディターおよびAPI内のキーと一致します。
{
"default_agent": "CODING_AGENT_CLAUDE_CODE",
"enabled_agents": [
{
"agent": "CODING_AGENT_CLAUDE_CODE",
"config": {
"models": {
"model_services": [
"system.ai.claude-opus-5-5",
"system.ai.claude-sonnet-4-6",
"system.ai.claude-haiku-4-5",
"system.ai.claude-fable-5"
]
},
"default_models": {
"default_model": "system.ai.claude-sonnet-4-6",
"default_opus_model": "system.ai.claude-opus-5-5",
"default_sonnet_model": "system.ai.claude-sonnet-4-6",
"default_haiku_model": "system.ai.claude-haiku-4-5",
"default_fable_model": "system.ai.claude-fable-5"
},
"smart_routing": { "enabled": true },
"http_headers": { "x-team": "platform" },
"tracing": { "enabled": true }
}
},
{
"agent": "CODING_AGENT_CODEX",
"config": {
"models": {
"unity_catalog_location": "main.default"
},
"default_models": {
"default_model": "main.default.gpt-6-sol"
},
"smart_routing": { "enabled": false },
"http_headers": {},
"tracing": { "enabled": false }
}
}
],
"mcp_servers": {
"unity_catalog_location": "system.ai"
},
"skills": {
"names": ["main.team_skills.code_review", "main.team_skills.test_writer"]
},
"smart_defaults": {
"budget_id": "123e4567-e89b-12d3-a456-426614174000",
"tiers": [
{
"spending_percentage": 0.8,
"recommended_agent": "CODING_AGENT_CODEX",
"recommended_model": "main.default.glm-5-3"
}
]
}
}
最上位のフィールド
フィールド | Type | 説明 |
|---|---|---|
| 文字列 (enum) | スマートdefaultのティアが有効になっていない場合、ベア |
| オブジェクトの配列 |
|
| オブジェクト | 有効にしたエージェントで使用できるようにする MCP サーバー。 |
| オブジェクト | 有効なエージェントで使用できるようにするスキル。 |
| オブジェクト | 予算の消費に応じてdefaultのエージェントとモデルを切り替える、支出に基づく推奨事項。 |
enabled_agents
フィールド | Type | 説明 |
|---|---|---|
| 文字列 (enum) | このエントリが構成するコーディングエージェント。有効な値: |
| オブジェクト | このエージェントのエージェントごとの構成。 |
構成
config エージェントごとのモデルソース、default モデル、および Unity Gateway 機能を設定します。
フィールド | Type | 説明 |
|---|---|---|
| オブジェクト | エージェントのモデルソース。ソースを1つだけ設定します。 |
| map | エージェントが起動するdefaultのモデル。 |
| オブジェクト | サポートされている環境では、エージェントを Smart Routing にオプトインします。単一の |
| map | このエージェントからのすべてのゲートウェイリクエストにアタッチされるヘッダー（キーと値の文字列ペア）。 |
| オブジェクト | エージェントごとのクライアント側トレース。単一の |
モデル
models 以下のいずれかを含めることができます。例については、各エージェントのモデルソースの選択を参照してください。
フィールド | Type | 説明 |
|---|---|---|
| 文字列の配列 | 使用できるようにする、完全な Unity Catalog モデルサービス名の静的リスト。 |
| string | モデルプロバイダーサービスの完全な Unity Catalog 名。そのすべてのモデルを利用できるようになります。 |
| string | カタログとスキーマ ( |
default_models
default_models は、defaultモデルのキーからモデル名へのマップです。default_modelは、任意のエージェントの全体的な default を設定します。ファミリーごとのキー（default_opus_model、default_sonnet_model、default_haiku_model、およびdefault_fable_model）は、Claude Codeにのみ適用されます。モデル名とは、ソースがモデルプロバイダーサービスの場合はモデルIDであり、それ以外の場合は完全なUnity Catalogモデルサービス名です。静的なmodel_servicesリストでは、すべてのdefaultもそのリストに表示される必要があります。
キー | 適用対象 | 説明 |
|---|---|---|
| すべてのエージェント | 起動する全体の default モデル。 |
| Claude Code のみ | defaultファミリのデフォルト。 |
| Claude Code のみ | Sonnet ファミリーの default。 |
| Claude Code のみ | Haiku ファミリーの default。 |
| Claude Code のみ | Fableファミリーのdefault。 |
mcp_servers
mcp_servers には以下のいずれかを含めることができます：
フィールド | Type | 説明 |
|---|---|---|
| 文字列の配列 | 正確な Unity Catalog リソース名。 |
| string | カタログおよびスキーマ（ |
スキル
skills には以下のいずれかを含めることができます：
フィールド | Type | 説明 |
|---|---|---|
| 文字列の配列 | 正確な Unity Catalog リソース名。 |
| string | カタログおよびスキーマ（ |
smart_defaults
フィールド | Type | 説明 |
|---|---|---|
| 文字列 (UUID) | 予算の |
| オブジェクトの配列 | 支出ティア。thresholdに達した最も高いティアが適用されます。 |
ティア
tiersの各エントリには、次の項目を含めることができます。
フィールド | Type | 説明 |
|---|---|---|
| 数字 | このティアが有効になる予算の割合（0～1）。たとえば、 |
| 文字列 (enum) | defaultを切り替えるエージェント。 |
| string | このティアが有効な間にdefaultを切り替えるモデル。 |
APIでは、設定していない読み取り専用フィールドまたはサーバー管理フィールドも返されます（name、workspace_id、create_time、created_user_id、update_time、updated_user_id、retrieved_timeなど）。