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.
{
"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"
}
]
}
}
Camadas de nível superior
campo | Tipo | Descrição |
|---|---|---|
| string (enum) | Agente lançado em |
| matriz de objetos | The agents available through |
| objeto | Servidores MCP a serem disponibilizados para os agentes ativados. Consulte |
| objeto | Habilidades a serem disponibilizadas para os agentes ativados. Consulte |
| objeto | Recomendações baseadas em gastos que alternam o agente e o modelo default conforme o orçamento é consumido. Consulte |
enabled_agents
campo | Tipo | Descrição |
|---|---|---|
| string (enum) | O agente de codificação que esta entrada configura. Valores válidos: |
| objeto | Configuração por agente para este agente. Consulte |
config
Cada entrada de enabled_agents tem um objeto config que define a origem do modelo por agente, os modelos default e os recursos do Unity Gateway.
campo | Tipo | Descrição |
|---|---|---|
| objeto | A origem do modelo do agente. Defina exatamente uma origem. Consulte |
| map | O modelo ou os modelos default que o agente inicia. Consulte |
| objeto | Inclui o agente no Smart Routing, onde houver suporte. Aceita um único boolean |
| map | Cabeçalhos anexados a cada solicitação de gateway deste agente, como pares de strings key-value. |
| objeto | Rastreamento no lado do cliente por agente. Aceita um único Boolean |
| objeto | As próprias configurações do agente, que |
models
models pode conter um dos seguintes: Para obter exemplos, consulte Choose model sources for each agent.
campo | Tipo | Descrição |
|---|---|---|
| matriz de strings | Lista estática de nomes completos de serviços de modelo do Unity Catalog a serem disponibilizados. |
| string | Nome completo no Unity Catalog de um serviço de provedor de modelo. Todos os modelos dele ficam disponíveis. |
| string | Um catálogo e esquema ( |
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 |
|---|---|---|
| Todos os agentes | Modelo default geral a ser lançado. |
| Apenas o Claude Code | Default para a família Opus. |
| Apenas o Claude Code | Default for the Sonnet family. |
| Apenas o Claude Code | Default para a família Haiku. |
| Apenas o Claude Code | Default para a família Fable. |
agent_native_settings
agent_native_settings transmite as configurações gerenciadas pelo próprio agente para as máquinas dos desenvolvedores. Quando um desenvolvedor executa ug configure em um terminal interativo, ug grava cada key no arquivo de configurações gerenciadas de todo o sistema na máquina do agente, que tem precedência sobre as configurações do próprio desenvolvedor para esse agente. As keys e os valores usam o formato próprio do agente; consulte a documentação do agente para saber o que cada configuração faz.
Somente os agentes e as keys da tabela a seguir são aceitos. Uma configuração que define agent_native_settings para outro agente ou usa outra key é rejeitada ao ser salva.
Agente | Arquivo de configurações gerenciadas | Chaves aceitas | Referência |
|---|---|---|---|
Claude Code |
|
|
Se você remover uma key ou um desenvolvedor mudar para um workspace cuja configuração não a defina, ug a removerá do arquivo de configurações gerenciadas na próxima execução, a menos que alguém tenha editado manualmente o valor depois que ug o gravou. Para remover as configurações que ug gravou, execute ug revert.
Se você definir allowedMcpServers do Claude Code, ug adicionará à lista os servidores MCP que registrar a partir dessa configuração, para que permaneçam disponíveis. Para bloquear um deles, remova-o de mcp_servers.
mcp_servers
mcp_servers pode conter um dos seguintes:
campo | Tipo | Descrição |
|---|---|---|
| matriz de strings | Nomes exatos de recursos do Unity Catalog. |
| string | Um catálogo e esquema ( |
habilidades
skills pode conter um dos seguintes:
campo | Tipo | Descrição |
|---|---|---|
| matriz de strings | Nomes exatos de recursos do Unity Catalog. |
| string | Um catálogo e esquema ( |
smart_defaults
campo | Tipo | Descrição |
|---|---|---|
| string (UUID) | O |
| 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 |
|---|---|---|
| Número | Fração do orçamento (0–1) em que esta camada é ativada. Por exemplo, |
| string (enum) | Agente para o qual mudar o default. Deve aparecer em |
| 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.