Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 Beispielmain.default.anthropic_prod.claude-sonnet-5-5. Die Modell-ID kann Punkte enthalten, wie zum Beispielmain.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, unddefault_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 incatalog.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.