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. Quét tài liệu từ website#

Sau khi nhà cung cấp AI hoạt động, bạn có thể biến nội dung trên website tài liệu thành các mục hỏi–đáp để AI tra cứu. ChatHub quét thử trên máy chủ, bỏ menu, thanh bên và bình luận; trang mục lục chỉ được dùng để tìm đường đến bài viết. Lượt quét thử chỉ tạo bản xem trước, chưa lưu tài liệu.

1. 1

   Trong Tài liệu huấn luyện AI, bấm Quét từ website.

2. 2

   Dán đường dẫn HTTPS đầy đủ vào Địa chỉ trang tài liệu. Ví dụ trong bài này dùng https://help.cmsnt.co/. Nên trỏ thẳng vào trang mục lục hoặc nhánh tài liệu cần dùng thay vì một trang không liên quan.

3. 3

   Bấm dòng tuỳ chọn nếu cần đổi phạm vi. Chỉ trong mục này chỉ đi theo các liên kết cùng nhánh đường dẫn; Cả tên miền có thể đi tới mọi liên kết cùng tên miền. Chọn Số trang tối đa từ 1 đến 40; mặc định là 12.

4. 4

   Bấm Quét thử và chờ máy chủ đọc từng trang. Không đóng hộp thoại trong lúc đang quét.

5. 5

   Đọc bốn chỉ số Mục hỏi–đáp, Bài viết, Trang mục lục và Trang bỏ qua. Kiểm tra danh sách Các trang đã quét để phát hiện nhánh không liên quan, trang không đọc được hoặc trang bị robots.txt chặn.

6. 6

   Đọc kỹ Xem trước vì đây chính là nội dung AI sẽ dùng. Nếu kết quả chưa đúng, đổi địa chỉ, phạm vi hoặc giới hạn trang rồi Quét thử lại.

7. 7

   Đặt Tên tài liệu dễ nhận biết. Chỉ bấm Lưu tài liệu khi bản xem trước đã đúng; tài liệu vừa lưu sẽ xuất hiện trong danh sách Tài liệu huấn luyện AI để bạn bật, tắt hoặc xem nội dung.

Nếu chạm trần số trang, ưu tiên dùng một đường dẫn gần đúng nhánh tài liệu cần huấn luyện và phạm vi Chỉ trong mục này. Chỉ tăng giới hạn hoặc chọn Cả tên miền khi bạn đã kiểm tra website không dẫn sang nhiều nội dung ngoài chủ đề.

7. 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.

Tài liệu huấn luyện AI không chứa API key. Nếu quét website báo địa chỉ không hợp lệ, hãy dùng đường dẫn đầy đủ bắt đầu bằng https://. Nếu một trang bị bỏ qua, xem trạng thái trong Các trang đã quét: trang có thể không có nội dung đọc được, không truy cập được hoặc bị robots.txt chặn.