Connecter un fournisseur de modèles
Renseigner le type d’API, le point de terminaison, la clé API et l’identifiant du modèle, comprendre l’URL construite par Yenpo et résoudre les erreurs courantes.
L’AI Reader utilise le fournisseur sélectionné dans les réglages. Votre compte fournisseur détermine les modèles accessibles et leur coût. Lire et rechercher des fichiers ne nécessite pas cette connexion.
Ajouter un fournisseur
Ouvrez Réglages → Modèles, cliquez sur Ajouter un fournisseur (bouton plus) et sélectionnez la nouvelle entrée comme Fournisseur actuel. Donnez-lui un nom reconnaissable, par exemple « Passerelle d’équipe ». Ce nom est une simple étiquette et ne détermine pas l’API utilisée.
Renseignez ensuite :
| Champ | Valeur à saisir |
|---|---|
| Type d’API | Protocole du service : OpenAI Chat Completions, OpenAI Responses ou Anthropic Messages |
| Point de terminaison | URL du service, avec tout préfixe de chemin requis par votre passerelle |
| Authentification / Clé API | Votre clé API ou l’option de connexion proposée par le fournisseur |
| Modèle | Identifiant exact d’un modèle accessible à votre compte |
Saisissez les clés API uniquement dans les réglages, jamais dans une discussion ou un fichier du projet. Certains fournisseurs proposent une connexion au compte à la place d’une clé ; choisissez-la sous Méthode de connexion si elle est disponible.
Faire correspondre point de terminaison et type d’API
Le nom du modèle ne révèle pas le protocole : une passerelle peut proposer des noms similaires via différentes API. Suivez sa documentation et conservez les préfixes de chemin requis.
Ces URL montrent comment Yenpo construit l’URL de requête. Ce sont des exemples, pas des services fonctionnels :
| Type d’API | Exemple de point de terminaison | URL de requête obtenue |
|---|---|---|
| Chat Completions | https://gateway.example/v1 |
https://gateway.example/v1/chat/completions |
| Responses | https://gateway.example |
https://gateway.example/v1/responses |
| Messages | https://gateway.example |
https://gateway.example/v1/messages |
Si le point de terminaison finit déjà par /chat/completions, /responses ou /messages, Yenpo l’utilise tel quel pour le type d’API correspondant. Pour Responses et Messages, le dernier segment est ajouté à un point de terminaison finissant par /v1. Chat Completions ajoute toujours /chat/completions à votre saisie et ne complète pas un /v1 manquant.
En cas d’erreur, ne changez pas de type d’API au hasard jusqu’à ce qu’elle disparaisse. Identifiez le protocole pris en charge et le chemin complet attendu.
Identifiant du modèle
Saisissez l’identifiant dans Modèle, ou cliquez sur Récupérer la liste si le service publie une liste de modèles. Récupérer la liste et appeler le modèle sont deux requêtes distinctes : le modèle peut fonctionner même si la récupération échoue. Essayez de saisir directement l’identifiant documenté.
La Longueur du contexte affecte les budgets d’entrée et de sortie de Yenpo, le moment où la discussion est condensée et le contexte conservé ensuite. Saisissez la limite documentée du modèle ; laisser le champ vide utilise la valeur par défaut de Yenpo. Une valeur trop faible peut entraîner des condensations inutiles, une valeur trop élevée des requêtes rejetées.
Les Tarifs servent à calculer le coût estimé dans les détails d’exécution. Utilisez ceux de votre fournisseur ; ces valeurs ne changent pas la facturation réelle et ne donnent pas accès aux modèles. Pour établir la première connexion, laissez les autres réglages inchangés.
L’entrée d’images est désactivée par défaut pour chaque fournisseur. Activez Accepter les images uniquement si le modèle et l’API acceptent les images prévues.
Tester avec une petite question
Ouvrez un petit fichier que vous êtes autorisé à envoyer à ce service et demandez :
Que renvoie cette fonction pour une entrée vide ? Cite la branche concernée.
Si une réponse arrive, la connexion fonctionne. Son exactitude est une autre question : vérifiez-la dans le code.
Une requête contient votre message et le code pertinent trouvé par l’AI Reader dans le projet, pas seulement ce que vous avez saisi. Lisez Données, autorisation de modification et terminal avant d’envoyer du code confidentiel à un point de terminaison distant.
En cas d’échec d’une requête
| Symptôme | À vérifier |
|---|---|
| Erreur d’authentification ou d’autorisation | Compte ou clé sélectionné, propriétaire du point de terminaison, accès au modèle |
| Ressource introuvable ou API non prise en charge | Type d’API et chemin complet, y compris les préfixes de passerelle |
| Modèle introuvable | Identifiant exact du modèle et accès de votre compte |
| Échec de récupération des modèles | Le service publie-t-il une liste ? Sinon, saisissez l’identifiant documenté |
| Délai dépassé ou flux interrompu | Accès réseau, comportement du proxy ou de la passerelle, disponibilité du fournisseur |
Un statut HTTP seul explique rarement la cause, et les passerelles peuvent réécrire les erreurs en amont. Pour signaler un problème, incluez le message d’erreur, le type d’API et le point de terminaison après retrait des informations privées. N’incluez jamais la clé API.
Si une exécution autorisée à modifier les fichiers a été interrompue, vérifiez l’arbre de travail avant de réessayer. Des fichiers peuvent avoir changé sans qu’une réponse finale soit arrivée.