Schéma de configuration de l’agent de codage
Cette référence décrit chaque champ d'une configuration d'agent de codage. Pour publier et gérer une configuration, consultez Configurer des agents de codage.
La configuration suivante utilise tous les champs pris en charge. Dans une configuration réelle, ne définissez que les champs dont votre équipe a besoin et définissez exactement une source de modèle par agent. Les noms de champs correspondent aux clés de l'éditeur JSON et de l'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-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"
}
]
}
}
Champs de haut niveau
Champ | Type | Description |
|---|---|---|
| chaîne (enum) | Agent lancé sur |
| tableau d'objets | Les agents disponibles via |
| objet | Serveurs MCP à mettre à la disposition des agents activés. Voir |
| objet | Compétences à mettre à la disposition des agents activés. Consultez |
| objet | Recommandations basées sur les dépenses qui basculent l'agent et le modèle default à mesure que le budget est consommé. Voir |
enabled_agents
Champ | Type | Description |
|---|---|---|
| chaîne (enum) | L’agent de codage que cette entrée configure. Valeurs valides : |
| objet | Configuration propre à cet agent. Consultez |
configuration
Chaque entrée enabled_agents possède un objet config qui définit la source de modèle par agent, les modèles default et les fonctionnalités de Unity Gateway.
Champ | Type | Description |
|---|---|---|
| objet | Source du modèle de l'agent. Définissez une seule source. Consultez |
| Carte | Le ou les modèles default lancés par l'agent. Consultez |
| objet | Inscrit l’agent dans le routage intelligent pour les tâches des sous-agents, lorsqu’il est pris en charge. Prend un seul booléen |
| Carte | En-têtes joints à chaque demande de passerelle à partir de cet agent, en tant que paires de chaînes clé-valeur. Les valeurs des en-têtes sont visibles par tous les développeurs du workspace, ne mettez donc pas de secrets dedans. Les noms des en-têtes doivent être des noms de champs HTTP valides et les valeurs des en-têtes ne doivent pas contenir de caractères de contrôle. Les noms réservés pour l’authentification de la passerelle, l’identité ou le routage sont rejetés, y compris |
| objet | Traçage côté client par agent pour Claude Code, Codex et GitHub Copilot. Prend un seul booléen |
| objet | GitHub Copilot uniquement, et requis pour celui-ci. Prend un seul booléen |
| objet | Les paramètres propres à l’agent que |
models
models peut contenir l'un des éléments suivants. Pour des exemples, consultez Choisir les sources de modèle pour chaque agent.
Champ | Type | Description |
|---|---|---|
| array\ | Liste statique des noms complets de services de modèle Unity Catalog à rendre disponibles. |
| chaîne | Nom complet dans Unity Catalog d’un service de fournisseur de modèles. Tous ses modèles deviennent disponibles. |
| chaîne | Un catalogue et un schéma ( |
| array\ | Liste des modèles individuels et des caractères génériques à mettre à disposition. Accepte au maximum 100 entrées, qui doivent être uniques et non vides. Ne peut pas être combiné avec les autres champs source de modèle. Voir ci-dessous les formes des entrées, les règles des caractères génériques et un exemple. |
Chaque entrée sources est un nom de service de modèle, un modèle derrière un service de fournisseur de modèles ou un caractère générique :
catalog.schema.model-service: Un service de modèle, tel quesystem.ai.claude-haiku-5-5.catalog.schema.model-provider-service.model: Un modèle derrière un service de fournisseur de modèles, tel quemain.default.anthropic_prod.claude-sonnet-5-5. L'ID du modèle peut contenir des points, tel quemain.default.openai_prod.gpt-4.1.catalog.schema.*: Chaque service de modèle du schéma. Le schéma doit contenir au moins un service de modèle.catalog.schema.model-provider-service.*: Chaque modèle derrière ce service de fournisseur de modèles. Le service fournisseur doit exister.
Un caractère générique doit être le dernier segment entier. Un modèle partiel comme system.ai.claude-* est rejeté. Les noms de catalogue, de schéma et de service sont sensibles à la casse. Les identifiants de modèle de fournisseur sont sensibles à la casse. sources ne peut pas être combiné avec model_services, model_provider_service ou unity_catalog_location.
Pour mélanger un modèle derrière un service de fournisseur de modèles, un service de modèle Databricks et les deux formes génériques, définissez sources sur :
{
"models": {
"sources": [
"main.default.anthropic_prod.claude-sonnet-5-5",
"system.ai.claude-haiku-5-5",
"main.default.*",
"main.default.openai_prod.*"
]
}
}
Avec Smart Routing activé, la liste peut inclure des modèles externes derrière un service de fournisseur de modèles, et le routeur sélectionne parmi tous les modèles que la liste inclut. Lorsque deux entrées correspondent au même modèle, le routeur n’utilise que la première entrée dans l’ordre de la liste.
default_models
default_models est une carte de clés de modèle default vers des noms de modèle. Les noms de modèle sont des ID de modèle lorsque la source est un service fournisseur de modèle, ou des noms de service de modèle Unity Catalog complets dans le cas contraire. Avec une liste model_services statique, chaque default doit également apparaître dans cette liste. Avec une liste sources, chaque default doit être un modèle spécifique inclus dans une entrée sources, soit listé directement, soit mis en correspondance par un caractère générique. Un default ne peut pas être un caractère générique.
default_model: Le default global pour l’agent. Obligatoire sauf si le Smart Routing est activé pour l’agent. GitHub Copilot ne prend pas en charge le Smart Routing, une entrée GitHub Copilot l’exige donc toujours.- Clés par famille (
default_opus_model,default_sonnet_model,default_haiku_modeletdefault_fable_model) : Facultatif. Claude Code uniquement.
Clé | S'applique à | Description |
|---|---|---|
| Tous les agents | Modèle default global à lancer. |
| Claude Code uniquement | Par default pour la famille Opus. |
| Claude Code uniquement | Par default pour la famille Sonnet. |
| Claude Code uniquement | default pour la famille Haiku. |
| Claude Code uniquement | Par Default pour la famille Fable. |
agent_native_settings
agent_native_settings transmet les paramètres gérés propres à l’agent aux machines des développeurs. Lorsqu’un développeur exécute ug configure dans un terminal interactif, ug écrit chaque clé dans le fichier de paramètres gérés à l’échelle de la machine de l’agent, qui prime sur les propres paramètres du développeur pour cet agent. Les clés et les valeurs utilisent le propre format de l’agent ; consultez donc la documentation de l’agent pour savoir ce que fait chaque paramètre.
Seuls les agents et les clés du tableau suivant sont acceptés. Une configuration qui définit agent_native_settings pour un autre agent, ou utilise une autre clé, est rejetée lorsque vous l’enregistrez.
Agent | Fichier de paramètres gérés | Clés acceptées | Référence |
|---|---|---|---|
Claude Code |
|
|
Si vous supprimez une clé ou si un développeur passe à un workspace dont la configuration ne la définit pas, ug la supprime du fichier de paramètres gérés lors de sa prochaine exécution, sauf si quelqu’un a modifié manuellement la valeur après que ug l’a écrite. Pour supprimer les paramètres écrits par ug, exécutez ug revert.
Si vous définissez allowedMcpServers de Claude Code, ug ajoute les serveurs MCP qu’il enregistre à partir de cette configuration à la liste afin qu’ils restent disponibles. Pour en bloquer un, supprimez-le de mcp_servers.
mcp_servers
mcp_servers sélectionne les serveurs MCP que ug configure enregistre pour chaque développeur du workspace. Ne définir qu'un seul des champs suivants.
Champ | Type | Description |
|---|---|---|
array\ | Serveurs MCP à inclure. Chaque entrée est soit le nom complet Unity Catalog d’un serveur MCP ( | |
| array\ | Noms exacts de ressources Unity Catalog. Utilisez plutôt |
| chaîne | Obsolète. Un catalogue et un schéma ( |
sources
Une liste sources suit les règles suivantes :
- Il peut contenir au plus 100 entrées, sans doublons ni entrées vides.
*n’est autorisé qu’en tant que dernier segment complet, comme danscatalog.schema.*.- L'enregistrement de la configuration échoue si une entrée exacte nomme un serveur MCP qui n'existe pas, ou si une entrée de schéma nomme un schéma qui n'existe pas ou qui n'a pas de serveurs MCP.
Si un schéma dans sources est supprimé ultérieurement, ug configure l'ignore avec un avertissement et enregistre toujours les autres sources.
Les développeurs doivent exécuter ug upgrade pour obtenir une version de ug qui prend en charge sources. Les versions plus anciennes conservent la configuration qu’elles ont appliquée en dernier.
compétences
skills peut contenir l’un des éléments suivants :
Champ | Type | Description |
|---|---|---|
| array\ | Noms exacts des ressources Unity Catalog. |
| chaîne | Un catalogue et un schéma ( |
smart_defaults
Champ | Type | Description |
|---|---|---|
| chaîne (UUID) |
|
| tableau d'objets | Niveaux de dépenses. Le tier supérieur dont le threshold est atteint s'applique. |
niveaux
Chaque entrée de tiers peut contenir les éléments suivants :
Champ | Type | Description |
|---|---|---|
| Nombre | Fraction du budget (0–1) à laquelle ce niveau s’active. Par exemple, |
| chaîne (enum) | Agent default vers lequel basculer. Doit apparaître dans |
| chaîne | Modèle vers lequel basculer par default lorsque ce niveau est actif. |
L’API renvoie également des champs en lecture seule ou gérés par le serveur que vous ne définissez pas, y compris name, workspace_id, create_time, created_user_id, update_time, updated_user_id et retrieved_time.