Tích hợp LangBot

Độ khó 🧩 Trung bình　|　Định dạng giao diện Tương thích OpenAI　|　base_url https://byesu.com/v1

Thông tin kết nối

Địa chỉ APIhttps://byesu.com/v1

Khóa APIsk-xxxxxxxxTạo trong bảng điều khiển →

Mô hìnhgpt-5.5

Định dạng API OpenAI tương thích · tên mô hình theo bảng điều khiển

LangBot là một nền tảng phát triển bot nhắn tin tức thời mã nguồn mở, hỗ trợ nhiều nền tảng như Feishu, DingTalk, WeCom, QQ, Telegram, Discord, Slack, đồng thời tích hợp sẵn cơ sở tri thức, Agent và khả năng MCP. Khi đưa Byesu API vào LangBot, bạn có thể dùng các mô hình như gpt-5.5, claude-opus-4-8 để vận hành chatbot của mình.

Trước khi bắt đầu

Trước tiên hãy vào Bảng điều khiển → Token để tạo một token API (dạng sk-xxxx).

Khi tạo, nhất định phải chọn đúng nhóm — nhóm sẽ quyết định bạn có thể gọi những mô hình nào và đi theo tuyến nào. Nếu chưa rõ cách chọn, xem Chọn nhóm.

Bước 1: Cài đặt và khởi động LangBot

LangBot cung cấp nhiều cách triển khai, khuyến nghị khởi động bằng Docker chỉ với một thao tác.

Docker (khuyến nghị)

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

Triển khai thủ công

# Tải gói cài đặt cho nền tảng của bạn từ Releases
# https://github.com/langbot-app/LangBot/releases
# Giải nén rồi khởi động theo tài liệu

Sau khi khởi động, mở http://localhost:5300 trên trình duyệt, làm theo hướng dẫn để hoàn tất khởi tạo (đặt tài khoản và mật khẩu quản trị viên), rồi vào trang quản trị.

Tài liệu chính thức: https://docs.langbot.app

Bước 2: Thêm mô hình (điền base_url + Key)

Trong trang quản trị LangBot, ở menu bên trái vào trang quản lý Mô hình, nhấn Thêm mô hình, rồi điền theo bảng dưới đây:

Trường	Nội dung điền
Nhà cung cấp mô hình / URL yêu cầu	https://byesu.com/v1
API Key	Token của bạn sk-xxxx
Tên mô hình	gpt-5.5 (hoặc claude-opus-4-8, gemini-3.1-pro-high)

base_url phải có /v1

LangBot dùng giao diện tương thích OpenAI, địa chỉ yêu cầu bắt buộc phải là https://byesu.com/v1, kết thúc bằng /v1. Thiếu nó sẽ báo lỗi 404.

Nếu trong danh sách nhà cung cấp có tùy chọn NewAPI, hãy chọn luôn nó, rồi đổi địa chỉ yêu cầu thành https://byesu.com/v1 là được; nếu không có thì chọn nhà cung cấp tương thích OpenAI, hiệu quả như nhau.

Tên mô hình phải khớp với mô hình thực sự khả dụng trong nhóm. Thường dùng:

• Tình huống hội thoại: gpt-5.5, claude-opus-4-8
• Văn bản dài / suy luận: gemini-3.1-pro-high

Bước 3: Bật trong pipeline và kiểm tra

1. Vào cấu hình Pipeline, ở phần chọn mô hình của nút hội thoại, chọn mô hình đã thêm ở Bước 2.
2. Sau khi lưu, gửi một câu để kiểm tra trong cửa sổ Gỡ lỗi hội thoại có sẵn trong trang quản trị.
3. Nếu nhận được phản hồi bình thường, nghĩa là tích hợp thành công. Tiếp đó chỉ cần liên kết tài khoản các nền tảng như Feishu / QQ là có thể đưa lên hoạt động.

Cơ sở tri thức (tùy chọn)

LangBot hỗ trợ dùng mô hình Embedding để tạo cơ sở tri thức vector. Hãy thêm thêm một mô hình nữa, địa chỉ yêu cầu cũng điền https://byesu.com/v1, tên mô hình điền mô hình Embedding khả dụng trong nhóm, sau đó khi tạo cơ sở tri thức mới thì chọn nó là được.

Bị kẹt?

• 401 / Xác thực thất bại: API Key điền sai hoặc có khoảng trắng thừa, hãy quay lại Bảng điều khiển để sao chép lại đầy đủ sk-xxxx. Xem chi tiết tại Lỗi thường gặp #auth.
• 404 / Không tìm thấy giao diện: Địa chỉ yêu cầu thiếu /v1, phải là https://byesu.com/v1.
• Không có kênh khả dụng / Mô hình không tồn tại: Nhóm của token không có mô hình này, hãy đổi tên mô hình khác hoặc tạo lại token với đúng nhóm. Xem Chọn nhóm và Lỗi thường gặp #no-channel.
• Không đủ số dư: Hạn mức tài khoản đã hết, nạp tiền rồi thử lại. Xem Lỗi thường gặp #balance.

Xem thêm cách khắc phục tại Lỗi thường gặp.