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-5-5",
            "system.ai.claude-haiku-5-5",
            "system.ai.claude-fable-5"
          ]
        },
        "default_models": {
          "default_model": "system.ai.claude-sonnet-5-5",
          "default_opus_model": "system.ai.claude-opus-5-5",
          "default_sonnet_model": "system.ai.claude-sonnet-5-5",
          "default_haiku_model": "system.ai.claude-haiku-5-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 }
      }
    },
    {
      "agent": "CODING_AGENT_GITHUB_COPILOT",
      "config": {
        "models": {
          "model_services": ["system.ai.claude-sonnet-5-5", "system.ai.gpt-5-5"]
        },
        "default_models": {
          "default_model": "system.ai.gpt-5-5"
        },
        "tracing": { "enabled": true },
        "vscode_integration": { "enabled": true }
      }
    }
  ],
  "mcp_servers": {
    "sources": ["system.ai.*", "main.developer_tools.github"]
  },
  "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

Feld Typ Description
default_agent Zeichenfolge (Enumeration) Agent startet auf Bare, ug wenn kein Smart-Standard-Tier aktiv ist. Muss in enabled_agentserscheinen. Gültige Werte: CODING_AGENT_CLAUDE_CODE, CODING_AGENT_CODEX, CODING_AGENT_GITHUB_COPILOT. Eine aktive smart_defaults Stufe überschreibt sie.
enabled_agents Objekt-Array Die verfügbaren Agenten ug und ihre Konfiguration pro Agent. Jeder Agent kann höchstens einmal erscheinen. Siehe enabled_agents[].
mcp_servers Objekt MCP-Server, die den aktivierten Agenten zur Verfügung gestellt werden. Siehe mcp_servers.
skills Objekt Fähigkeiten, die den befähigten Agenten zur Verfügung gestellt werden können. Siehe skills.
smart_defaults Objekt Ausgabenbasierte Empfehlungen, die den Standardagenten und das Modell wechseln, sobald das Budget verbraucht wird. Siehe smart_defaults.

enabled_agents

Feld Typ Description
agent Zeichenfolge (Enumeration) Der Codierungsagent, den dieser Eintrag konfiguriert. Gültige Werte: CODING_AGENT_CLAUDE_CODE, CODING_AGENT_CODEX, CODING_AGENT_GITHUB_COPILOT.
config Objekt Agenten-Konfiguration für diesen Agenten. Siehe config.

Konfiguration

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

Feld Typ Description
models Objekt Die Modellquelle des Agenten. Stellen Sie genau eine Quelle ein. Siehe models.
default_models map Das Standardmodell oder die Modelle, die der Agent startet. Siehe default_models.
smart_routing Objekt Der Agent wird für Unteragenten-Aufgaben in Smart Routing aufgenommen, wo es unterstützt wird. Braucht nur einen Boolean enabled . Nicht unterstützt für GitHub Copilot.
http_headers map An jede Gateway-Anfrage dieses Agenten sind Header als Schlüssel-Wert-String-Paare angehängt. Header-Werte sind für jeden Entwickler im Arbeitsbereich sichtbar, also stecke keine Geheimnisse darin. Header-Namen müssen gültige HTTP-Feldnamen sein, und Header-Werte dürfen keine Steuerzeichen enthalten. Namen, die für Gateway-Authentifizierung, Identität oder Routing reserviert sind, werden abgelehnt, darunter Authorization, Proxy-Authorization, Cookie, , Hostund jeder Name, der mit X-Forwarded-beginnt.
tracing Objekt Client-seitiges Tracking pro Agent für Claude Code, Codex und GitHub Copilot. Braucht nur einen Boolean enabled .
vscode_integration Objekt Nur GitHub Copilot und dafür erforderlich. Braucht nur einen Boolean enabled . trueaußerdem richtet Copilot in Visual Studio Code ein, wenn ein Entwickler startetug configure. falserichtet nur Copilot CLI ein und entfernt eine frühere Visual Studio Code-Einrichtung. Andere Agenten können dieses Feld nicht einstellen.
agent_native_settings Objekt Die eigenen Einstellungen des Agenten, die ug as-is in die maschinenweite verwaltete Einstellungsdatei des Agenten schreiben. Unterstützt nur für einige Agenten. Siehe agent_native_settings.

Modelle

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

Feld Typ Description
model_services Feld von Zeichenfolgen Statische Liste vollständiger Unity Catalog Modell-Servicenamen, die verfügbar gemacht werden sollen.
model_provider_service Zeichenfolge Vollständiger Unity-Katalogname eines Modellanbieterdienstes. Alle seine Modelle sind verfügbar.
unity_catalog_location Zeichenfolge Ein Katalog und ein Schema (catalog.schema). Alle Modelldienste, die ein Entwickler hat EXECUTE , sind verfügbar.
sources Feld von Zeichenfolgen Liste einzelner Modelle und Wildcards, die verfügbar gemacht werden sollen. Akzeptiert höchstens 100 Einträge, die nicht-leer und eindeutig sein müssen. Kann nicht mit den anderen Modellquellfeldern kombiniert werden. Siehe unten die Eintragsformen, Wildcard-Regeln und ein Beispiel.

Jeder sources Eintrag ist ein Modelldienstname, ein Modell hinter einem Modellanbieterdienst oder eine Wildcard:

  • catalog.schema.model-service: Ein Modelldienst, wie z. B. system.ai.claude-haiku-5-5.
  • catalog.schema.model-provider-service.model: Ein Modell hinter einem Modell-Provider-Service, wie zum Beispiel main.default.anthropic_prod.claude-sonnet-5-5. Die Modell-ID kann Punkte enthalten, wie zum Beispiel main.default.openai_prod.gpt-4.1.
  • catalog.schema.*: Jeder Modelldienst im Schema. Das Schema muss mindestens einen Modellservice enthalten.
  • catalog.schema.model-provider-service.*: Jedes Modell hinter diesem Modell-Provider-Service. Der Anbieterdienst muss existieren.

Ein Wildcard muss das gesamte letzte Segment sein. Ein teilweises Muster wie system.ai.claude-* wird abgelehnt. Katalog-, Schema- und Servicenamen stimmen groß- und kleinschreibungsunempfindlich überein. Provider-Modell-IDs stimmen groß- und kleinschreibungssensitiv überein. sources kann nicht mit model_services, model_provider_service, oder unity_catalog_locationkombiniert werden.

Um ein Modell hinter einem Modellanbieter-Service, einem Azure Databricks-Modellservice und beiden Wildcard-Formularen zu kombinieren, sources setzen Sie auf:

{
  "models": {
    "sources": [
      "main.default.anthropic_prod.claude-sonnet-5-5",
      "system.ai.claude-haiku-5-5",
      "main.default.*",
      "main.default.openai_prod.*"
    ]
  }
}

Mit aktiviertem Smart Routing kann die Liste externe Modelle hinter einem Modellanbieter-Service enthalten, und der Router wählt aus jedem Modell aus, das die Liste enthält. Wenn sich zwei Einträge auf dasselbe Modell festlegen, verwendet der Router nur den ersten Eintrag in Listenreihenfolge.

default_models

default_models ist eine Karte von Standardmodell-Schlüsseln zu Modellnamen. 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. Bei einer sources Liste muss jeder Standard ein bestimmtes Modell sein, das ein sources Eintrag enthält, entweder direkt aufgeführt oder durch eine Wildcard abgebildet. Ein Standard kann kein Joker sein.

  • default_model: Der Gesamtstandard für den Agenten. Erforderlich, es sei denn, Smart Routing ist für den Agenten aktiviert. GitHub Copilot unterstützt Smart Routing nicht, daher erfordert ein GitHub Copilot-Eintrag das immer.
  • Pro-Family-Schlüssel (default_opus_model, default_sonnet_model, default_haiku_model, und default_fable_model): Optional. Nur Claude Code.
Key Gilt für: Description
default_model Alle Agents Insgesamt ist das Standardmodell zum Launch.
default_opus_model Nur Claude Code Standard für die Opus-Familie.
default_sonnet_model Nur Claude Code Standard für die Familie Sonnet.
default_haiku_model Nur Claude Code Standard für die Haiku-Familie.
default_fable_model Nur Claude Code Standard für die Familie Fable.

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.

Agent Datei für verwaltete Einstellungen Akzeptierte Schlüssel Reference
Claude Code /etc/claude-code/managed-settings.json (Linux), /Library/Application Support/ClaudeCode/managed-settings.json (macOS) allowManagedMcpServersOnly, allowedMcpServers, deniedMcpServers, enableAllProjectMcpServers, , enabledMcpjsonServers, disabledMcpjsonServers Claude Code verwaltete MCP-Konfiguration

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 Wählt die MCP-Server aus, die ug configure sich für jeden Entwickler im Arbeitsbereich registrieren. Legen Sie nur eines der folgenden Felder fest.

Feld Typ Description
sources Feld von Zeichenfolgen MCP-Server einzubeziehen. Jeder Eintrag ist entweder der vollständige Unity-Katalogname eines einzelnen MCP-Servers (catalog.schema.name) oder ein ganzes Schema (catalog.schema.*), das jeden MCP-Server in diesem Schema umfasst. Einträge können sich über Schemata erstrecken, zum Beispiel ["system.ai.*", "main.tools.*"].
names Feld von Zeichenfolgen Genaue Unity-Catalog-Ressourcennamen. Verwenden sources Sie stattdessen, das auch exakte Namen akzeptiert.
unity_catalog_location Zeichenfolge Deprecated. Ein Katalog und ein Schema (catalog.schema). Enthält jede Ressource darunter. Verwenden Sie sources stattdessen mit einem catalog.schema.* Eintrag.

sources

Eine Liste folgt sources folgenden Regeln:

  • Es kann höchstens 100 Einträge aufnehmen, ohne Duplikate oder leere Einträge.
  • * ist nur als das gesamte letzte Segment erlaubt, wie in catalog.schema.*.
  • Das Speichern der Konfiguration schlägt fehl, wenn ein exakter Eintrag einen MCP-Server nennt, der nicht existiert, oder wenn ein Schemaeintrag ein Schema nennt, das nicht existiert oder keine MCP-Server hat.

Wenn später ein Schema in sources entfernt wird, ug configure wird es mit einer Warnung übersprungen und die anderen Quellen werden weiterhin registriert.

Note

Entwickler müssen laufen, ug upgrade um eine Version von ug zu bekommen, die sources. Ältere Versionen behalten die zuletzt angewendete Konfiguration bei.

Fähigkeiten

skills kann eines der folgenden enthalten:

Feld Typ Description
names Feld von Zeichenfolgen Genaue Unity-Catalog-Ressourcennamen.
unity_catalog_location Zeichenfolge Ein Katalog und ein Schema (catalog.schema). Enthält jede Ressource darunter.

smart_defaults

Feld Typ Description
budget_id Saite (UUID) Das Budget ist budget_configuration_id.
tiers Objekt-Array Gib Stufen aus. Die höchste Stufe, deren Schwelle erreicht wird, gilt.

tiers

Jeder Eintrag kann tiers Folgendes enthalten:

Feld Typ Description
spending_percentage Zahl Bruchteil des Budgets (0–1), bei dem diese Stufe aktiviert wird. Zum Beispiel ist 0.8 80%.
recommended_agent Zeichenfolge (Enumeration) Agent, um den Standard zu wechseln. Muss in enabled_agentserscheinen. Gültige Werte: CODING_AGENT_CLAUDE_CODE, CODING_AGENT_CODEX, CODING_AGENT_GITHUB_COPILOT.
recommended_model Zeichenfolge Modelliere, um die Standardeinstellung zu wechseln, solange diese Stufe aktiv ist.

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.