Schemat konfiguracji agentów kodujących

To odniesienie opisuje każde pole w konfiguracji agenta kodującego. Aby opublikować i zarządzać konfiguracją, zobacz Konfiguruj agentów kodujących.

Następująca konfiguracja wykorzystuje każde obsługiwane pole. W rzeczywistej konfiguracji ustaw tylko pola potrzebne zespołowi i ustaw dokładnie jedno źródło modelu na agenta. Nazwy pól odpowiadają kluczom w edytorze JSON i 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"
      }
    ]
  }
}

Pola najwyższego poziomu

Pole	Typ	Description
`default_agent`	ciąg (wyliczenie)	Agent uruchamiał się na gołym `ug` poziomie, gdy nie jest aktywny żaden poziom smart-default. Musi pojawić się w `enabled_agents`. Prawidłowe wartości: `CODING_AGENT_CLAUDE_CODE`, `CODING_AGENT_CODEX`. Aktywny `smart_defaults` poziom go nadpisał.
`enabled_agents`	tablica obiektów	Agenci dostępni przez portal `ug` oraz ich konfiguracja na agenta. Każdy agent może pojawić się maksymalnie raz. Zobacz: `enabled_agents[]`.
`mcp_servers`	obiekt	serwery MCP udostępnione agentom. Zobacz: `mcp_servers`.
`skills`	obiekt	Umiejętności, które można udostępnić agentom z uprawnieniami. Zobacz: `skills`.
`smart_defaults`	obiekt	Rekomendacje oparte na wydatkach, które zmieniają domyślnego agenta i model w miarę zużycia budżetu. Zobacz: `smart_defaults`.

enabled_agents

Pole	Typ	Description
`agent`	ciąg (wyliczenie)	Agent kodujący konfiguruje ten wpis. Prawidłowe wartości: `CODING_AGENT_CLAUDE_CODE`, `CODING_AGENT_CODEX`.
`config`	obiekt	Konfiguracja per agenta dla tego agenta. Zobacz: `config`.

config

Każdy enabled_agents wpis ma obiekt, config który ustawia źródło modelu dla agenta, modele domyślne oraz funkcje Unity Gateway.

Pole	Typ	Description
`models`	obiekt	Modelowe źródło agenta. Ustaw dokładnie jedno źródło. Zobacz: `models`.
`default_models`	mapa	Domyślny model lub modele, które agent uruchamia. Zobacz: `default_models`.
`smart_routing`	obiekt	Wybiera agenta do Smart Routing dla zadań podagenta, jeśli jest to obsługiwane. Potrzeba jednego `enabled` booleana.
`http_headers`	mapa	Nagłówki dołączane do każdego żądania bramy od tego agenta jako pary klucz-wartość łańcuchów.
`tracing`	obiekt	Śledzenie po stronie klienta na zlecenie dla agentów. Potrzeba jednego `enabled` booleana.
`agent_native_settings`	obiekt	Ustawienia samego agenta, które `ug` zapisują as-is do pliku zarządzanych ustawień agenta na całej maszynie. Obsługiwane tylko dla niektórych agentów. Zobacz: `agent_native_settings`.

Modele

models może zawierać jedno z poniższych. Przykłady można znaleźć w sekcji Wybierz źródła modeli dla każdego agenta.

Pole	Typ	Description
`model_services`	tablica ciągów	Statyczna lista pełnych nazw usług modeli Unity Catalog do udostępnienia.
`model_provider_service`	ciąg	Pełna nazwa katalogu Unity dla usługi dostawcy modelu. Wszystkie jego modele stają się dostępne.
`unity_catalog_location`	ciąg	Katalog i schemat (`catalog.schema`). Wszystkie modelowe usługi, które deweloper posiada, `EXECUTE` stały się dostępne.

default_models

default_models jest odwzorowaniem domyślnych kluczy modelu na nazwy modeli. default_model ustala ogólny domyślny poziom dla każdego agenta. Klucze dla każdej rodziny (default_opus_model, default_sonnet_model, default_haiku_model, i default_fable_model) dotyczą tylko kodu Claude'a. Nazwy modeli są identyfikatorami modeli, gdy źródłem jest usługa dostawcy modeli, lub pełne nazwy usług modeli Unity Catalog. W statycznej model_services liście każdy domyślny element musi również pojawić się na tej liście.

Key	Dotyczy	Description
`default_model`	Wszyscy agenci	Ogólnie domyślny model do startu.
`default_opus_model`	Tylko kod Claude'a	Domyślność dla rodziny Opus.
`default_sonnet_model`	Tylko kod Claude'a	Domyślne dla rodziny Sonetów.
`default_haiku_model`	Tylko kod Claude'a	Domyślna dla rodziny Haiku.
`default_fable_model`	Tylko kod Claude'a	Domyślne dla rodziny Fable.

agent_native_settings

agent_native_settings przekazuje własne zarządzane ustawienia agenta na maszyny deweloperów. Gdy programista uruchamia ug configure się w interaktywnym terminalu, ug zapisuje każdy klucz do pliku zarządzanych ustawień agenta, który ma pierwszeństwo przed ustawieniami tego samego dla tego agenta. Klucze i wartości korzystają z własnego formatu agenta, więc zapoznaj się z dokumentacją agenta, aby zobaczyć, co robi każde ustawienie.

Akceptowane są tylko agentki i klucze z poniższej tabeli. Konfiguracja, która ustawia agent_native_settings się dla innego agenta lub używa innego klucza, jest odrzucana podczas zapisywania.

Agent	Plik zarządzanych ustawień	Akceptowane klucze	Reference
Kod Claude'a	`/etc/claude-code/managed-settings.json` (Linux), `/Library/Application Support/ClaudeCode/managed-settings.json` (macOS)	`allowManagedMcpServersOnly`, `allowedMcpServers`, , , `enableAllProjectMcpServers`, `enabledMcpjsonServersdeniedMcpServersdisabledMcpjsonServers`	Zarządzanie konfiguracją MCP w kodzie Claude

Jeśli usuniesz klucz lub programista przełączy się do workspace, którego konfiguracja go nie ustawia, usuwa ug go z pliku zarządzanych ustawień przy następnym uruchomieniu, chyba że ktoś ręcznie edytował wartość po ug jego zapisaniu. Aby usunąć ustawienia, które pisały ug , uruchom ug revert.

Jeśli ustawisz kod allowedMcpServersClaude'a, ug dodaje serwery MCP rejestrowane z tej konfiguracji do listy, aby pozostały dostępne. Aby zablokować jedną z nich, usuń ją z mcp_servers.

mcp_servers

mcp_servers może zawierać jedno z następujących elementów:

Pole	Typ	Description
`names`	tablica ciągów	Dokładne nazwy zasobów katalogu Unity.
`unity_catalog_location`	ciąg	Katalog i schemat (`catalog.schema`). Zawiera wszystkie zasoby pod swoją granicą.

Umiejętności

skills może zawierać jedno z następujących elementów:

Pole	Typ	Description
`names`	tablica ciągów	Dokładne nazwy zasobów katalogu Unity.
`unity_catalog_location`	ciąg	Katalog i schemat (`catalog.schema`). Zawiera wszystkie zasoby pod swoją granicą.

smart_defaults

Pole	Typ	Description
`budget_id`	struna (UUID)	Budżet jest .`budget_configuration_id`
`tiers`	tablica obiektów	Wydawaj poziomy. Obowiązuje najwyższy poziom, którego próg zostanie osiągnięty.

tiers

Każdy wpis może tiers zawierać następujące treści:

Pole	Typ	Description
`spending_percentage`	number	Ułamek budżetu (0–1), przy którym aktywuje się ten poziom. Na przykład `0.8` to 80%.
`recommended_agent`	ciąg (wyliczenie)	Agent, na którego przełączać domyślne. Musi pojawić się w `enabled_agents`. Prawidłowe wartości: `CODING_AGENT_CLAUDE_CODE`, `CODING_AGENT_CODEX`.
`recommended_model`	ciąg	Model do przełączania domyślnego, gdy ten poziom jest aktywny.

API zwraca także pola tylko do odczytu lub zarządzane przez serwer, których nie ustawiasz, w tym name, workspace_id, create_time, created_user_id, update_time, updated_user_id, oraz retrieved_time.

Opinia

Czy ta strona była pomocna?

Ostatnia aktualizacja o 2026-10-23