Esquema de configuração de agente de codificação

Esta referência descreve todos os campos em uma configuração de agente de codificação. Para publicar e gerenciar uma configuração, consulte Configurar agentes de codificação.

A configuração a seguir usa todos os campos compatíveis. Em uma configuração real, defina apenas os campos que sua equipe precisa e configure exatamente uma fonte de modelo por agente. Os nomes dos campos correspondem às key no editor JSON e na API.

JSON
{
  "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"
      }
    ]
  }
}

Camadas de nível superior

campo	Tipo	Descrição
`default_agent`	string (enum)	Agente lançado em `ug` puro quando nenhuma camada smart-default está ativa. Deve aparecer em `enabled_agents`. Valores válidos: `CODING_AGENT_CLAUDE_CODE`, `CODING_AGENT_CODEX`. Uma camada `smart_defaults` ativa substitui isso.
`enabled_agents`	matriz de objetos	The agents available through `ug` and their per-agent configuration. Each agent can appear at most once. See `enabled_agents[]`.
`mcp_servers`	objeto	Servidores MCP a serem disponibilizados para os agentes ativados. Consulte `mcp_servers`.
`skills`	objeto	Habilidades a serem disponibilizadas para os agentes ativados. Consulte `skills`.
`smart_defaults`	objeto	Recomendações baseadas em gastos que alternam o agente e o modelo default conforme o orçamento é consumido. Consulte `smart_defaults`.

campo	Tipo	Descrição
`default_agent`	string (enum)	Agente lançado em `ug` puro quando nenhuma camada smart-default está ativa. Deve aparecer em `enabled_agents`. Valores válidos: `CODING_AGENT_CLAUDE_CODE`, `CODING_AGENT_CODEX`. Uma camada `smart_defaults` ativa substitui isso.
`enabled_agents`	matriz de objetos	The agents available through `ug` and their per-agent configuration. Each agent can appear at most once. See `enabled_agents[]`.
`mcp_servers`	objeto	Servidores MCP a serem disponibilizados para os agentes ativados. Consulte `mcp_servers`.
`skills`	objeto	Habilidades a serem disponibilizadas para os agentes ativados. Consulte `skills`.
`smart_defaults`	objeto	Recomendações baseadas em gastos que alternam o agente e o modelo default conforme o orçamento é consumido. Consulte `smart_defaults`.

enabled_agents

campo	Tipo	Descrição
`agent`	string (enum)	O agente de codificação que esta entrada configura. Valores válidos: `CODING_AGENT_CLAUDE_CODE`, `CODING_AGENT_CODEX`.
`config`	objeto	Configuração por agente para este agente. Consulte `config`.

campo	Tipo	Descrição
`agent`	string (enum)	O agente de codificação que esta entrada configura. Valores válidos: `CODING_AGENT_CLAUDE_CODE`, `CODING_AGENT_CODEX`.
`config`	objeto	Configuração por agente para este agente. Consulte `config`.

config

config define a origem do modelo por agente, os modelos default e os recursos do Unity Gateway.

campo	Tipo	Descrição
`models`	objeto	A origem do modelo do agente. Defina exatamente uma origem. Consulte `models`.
`default_models`	map	O modelo ou os modelos default que o agente inicia. Consulte `default_models`.
`smart_routing`	objeto	Inclui o agente no Smart Routing, onde houver suporte. Aceita um único boolean `enabled`.
`http_headers`	map	Cabeçalhos anexados a cada solicitação de gateway deste agente, como pares de strings key-value.
`tracing`	objeto	Rastreamento no lado do cliente por agente. Aceita um único Boolean `enabled`.

campo	Tipo	Descrição
`models`	objeto	A origem do modelo do agente. Defina exatamente uma origem. Consulte `models`.
`default_models`	map	O modelo ou os modelos default que o agente inicia. Consulte `default_models`.
`smart_routing`	objeto	Inclui o agente no Smart Routing, onde houver suporte. Aceita um único boolean `enabled`.
`http_headers`	map	Cabeçalhos anexados a cada solicitação de gateway deste agente, como pares de strings key-value.
`tracing`	objeto	Rastreamento no lado do cliente por agente. Aceita um único Boolean `enabled`.

models

models pode conter um dos seguintes: Para obter exemplos, consulte Choose model sources for each agent.

campo	Tipo	Descrição
`model_services`	matriz de strings	Lista estática de nomes completos de serviços de modelo do Unity Catalog a serem disponibilizados.
`model_provider_service`	string	Nome completo no Unity Catalog de um serviço de provedor de modelo. Todos os modelos dele ficam disponíveis.
`unity_catalog_location`	string	Um catálogo e esquema (`catalog.schema`). Todos os serviços de modelo ali nos quais um desenvolvedor tem `EXECUTE` tornam-se disponíveis.

campo	Tipo	Descrição
`model_services`	matriz de strings	Lista estática de nomes completos de serviços de modelo do Unity Catalog a serem disponibilizados.
`model_provider_service`	string	Nome completo no Unity Catalog de um serviço de provedor de modelo. Todos os modelos dele ficam disponíveis.
`unity_catalog_location`	string	Um catálogo e esquema (`catalog.schema`). Todos os serviços de modelo ali nos quais um desenvolvedor tem `EXECUTE` tornam-se disponíveis.

default_models

default_models é um mapa de keys de default-model para nomes de modelo. default_model define o default geral para qualquer agente. As key por família (default_opus_model, default_sonnet_model, default_haiku_model e default_fable_model) aplicam-se somente ao Claude Code. Os nomes de modelo são IDs de modelo quando a origem é um serviço de provedor de modelo, ou nomes completos de serviço de modelo do Unity Catalog nos demais casos. Com uma lista estática model_services, cada default também deve aparecer nessa lista.

Chave	Applies to	Descrição
`default_model`	Todos os agentes	Modelo default geral a ser lançado.
`default_opus_model`	Apenas o Claude Code	Default para a família Opus.
`default_sonnet_model`	Apenas o Claude Code	Default for the Sonnet family.
`default_haiku_model`	Apenas o Claude Code	Default para a família Haiku.
`default_fable_model`	Apenas o Claude Code	Default para a família Fable.

Chave	Applies to	Descrição
`default_model`	Todos os agentes	Modelo default geral a ser lançado.
`default_opus_model`	Apenas o Claude Code	Default para a família Opus.
`default_sonnet_model`	Apenas o Claude Code	Default for the Sonnet family.
`default_haiku_model`	Apenas o Claude Code	Default para a família Haiku.
`default_fable_model`	Apenas o Claude Code	Default para a família Fable.

mcp_servers

mcp_servers pode conter um dos seguintes:

campo	Tipo	Descrição
`names`	matriz de strings	Nomes exatos de recursos do Unity Catalog.
`unity_catalog_location`	string	Um catálogo e esquema (`catalog.schema`). Inclui todos os recursos sob ele.

habilidades

skills pode conter um dos seguintes:

campo	Tipo	Descrição
`names`	matriz de strings	Nomes exatos de recursos do Unity Catalog.
`unity_catalog_location`	string	Um catálogo e esquema (`catalog.schema`). Inclui todos os recursos sob ele.

smart_defaults

campo	Tipo	Descrição
`budget_id`	string (UUID)	O `budget_configuration_id` do orçamento.
`tiers`	matriz de objetos	Camadas de gastos. Aplica-se a camada mais alta cujo limite é atingido.

camadas

Cada entrada em tiers pode conter o seguinte:

campo	Tipo	Descrição
`spending_percentage`	Número	Fração do orçamento (0–1) em que esta camada é ativada. Por exemplo, `0.8` é 80%.
`recommended_agent`	string (enum)	Agente para o qual mudar o default. Deve aparecer em `enabled_agents`. Valores válidos: `CODING_AGENT_CLAUDE_CODE`, `CODING_AGENT_CODEX`.
`recommended_model`	string	Modelo para o qual alterar o default enquanto esta camada estiver ativa.

campo	Tipo	Descrição
`spending_percentage`	Número	Fração do orçamento (0–1) em que esta camada é ativada. Por exemplo, `0.8` é 80%.
`recommended_agent`	string (enum)	Agente para o qual mudar o default. Deve aparecer em `enabled_agents`. Valores válidos: `CODING_AGENT_CLAUDE_CODE`, `CODING_AGENT_CODEX`.
`recommended_model`	string	Modelo para o qual alterar o default enquanto esta camada estiver ativa.

A API também retorna campos somente leitura ou gerenciados pelo servidor que você não define, incluindo name, workspace_id, create_time, created_user_id, update_time, updated_user_id e retrieved_time.

Camadas de nível superior​

enabled_agents​

config​

models​

default_models​

mcp_servers​

habilidades​

smart_defaults​

camadas​