Подключение LangBot
Сложность 🧩 Средняя | Формат интерфейса Совместимый с OpenAI | base_url
https://byesu.com/v1
https://byesu.com/v1gpt-5.5LangBot — это открытая платформа для разработки ботов мгновенного обмена сообщениями. Она поддерживает множество платформ, таких как Feishu, DingTalk, WeCom, QQ, Telegram, Discord, Slack, и имеет встроенные возможности базы знаний, Agent и MCP. Подключив Byesu API к LangBot, вы сможете управлять своим чат-ботом с помощью моделей gpt-5.5, claude-opus-4-8 и других.
Прежде чем начать
Сначала зайдите в Консоль → Токены и создайте API-токен (вида sk-xxxx).
При создании обязательно выберите правильную группу — группа определяет, какие модели вы можете вызывать и по какому маршруту они пойдут. Если не уверены, как выбрать, см. Выбор группы.
Шаг 1: Установите и запустите LangBot
LangBot предлагает несколько способов развёртывания, рекомендуется запуск одной командой через Docker.
git clone https://github.com/langbot-app/LangBot
cd LangBot
docker compose up -d# Скачайте установочный пакет для вашей платформы из Releases
# https://github.com/langbot-app/LangBot/releases
# Распакуйте и запустите по инструкции документацииПосле запуска откройте в браузере http://localhost:5300, выполните инициализацию по подсказкам (задайте логин и пароль администратора) и войдите в панель управления.
Официальная документация: https://docs.langbot.app
Шаг 2: Добавьте модель (укажите base_url + ключ)
В панели управления LangBot перейдите слева на страницу управления Модели, нажмите Добавить модель и заполните поля по таблице ниже:
| Поле | Что вписать |
|---|---|
| Поставщик модели / URL запроса | https://byesu.com/v1 |
| API Key | Ваш токен sk-xxxx |
| Название модели | gpt-5.5 (или claude-opus-4-8, gemini-3.1-pro-high) |
base_url должен содержать /v1
LangBot работает через интерфейс, совместимый с OpenAI, поэтому адрес запроса должен быть https://byesu.com/v1, с /v1 в конце. Если его пропустить, возникнет ошибка 404.
Если в списке поставщиков есть вариант NewAPI, выберите его и просто измените адрес запроса на https://byesu.com/v1; если такого варианта нет, выберите поставщика, совместимого с OpenAI, — результат будет тот же.
Название модели должно соответствовать тому, что реально доступно в вашей группе. Часто используемые:
- Сценарии диалога:
gpt-5.5,claude-opus-4-8 - Длинные тексты / рассуждения:
gemini-3.1-pro-high
Шаг 3: Включите в конвейере и проверьте
- Перейдите к настройке Конвейера (Pipeline) и в выборе модели для узла диалога укажите модель, добавленную на шаге 2.
- После сохранения отправьте сообщение для проверки в окне Отладка диалога, встроенном в панель управления.
- Если ответ приходит нормально — подключение прошло успешно. Затем останется только привязать аккаунты платформ Feishu / QQ и других, чтобы запустить бота.
База знаний (необязательно)
LangBot поддерживает создание векторной базы знаний с помощью модели Embedding. Добавьте ещё одну модель, в адресе запроса так же укажите https://byesu.com/v1, в названии модели впишите доступную в группе модель Embedding, а затем выберите её при создании новой базы знаний.
Застряли?
- 401 / Ошибка аутентификации: API Key введён неверно или содержит лишние пробелы. Вернитесь в Консоль и заново скопируйте полный
sk-xxxx. Подробнее см. Частые ошибки #auth. - 404 / Интерфейс не найден: в адресе запроса пропущен
/v1, должно бытьhttps://byesu.com/v1. - Нет доступных каналов / модель не существует: в группе токена нет этой модели. Смените название модели или пересоздайте токен, выбрав правильную группу. См. Выбор группы и Частые ошибки #no-channel.
- Недостаточно средств: квота аккаунта исчерпана, пополните баланс и повторите. См. Частые ошибки #balance.
Больше способов диагностики см. в Частых ошибках.
