Intégration de LangBot

Difficulté 🧩 Moyenne　|　Format d'interface Compatible OpenAI　|　base_url https://byesu.com/v1

Infos de connexion

Adresse APIhttps://byesu.com/v1

Clé APIsk-xxxxxxxxCréer dans la console →

Modèlegpt-5.5

Format API OpenAI compatible · noms de modèles selon la console

LangBot est une plateforme open source de développement de bots de messagerie instantanée, qui prend en charge de nombreuses plateformes telles que Feishu, DingTalk, WeCom, QQ, Telegram, Discord, Slack, et qui intègre des capacités de base de connaissances, d'Agent et de MCP. En connectant Byesu API à LangBot, vous pouvez piloter votre chatbot avec des modèles comme gpt-5.5, claude-opus-4-8, etc.

Avant de commencer

Rendez-vous d'abord dans Console → Jetons pour créer un jeton API (de la forme sk-xxxx).

Lors de la création, veillez à choisir le bon groupe — le groupe détermine quels modèles vous pouvez appeler et par quelle ligne ils transitent. Si vous ne savez pas comment choisir, consultez Choisir un groupe.

Étape 1 : installer et démarrer LangBot

LangBot propose plusieurs méthodes de déploiement ; le démarrage en une commande avec Docker est recommandé.

Docker (recommandé)

git clone https://github.com/langbot-app/LangBot
cd LangBot
docker compose up -d

Déploiement manuel

# Téléchargez le package d'installation correspondant à votre plateforme depuis Releases
# https://github.com/langbot-app/LangBot/releases
# Décompressez puis démarrez en suivant la documentation

Une fois démarré, ouvrez http://localhost:5300 dans votre navigateur, suivez les instructions pour terminer l'initialisation (définir le nom d'utilisateur et le mot de passe de l'administrateur), puis accédez à l'interface d'administration.

Documentation officielle : https://docs.langbot.app

Étape 2 : ajouter le modèle (saisir base_url + clé)

Dans le menu de gauche de l'interface d'administration de LangBot, accédez à la page de gestion Modèles, cliquez sur Ajouter un modèle, puis remplissez les champs selon le tableau ci-dessous :

Champ	Contenu à saisir
Fournisseur de modèle / URL de requête	https://byesu.com/v1
API Key	Votre jeton sk-xxxx
Nom du modèle	gpt-5.5 (ou claude-opus-4-8, gemini-3.1-pro-high)

La base_url doit comporter /v1

LangBot passe par l'interface compatible OpenAI ; l'adresse de requête doit être https://byesu.com/v1, avec /v1 à la fin. Si vous l'oubliez, vous obtiendrez une erreur 404.

Si la liste des fournisseurs propose une option NewAPI, sélectionnez-la directement, puis changez simplement l'adresse de requête en https://byesu.com/v1 ; sinon, choisissez un fournisseur compatible OpenAI, le résultat est identique.

Le nom du modèle doit correspondre à ce qui est réellement disponible dans votre groupe. Les plus courants :

• Scénarios de conversation : gpt-5.5, claude-opus-4-8
• Texte long / raisonnement : gemini-3.1-pro-high

Étape 3 : activer dans le pipeline et vérifier

1. Accédez à la configuration du Pipeline, puis sélectionnez le modèle ajouté à l'étape 2 dans le choix de modèle du nœud de conversation.
2. Après avoir enregistré, envoyez un message de test dans la fenêtre de débogage de conversation intégrée à l'interface.
3. Si vous recevez une réponse normalement, l'intégration est réussie. Il ne reste plus qu'à lier un compte de plateforme (Feishu, QQ, etc.) pour passer en production.

Base de connaissances (facultatif)

LangBot prend en charge la création d'une base de connaissances vectorielle à l'aide d'un modèle Embedding. Ajoutez un modèle supplémentaire, en saisissant là aussi l'adresse de requête https://byesu.com/v1, et en indiquant comme nom de modèle un modèle Embedding disponible dans votre groupe ; il suffit ensuite de le sélectionner lors de la création d'une nouvelle base de connaissances.

Bloqué ?

• 401 / Échec d'authentification : la clé API est incorrecte ou contient des espaces superflus ; retournez dans la Console pour recopier intégralement votre sk-xxxx. Voir Erreurs courantes #auth.
• 404 / Interface introuvable : l'adresse de requête a omis /v1 ; elle doit être https://byesu.com/v1.
• Aucun canal disponible / modèle inexistant : le groupe de votre jeton ne contient pas ce modèle ; changez de nom de modèle ou recréez un jeton en choisissant le bon groupe. Voir Choisir un groupe et Erreurs courantes #no-channel.
• Solde insuffisant : le crédit de votre compte est épuisé ; rechargez puis réessayez. Voir Erreurs courantes #balance.

Pour plus de dépannage, consultez Erreurs courantes.