Kodierungsagenten-Konfigurationsschema

Diese Referenz beschreibt jedes Feld in einer Codierungsagenten-Konfiguration. Um eine Konfiguration zu veröffentlichen und zu verwalten, siehe Configure coding agents.

Die folgende Konfiguration verwendet jedes unterstützte Feld. In einer realen Konfiguration setze nur die Felder, die dein Team braucht, und leg genau eine Modellquelle pro Agent fest. Die Feldnamen stimmen mit den Schlüsseln im JSON-Editor und der API überein.

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

Felder auf oberster Ebene

enabled_agents

Konfiguration

Jeder enabled_agents Eintrag enthält ein config Objekt, das die Quelle, die Standardmodelle und die Unity-Gateway-Funktionen pro Agent festlegt.

Modelle

models kann eines der folgenden enthalten. Beispiele finden Sie unter Choose model sources für jeden Agenten.

default_models

default_models ist eine Karte von Standardmodell-Schlüsseln zu Modellnamen. default_model legt den Gesamtstandard für jeden Agenten fest. Die Schlüssel pro Familie (default_opus_model, default_sonnet_model, , default_haiku_modelund default_fable_model) gelten nur für den Claude Code. Modellnamen sind Modell-IDs, wenn der Quellcode ein Modellanbieter-Dienst ist, oder ansonsten vollständige Unity Catalog-Modell-Service-Namen. Bei einer statischen model_services Liste muss auch jeder Standard in dieser Liste erscheinen.

agent_native_settings

agent_native_settings übergibt die eigenen verwalteten Einstellungen eines Agenten an die Rechner der Entwickler. Wenn ein Entwickler in einem interaktiven Terminal läuft ug configure , ug schreibt er jeden Schlüssel in die maschinenweite verwaltete Einstellungsdatei des Agenten, die Vorrang vor den eigenen Einstellungen des Entwicklers für diesen Agenten hat. Schlüssel und Werte verwenden das eigene Format des Agenten, also sehen Sie sich die Dokumentation des Agenten an, was jede Einstellung macht.

Nur die Agenten und Schlüssel in der folgenden Tabelle werden akzeptiert. Eine Konfiguration, die für einen anderen Agenten setzt agent_native_settings oder einen anderen Schlüssel verwendet, wird beim Speichern abgelehnt.

Wenn du einen Schlüssel entfernst oder ein Entwickler zu einem Arbeitsbereich wechselt, dessen Konfiguration ihn nicht setzt, ug entfernt er ihn beim nächsten Mal aus der verwalteten Einstellungsdatei, es sei denn, jemand hat den Wert nach ug dem Schreiben manuell bearbeitet. Um die Einstellungen zu entfernen, die ug geschrieben wurden, führe ug revert.

Wenn man Claude Code setzt, allowedMcpServersug fügt man die MCP-Server hinzu, die aus dieser Konfiguration registriert werden, sodass sie verfügbar bleiben. Um eines davon zu blockieren, entferne es aus mcp_servers.

mcp_servers

mcp_servers kann eines der folgenden enthalten:

Fähigkeiten

skills kann eines der folgenden enthalten:

smart_defaults

tiers

Jeder Eintrag kann tiers Folgendes enthalten:

Die API liefert außerdem schreibgeschützte oder serververwaltete Felder, die du nicht gesetzt hast, darunter name, workspace_id, create_time, update_timecreated_user_id, , updated_user_id, und retrieved_time.