Hướng dẫn kết nối nhà cung cấp AI

Trước khi bắt đầu#

Bài này hướng dẫn admin kết nối nhà cung cấp AI dùng chung cho các tính năng AI Agent của ChatHub: gợi ý câu trả lời, tóm tắt hội thoại và bot tự trả lời. Bạn sẽ chọn nhà cung cấp, nhập API key, chọn model, lưu và kiểm tra kết nối.

1. 1

   Dùng tài khoản có quyền truy cập và lưu Cài đặt của ChatHub.

2. 2

   Chuẩn bị API key của nhà cung cấp muốn dùng và kiểm tra tài khoản API có quyền sử dụng model đó. Chi phí sử dụng được thanh toán trực tiếp với nhà cung cấp.

3. 3

   Nếu dùng API tùy chỉnh, chuẩn bị thêm URL API gốc và mã model do đơn vị cung cấp API hướng dẫn.

1. Mở Nhà cung cấp AI#

1. 1

   Trong ChatHub, mở Quản trị → Cài đặt.

2. 2

   Chọn Nhà cung cấp AI ở cột trái, hoặc mở /settings?tab=ai trên tên miền ChatHub của bạn.

3. 3

   Tìm khối Nhà cung cấp AI ở đầu trang. Các trường chính gồm Nhà cung cấp, API key, Model và công tắc Bật tính năng AI. Bên dưới là Lưu và Kiểm tra kết nối.

2. Chọn nhà cung cấp và lấy API key#

1. 1

   OpenAI: chọn OpenAI trong Nhà cung cấp. Dùng liên kết OpenAI tại dòng “Lấy khoá trong trang quản lý của” để mở trang quản lý khóa.

2. 2

   DeepSeek: chọn DeepSeek và dùng liên kết DeepSeek dưới ô Model để mở trang quản lý khóa tương ứng.

3. 3

   API tùy chỉnh: chọn khi nhà cung cấp hoặc gateway của bạn hỗ trợ định dạng API tương thích OpenAI. Lấy khóa, URL gốc và mã model từ đơn vị cung cấp dịch vụ đó.

Trang API key OpenAI được liên kết trong ChatHub ↗

Trang API key DeepSeek được liên kết trong ChatHub ↗

Tại trang quản lý của nhà cung cấp, đăng nhập tài khoản của bạn và tạo hoặc lấy API key theo hướng dẫn ở đó. Sao chép khóa để nhập vào ChatHub. Bài này minh họa cấu hình trong ChatHub, không thao tác tạo khóa hay thay đổi thanh toán ở bên nhà cung cấp.

3. Nhập khóa, model và bật AI#

1. 1

   API key: ở lần cấu hình đầu tiên, dán khóa của nhà cung cấp đã chọn. Nếu hệ thống đã có khóa, nhãn đổi thành API key mới.

2. 2

   Model: nhập đúng mã model nhà cung cấp cho phép tài khoản của bạn dùng. Có thể chọn gợi ý hoặc gõ trực tiếp. Để trống thì ChatHub dùng model mặc định của nhà cung cấp trong phiên bản đang chạy.

3. 3

   Kiểm tra lại Model sau khi đổi Nhà cung cấp: ChatHub xóa lựa chọn model trước đó và trả về gợi ý mặc định của nơi vừa chọn.

4. 4

   Bật công tắc Bật tính năng AI để cho phép các tính năng gọi AI. Nếu cần ngừng gọi AI, tắt công tắc rồi Lưu; khóa vẫn được giữ lại.

ChatHub mã hóa khóa khi lưu và không gửi khóa đã lưu ngược về trình duyệt. Nhãn Đã cấu hình chỉ cho biết đã có khóa; chưa chứng minh khóa còn hiệu lực, model dùng được hoặc AI đang bật.

4. Nếu dùng API tùy chỉnh#

1. 1

   Chọn API tùy chỉnh để hiện thêm trường URL API.

2. 2

   Nhập URL gốc do nhà cung cấp cung cấp, gồm phần phiên bản nếu dịch vụ yêu cầu. Ví dụ minh họa: https://api.example.com/v1 — thay bằng URL thật của bạn.

3. 3

   Không thêm /chat/completions hoặc /models vào cuối URL. Không gắn API key, thông tin đăng nhập, query (?...) hay fragment (#...) vào URL; khóa phải ở ô API key riêng.

4. 4

   Nhập API key và mã Model của dịch vụ tùy chỉnh. Không mặc định rằng model gợi ý trong ChatHub có ở mọi gateway.

5. 5

   Bật tính năng AI, sau đó Lưu và Kiểm tra kết nối như bước tiếp theo.

URL phải là HTTP hoặc HTTPS hợp lệ. Dịch vụ cần tương thích các đường dẫn mà ChatHub dùng: /models để kiểm tra kết nối và /chat/completions để gọi AI. Dùng đúng URL gốc được nhà cung cấp công bố.

5. Lưu rồi kiểm tra kết nối#

1. 1

   Rà lại Nhà cung cấp, API key, Model, công tắc AI và URL API nếu có.

2. 2

   Bấm Lưu và chờ thông báo “Đã lưu cấu hình AI.”

3. 3

   Bấm Kiểm tra kết nối. Khi chưa có khóa đã lưu, nút này bị vô hiệu hóa.

4. 4

   Đọc kết quả: thông báo “Gọi được …, model …, mất …ms.” cho biết nhà cung cấp đã trả lời. Kiểm tra tên nhà cung cấp và model có khớp lựa chọn vừa lưu không.

Nếu thông báo thêm “model này không có trong danh sách nhà cung cấp trả về”, đối chiếu lại mã model và quyền truy cập ở nhà cung cấp, sửa rồi Lưu và kiểm tra lại. Một số dịch vụ không liệt kê đầy đủ model, nên cần kiểm tra thêm bằng tính năng AI thực tế.

Nút kiểm tra lấy danh sách model, không gửi một câu hội thoại để AI trả lời. Vì vậy, kiểm tra thành công chưa bảo đảm mọi tính năng sinh câu trả lời đều hoạt động. Sau đó hãy thử một tính năng AI trên hội thoại thử có nội dung phù hợp để gửi tới nhà cung cấp.

6. Các lỗi thường gặp và bước tiếp theo#

1. 1

   “Cần nhập API key.”: lần đầu cấu hình chưa có khóa. Nhập khóa rồi Lưu.

2. 2

   “Cần nhập URL API HTTP hoặc HTTPS hợp lệ.”: kiểm tra URL của API tùy chỉnh; bỏ query, fragment, thông tin đăng nhập và dùng đúng URL gốc.

3. 3

   Báo chưa cấu hình dù đã có khóa: kiểm tra đã chọn nhà cung cấp, Bật tính năng AI đang bật và đã Lưu. Với API tùy chỉnh, kiểm tra thêm URL API.

4. 4

   Nhà cung cấp từ chối yêu cầu: đọc mã trạng thái và chi tiết lỗi hiển thị để kiểm tra khóa, quyền sử dụng hoặc tài khoản API theo thông báo cụ thể.

5. 5

   Không kết nối được: kiểm tra địa chỉ API và khả năng kết nối từ máy chủ chạy ChatHub đến nhà cung cấp. Việc mở trang quản lý được trên máy bạn chưa chứng minh máy chủ ChatHub gọi API được.

6. 6

   Kiểm tra thành công nhưng tính năng AI chưa chạy: kiểm tra thêm model và cấu hình của chính tính năng AI đó. Kết nối nhà cung cấp là bước nền tảng, không thay thế thiết lập bot hoặc luồng tự động hóa.

Phần Tài liệu huấn luyện AI bên dưới là nơi bổ sung nội dung hỏi–đáp của shop; không phải ô nhập API key. Bạn có thể cấu hình nội dung huấn luyện và các tính năng AI sau khi kết nối nhà cung cấp hoàn tất.