Une passerelle, plusieurs protocoles : qu'est-ce qui fonctionne vraiment ?
Vérifiez la compatibilité entre modèle et interface avant de perdre un paramètre pendant la conversion.

Partez du besoin
Deux interfaces de conversation peuvent avoir des comportements différents. Votre application a-t-elle besoin de texte seul, d'images, d'une sortie structurée ou d'outils ? Choisissez un modèle et une interface qui documentent ensemble ces fonctions. Une forme compatible ne garantit pas la prise en charge de tous les champs.
Des noms d’interface proches indiquent généralement des structures apparentées, sans garantir que chaque modèle comprend tous les paramètres. Réglages d’échantillonnage, limites de sortie, format structuré, images et outils peuvent différer. Fournisseur, passerelle et client peuvent chacun valider ou convertir les données. Testez séparément l’accès de base et les capacités indispensables au produit.
Créez une petite matrice
Pour chaque couple modèle-interface, notez les entrées, le streaming, les outils, le format de sortie et les limites. Testez chaque capacité essentielle avec une requête minimale. Une réponse textuelle réussie ne prouve pas que les images ou les outils fonctionneront.
Une requête texte réussie ne prouve pas que le streaming, les outils et les images fonctionnent avec le même modèle. Vérifiez fin de flux, noms d’outils, forme des arguments, méthode d’entrée d’image et erreurs en cas de non-prise en charge. Ne généralisez pas les champs d’un fournisseur : consultez la documentation actuelle du modèle et de l’interface.
Conservez quelques cas représentatifs : texte, limites de paramètres, flux interrompu, outils et entrées multimodales nécessaires. Relancez-les après un changement de modèle, client ou passerelle, et comparez aussi la structure des réponses. Retirez secrets et données clients des exemples. Documentez les parcours touchés et le retour arrière avant une mise en production.
Une bonne fiche indique version du modèle, interface, catégorie d’entrée, résultat attendu, résultat observé et date. Évitez le seul mot « compatible » : une combinaison peut accepter le texte mais refuser une certaine entrée d’image. Laissez les champs non testés inconnus jusqu’à leur vérification.
Un adaptateur relie deux protocoles, sans nécessairement transmettre toutes leurs fonctions.Examinez la requête et la réponse
Conservez des exemples anonymisés dans vos tests. Vérifiez si les champs facultatifs sont refusés, ignorés ou transformés, et si la réponse contient les données attendues. Ne publiez jamais de clé, de prompt privé ou de contenu client dans les tests. Recommencez après un changement de modèle ou de fournisseur.
Pour chaque paramètre important, notez s’il est accepté et effectif, refusé, ignoré ou transformé avec un autre sens. Examinez requête et réponse, notamment la différence entre champ absent et zéro ou false explicite. Un statut réussi ne prouve pas l’effet du paramètre. Utilisez des entrées révélatrices et gardez des résultats anonymisés dans les tests de régression.
Prévoyez les différences
Désactivez dans l'interface les options que le modèle ne prend pas en charge, ou choisissez une autre interface si la fonction est indispensable. Affichez une erreur utile au lieu de supprimer silencieusement une instruction. Gardez la documentation à côté de vos résultats de test.
Un champ non testé doit rester « inconnu », pas « pris en charge ». Notez date, modèle, interface, résultat et limites. Si une capacité ne peut pas être convertie, désactivez l’option, expliquez la limite ou proposez un autre modèle. Lorsqu’une différence change le sens d’une demande, une erreur explicite vaut mieux qu’une instruction supprimée silencieusement.
Vérifier le sens réel de chaque champ
La compatibilité ne consiste pas seulement à renommer des champs. Une API peut représenter le contenu d’un message par une chaîne, une autre par des blocs de texte et d’image. Les instructions système, les outils et les raisons de fin peuvent également différer.
Testez séparément un champ absent, une valeur vide et un zéro ou un faux explicite. Si une fonction ne peut pas être convertie, signalez-le ou proposez une solution vérifiée. Supprimer silencieusement une image ou une instruction rend le problème difficile à comprendre.
Tester séparément le streaming et les appels d’outils
Pour le streaming, vérifiez les frontières des événements, les fragments de contenu, la fin et les erreurs. Un appel d’outil peut arriver en plusieurs fragments : reconstituez puis validez ses arguments avant toute exécution.
La proposition du modèle ne vaut pas autorisation. Contrôlez les droits de l’utilisateur, gérez l’échec de l’outil et renvoyez son résultat au format attendu. Pour une sortie structurée, vérifiez aussi la gestion des réponses qui ne respectent pas le schéma.
Maintenir un registre de compatibilité à jour
Tenez un registre par combinaison : modèle et version, interface, types d’entrée, streaming, outils, format de sortie, date et résultat. Distinguez les fonctions validées, échouées et non testées ; n’utilisez pas de clés réelles dans les exemples.
Pour un assistant de suivi de commande, testez la question normale, les arguments manquants, l’accès refusé et le délai dépassé. Après tout changement de modèle ou de configuration, rejouez les mêmes cas et prévoyez une solution de repli vérifiée.
Un exemple concret
Un assistant de support doit répondre en texte et consulter une fiche client. Soumettez la même question à chaque modèle, puis testez une recherche valide et un argument mal formé. Notez si le modèle demande l’outil, si le serveur rejette l’entrée incorrecte et si la réponse utilise le résultat. Si vous ajoutez des images, testez cette capacité séparément.