Schema di configurazione degli agenti di codifica

Questo riferimento descrive ogni campo in una configurazione di agente codificante. Per pubblicare e gestire una configurazione, vedi Configurare agenti di codifica.

La seguente configurazione utilizza ogni campo supportato. In una configurazione reale, imposta solo i campi di cui il team ha bisogno e imposta esattamente una sorgente modello per agente. I nomi dei campi corrispondono alle chiavi nell'editor JSON e nell'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_native_settings": {
          "deniedMcpServers": [{ "serverName": "untrusted-server" }]
        }
      }
    },
    {
      "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"
      }
    ]
  }
}

Campi di primo livello

enabled_agents

configurazione

Ogni enabled_agents voce ha un config oggetto che imposta la sorgente per singolo agente, i modelli predefiniti e le funzionalità del Gateway Unity.

Modelli

models può contenere uno dei seguenti elementi. Per esempi, vedi Scegli le sorgenti del modello per ogni agente.

default_models

default_models è una mappa delle chiavi del modello predefinito verso i nomi dei modelli. default_model imposta il valore predefinito complessivo per qualsiasi agente. Le chiavi per famiglia (default_opus_model, default_sonnet_model, default_haiku_model, e default_fable_model) si applicano solo al codice Claude. I nomi dei modelli sono ID modello quando la sorgente è un servizio fornitore di modelli, o nomi completi del Catalogo Unity per i servizi modello. Con una lista statica model_services , ogni impostazione predefinita deve apparire anche in quella lista.

agent_native_settings

agent_native_settings Passa le impostazioni gestite di un agente alle macchine degli sviluppatori. Quando uno sviluppatore esegue ug configure un terminale interattivo, ug scrive ogni chiave nel file delle impostazioni gestite a livello macchina dell'agente, che ha la precedenza sulle impostazioni dello stesso sviluppatore per quell'agente. Chiavi e valori usano il formato dell'agente, quindi consulta la documentazione dell'agente per sapere cosa fa ogni setting.

Sono accettati solo gli agenti e le chiavi nella tabella seguente. Una configurazione che si imposta agent_native_settings per un altro agente, o usa un'altra chiave, viene rifiutata quando la salvi.

Se rimuovi una chiave, o uno sviluppatore passa a uno spazio di lavoro la cui configurazione non lo imposta, ug lo rimuove dal file delle impostazioni gestite la volta successiva che viene eseguito, a meno che qualcuno non abbia modificato manualmente il valore dopo ug averlo scritto. Per rimuovere le impostazioni che ug hanno scritto, esegui ug revert.

Se imposti Claude Code allowedMcpServers, ug aggiunge i server MCP registrati da questa configurazione alla lista, così che restino disponibili. Per bloccarne una di esse, rimuovilo da mcp_servers.

mcp_servers

mcp_servers può contenere uno dei seguenti:

competenze

skills può contenere uno dei seguenti:

smart_defaults

tiers

Ogni voce può tiers contenere quanto segue:

L'API restituisce anche campi di sola lettura o gestiti dal server che non si impostano, inclusi name, workspace_id, create_time, created_user_idupdate_time, updated_user_id, , e retrieved_time.