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

Campo	Type	Description
`default_agent`	stringa (enum)	Agente avviato in modo vuoto `ug` quando non c'è nessun livello smart-default attivo. Deve apparire in `enabled_agents`. Valori validi: `CODING_AGENT_CLAUDE_CODE`, `CODING_AGENT_CODEX`. Un tier attivo `smart_defaults` lo sovrascrive.
`enabled_agents`	matrice di oggetti	Gli agenti disponibili tramite `ug` e la loro configurazione per agente. Ogni agente può presentarsi al massimo una volta. Vedete `enabled_agents[]`.
`mcp_servers`	object	MCP da rendere disponibili agli agenti abilitati. Vedete `mcp_servers`.
`skills`	object	Competenze da rendere disponibili agli agenti abilitati. Vedete `skills`.
`smart_defaults`	object	Raccomandazioni basate sulla spesa che cambiano agente e modello predefiniti man mano che il budget viene consumato. Vedete `smart_defaults`.

enabled_agents

Campo	Type	Description
`agent`	stringa (enum)	L'agente codificante questa voce configura. Valori validi: `CODING_AGENT_CLAUDE_CODE`, `CODING_AGENT_CODEX`.
`config`	object	Configurazione per agente per questo agente. Vedete `config`.

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.

Campo	Type	Description
`models`	object	La fonte del modello dell'agente. Imposta esattamente una sola fonte. Vedete `models`.
`default_models`	mappatura	Il modello predefinito o i modelli che lancia l'agente. Vedete `default_models`.
`smart_routing`	object	Sceglie l'agente in Smart Routing per i compiti dei sottoagenti, dove supportato. Serve un solo `enabled` booleano.
`http_headers`	mappatura	Header allegate a ogni richiesta gateway da questo agente, come coppie stringhe chiave-valore.
`tracing`	object	Tracciamento lato cliente per agente. Serve un solo `enabled` booleano.
`agent_native_settings`	object	Le impostazioni dell'agente, che `ug` as-is scrive nel file di impostazioni gestite a livello di macchina dell'agente. Supportato solo per alcuni agenti. Vedete `agent_native_settings`.

Modelli

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

Campo	Type	Description
`model_services`	matrice di stringhe	Elenco statico dei nomi completi dei servizi modello del Catalogo Unity da rendere disponibili.
`model_provider_service`	string	Nome completo del Catalogo Unity di un servizio fornitore modello. Tutti i suoi modelli diventano disponibili.
`unity_catalog_location`	string	Un catalogo e uno schema (`catalog.schema`). Tutti i servizi modello su cui uno sviluppatore `EXECUTE` ha già diventato disponibile.

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.

Key	Si applica a	Description
`default_model`	Tutti gli agenti	Modello predefinito complessivo da lanciare.
`default_opus_model`	Solo Claude Code	Predefinito per la famiglia Opus.
`default_sonnet_model`	Solo Claude Code	Predefinito per la famiglia dei Sonetti.
`default_haiku_model`	Solo Claude Code	Predefinito per la famiglia Haiku.
`default_fable_model`	Solo Claude Code	Default per la famiglia Fable.

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.

Agent	File delle impostazioni gestite	Tonalità accettate	Reference
Claude Code	`/etc/claude-code/managed-settings.json` (Linux), `/Library/Application Support/ClaudeCode/managed-settings.json` (macOS)	`allowManagedMcpServersOnly`, `allowedMcpServers`, `deniedMcpServers`, `enableAllProjectMcpServers`, `enabledMcpjsonServers`, `disabledMcpjsonServers`	Configurazione MCP gestita da codice Claude

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:

Campo	Type	Description
`names`	matrice di stringhe	Nomi esatti delle risorse del Catalogo Unity.
`unity_catalog_location`	string	Un catalogo e uno schema (`catalog.schema`). Include tutte le risorse sottostanti.

competenze

skills può contenere uno dei seguenti:

Campo	Type	Description
`names`	matrice di stringhe	Nomi esatti delle risorse del Catalogo Unity.
`unity_catalog_location`	string	Un catalogo e uno schema (`catalog.schema`). Include tutte le risorse sottostanti.

smart_defaults

Campo	Type	Description
`budget_id`	stringa (UUID)	Il budget è `budget_configuration_id`.
`tiers`	matrice di oggetti	Spendi i livelli. Si applica il livello più alto la cui soglia è stata raggiunta.

tiers

Ogni voce può tiers contenere quanto segue:

Campo	Type	Description
`spending_percentage`	number	Frazione del budget (0–1) a cui questo livello si attiva. Ad esempio, `0.8` è 80%.
`recommended_agent`	stringa (enum)	Agente per impostare il predefinito. Deve apparire in `enabled_agents`. Valori validi: `CODING_AGENT_CLAUDE_CODE`, `CODING_AGENT_CODEX`.
`recommended_model`	string	Modello da usare di default mentre questo livello è attivo.

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.

Commenti e suggerimenti

Questa pagina è stata utile?

Ultimo aggiornamento: 2026-10-23