Skip to content

Подключение LangBot

Сложность 🧩 Средняя | Формат интерфейса Совместимый с OpenAI | base_url https://byesu.com/v1

Данные подключения
Адрес APIhttps://byesu.com/v1
Модельgpt-5.5
Формат API OpenAI совместимо · имена моделей — по консоли

LangBot — это открытая платформа для разработки ботов мгновенного обмена сообщениями. Она поддерживает множество платформ, таких как 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.

bash
git clone https://github.com/langbot-app/LangBot
cd LangBot
docker compose up -d
bash
# Скачайте установочный пакет для вашей платформы из 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: Включите в конвейере и проверьте

  1. Перейдите к настройке Конвейера (Pipeline) и в выборе модели для узла диалога укажите модель, добавленную на шаге 2.
  2. После сохранения отправьте сообщение для проверки в окне Отладка диалога, встроенном в панель управления.
  3. Если ответ приходит нормально — подключение прошло успешно. Затем останется только привязать аккаунты платформ Feishu / QQ и других, чтобы запустить бота.

База знаний (необязательно)

LangBot поддерживает создание векторной базы знаний с помощью модели Embedding. Добавьте ещё одну модель, в адресе запроса так же укажите https://byesu.com/v1, в названии модели впишите доступную в группе модель Embedding, а затем выберите её при создании новой базы знаний.

Застряли?

  • 401 / Ошибка аутентификации: API Key введён неверно или содержит лишние пробелы. Вернитесь в Консоль и заново скопируйте полный sk-xxxx. Подробнее см. Частые ошибки #auth.
  • 404 / Интерфейс не найден: в адресе запроса пропущен /v1, должно быть https://byesu.com/v1.
  • Нет доступных каналов / модель не существует: в группе токена нет этой модели. Смените название модели или пересоздайте токен, выбрав правильную группу. См. Выбор группы и Частые ошибки #no-channel.
  • Недостаточно средств: квота аккаунта исчерпана, пополните баланс и повторите. См. Частые ошибки #balance.

Больше способов диагностики см. в Частых ошибках.

Возникла проблема? Напишите в поддержку или в наш чат.