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-4-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-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 }
}
},
{
"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": {
"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"
}
]
}
}
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 ( |
default_models
default_models est une mappe de clés de modèle default vers des noms de modèle. Les noms de modèle sont des IDs de modèle lorsque la source est un service de fournisseur de modèle, ou des noms de service de modèle Unity Catalog complets autrement. Avec une liste model_services statique, chaque default doit également apparaître dans cette liste.
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 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 ( |
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.