Résolveur de capacités

L'écran Résolveur de capacités permet de voir comment un niveau d'effort de raisonnement et les paramètres d'un appel sont traduits en paramètres natifs d'un modèle, ou pourquoi ils sont rejetés, sans appeler le modèle. Chemin dans le portail : /llm/resolver. Il est utilisé par les développeurs et les ingénieurs de la plateforme IA qui préparent un appel, et par le support qui explique un refus. L'écran est construit dans portal/src/screens/llm-tools.tsx (Resolver, resolverCfg, ResolveResult).

Ce que montre l'écran

Un panneau Résoudre les paramètres (« POST /v1/models/resolve avec un niveau d'effort et des paramètres d'appel. ») en deux parties.

Le formulaire, sur deux colonnes :

Champ	Contenu
Modèle	Identifiant du modèle dans le registre (obligatoire).
Effort	none, low, medium, high ou max (obligatoire).
Température	Nombre.
Top P	Nombre.
Jetons max	Nombre, contrôlé par rapport à la limite du modèle.
Format de réponse	text, json_object ou json_schema.
Choix d'outil	auto, none ou required.
Streaming	Oui ou non.
Paramètres supplémentaires	Objet JSON fusionné dans le corps de la requête (défaut {}).

Le Résultat, après Exécuter :

• un bandeau Accepté (vert) ou Rejeté (rouge), avec la raison quand l'API en donne une ;
• les avertissements du résolveur, un par ligne ;
• Paramètres natifs : le JSON envoyé au fournisseur pour ce modèle ;
• Réponse brute, repliée, avec la réponse complète.

Avant la première exécution, la zone de résultat indique « Lancez la requête pour voir le résultat ici. »

Actions

Bouton ou action	Ce qu'il fait	Appel d'API	Rôles
Exécuter	Envoie le modèle, l'effort et les paramètres (les Paramètres supplémentaires sont fusionnés au premier niveau) et affiche la résolution.	POST /v1/models/resolve	lecteurs LLM
Réponse brute	Déplie la réponse JSON complète.	aucun	tout le monde

Rôles

• POST /v1/models/resolve exige l'un des rôles READ de services/control-plane/src/eai/domains/llm/__init__.py, qui sont les llmReaders de portal/src/lib/kit.ts : tenant_admin, platform_admin, security_officer, finops, developer, auditor, viewer, agent, ai_platform_engineer, ai_governance_officer, support_engineer.
• Le portail ne restreint pas le formulaire : le serveur décide.

Tâches courantes

Vérifier qu'un modèle accepte un effort de raisonnement

1. Choisir le modèle. Saisissez son identifiant de registre dans Modèle, tel qu'affiché dans le Registre des modèles. Résultat attendu : le champ est rempli. En cas d'échec : « Modèle <model_id> introuvable. » signifie que l'identifiant est faux.
2. Régler l'effort. Choisissez Effort high et laissez les autres champs vides, pour tester l'effort seul. Résultat attendu : le formulaire est valide. En cas d'échec : Obligatoire sous Effort.
3. Exécuter. Cliquez sur Exécuter. Résultat attendu : Accepté et les Paramètres natifs que reçoit le fournisseur. En cas d'échec : « L'effort de raisonnement <demandé> n'est pas pris en charge par ce modèle. » (effort_not_supported) ; choisissez un niveau listé dans les Modes de raisonnement du modèle.

La même vérification en ligne de commande (voir docs/sdks/cli-reference.md) :

enterprise-ai models --effort high resolve <model-id>

<model-id> : identifiant du modèle dans le registre.

Valider les paramètres d'un appel à sortie structurée

1. Remplir l'appel. Réglez Modèle, Effort, Jetons max et Format de réponse json_schema, et placez le schéma dans Paramètres supplémentaires, pour que le résolveur voie le même corps que l'appel réel. Résultat attendu : un JSON valide dans Paramètres supplémentaires. En cas d'échec : JSON invalide.
2. Exécuter. Cliquez sur Exécuter. Résultat attendu : Accepté, éventuellement avec des avertissements. En cas d'échec : « max_tokens dépasse la limite du modèle (<n>). » ou « Le paramètre response_format est invalide. » (schéma manquant) ; corrigez la valeur et exécutez à nouveau.

Dépannage

Symptôme	Cause	Correction
« Modèle <model_id> introuvable. » (model_not_found)	Identifiant de registre inconnu.	Copiez l'identifiant depuis le Registre des modèles.
« L'effort de raisonnement <demandé> n'est pas pris en charge par ce modèle. » (effort_not_supported, 422)	Le niveau est hors des modes de raisonnement du modèle.	Choisissez un niveau pris en charge, ou none.
« Le paramètre <paramètre> n'est pas pris en charge par ce modèle. » (parameter_not_supported, 422)	Le modèle n'accepte pas ce paramètre.	Retirez-le du formulaire ou des Paramètres supplémentaires.
« Le paramètre <paramètre> est hors de la plage autorisée. » (parameter_out_of_range, 422)	Valeur hors des bornes du modèle, par exemple Température.	Utilisez une valeur dans la plage.
« max_tokens dépasse la limite du modèle (<n>). » (max_tokens_exceeded, 422)	Jetons max au-dessus des Jetons de sortie max du modèle.	Baissez Jetons max.
« Le paramètre <paramètre> est invalide. » (parameter_invalid, 422)	Valeur fausse, par exemple json_schema sans schéma.	Corrigez la valeur citée dans le message.
« La modalité d'entrée <modalité> n'est pas prise en charge par ce modèle. » (modality_not_supported, 422)	Les Paramètres supplémentaires contiennent une entrée image, audio ou vidéo que le modèle ne prend pas.	Choisissez un modèle qui a cette modalité.
JSON invalide sous Paramètres supplémentaires	Le champ n'est pas un objet JSON.	Saisissez un objet JSON, {} s'il est vide.

Pages liées

• Registre des modèles
• Budget de contexte
• Playground passerelle
• Résolveur de capacités des modèles (B-06)
• Politique d'effort de raisonnement (B-07)