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": "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
config définit la source du 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 à l'aiguillage intelligent, là où il est pris en charge. Accepte 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 |
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. |
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.