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

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. 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.
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 in Smart Routing aufgenommen, wo es unterstützt wird. Braucht nur einen Boolean enabled .
http_headers map An jede Gateway-Anfrage dieses Agenten sind Header als Schlüssel-Wert-String-Paare angehängt.
tracing Objekt Personen-seitige Nachverfolgung pro Agent. Braucht nur einen Boolean enabled .
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.

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.

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 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.

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.
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.

  • Zuletzt aktualisiert um