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-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"
}
]
}
}
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 configuré par cette entrée. 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, lorsque cela est pris en charge. Prend un seul booléen |
| Carte | En-têtes joints à chaque requête de passerelle provenant de cet agent, sous forme de paires de chaînes clé-valeur. |
| objet | Traçage côté client par agent. Prend une seule valeur booléenne |
| 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 table de correspondance associant des clés de default à des noms de modèle. default_model définit la valeur par default globale pour tout agent. Les clés par famille (default_opus_model, default_sonnet_model, default_haiku_model et default_fable_model) s'appliquent uniquement à Claude Code. Les noms de modèle sont des ID de modèle lorsque la source est un service de fournisseur de modèles, ou des noms de service de modèle Unity Catalog complets dans les autres cas. Avec une liste statique model_services, chaque default doit également figurer dans cette liste.
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 vers lequel basculer default. 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.