Cài đặt - AI Chatbot Nội Bộ

Cấu hình API Key, Mô hình AI & Tìm kiếm RAG

Kết nối với 9router Proxy / OpenAI và điều chỉnh mô hình AI cho hệ thống Chatbot

🔑 Khóa API & Base URL Proxy ⟳ Đang tải...

API Base URL (9router / OpenAI Proxy)

Dùng khi kết nối qua 9router Proxy hoặc nhà cung cấp API tương thích.

API Key

Được lưu an toàn vào tệp .env và tự động cập nhật ngay tức thì.

⚡ Mô hình Mặc định & Thông số RAG

Tên Mô hình / Combo Model Mặc định

Chọn nhanh:

Top K (Số Chunk tối đa)

5

Similarity Threshold

0.35

Quản lý Danh sách Combo Models (9router Mapping)

Khai báo và ánh xạ các tên Combo được cấu hình trên 9router (VD: Chatbot, my-combo, Claude)

➕ Khai báo Combo Model mới từ 9router

Tên Combo 9router	Chiến lược (Strategy)	Danh sách Models thành phần	Mặc định RAG	Thao tác

OpenAI API Key

Cần thiết để tạo embedding và chat với GPT

Trạng thái API Key

⟳ Đang tải...

API Base URL (để trống nếu dùng OpenAI chính thức)

Dùng khi sử dụng API tương thích OpenAI từ nhà cung cấp khác (9router, Azure, v.v.)

API Key

API Key và Base URL được lưu vào file .env trên server và hot-reload không cần restart container.

Xác thực LDAP / Active Directory Nội Bộ

Cấu hình kết nối tới LDAP Server của công ty để xác thực người dùng

Bật Xác thực LDAP (Bắt buộc Login)

Khi bật, người dùng phải đăng nhập bằng tài khoản LDAP trước khi sử dụng Chatbot

LDAP Server Host & Port

Địa chỉ IP hoặc tên miền của Server LDAP / Active Directory.

LDAP Base DN

Đường dẫn Base DN chứa thông tin người dùng trong cây thư mục LDAP.

Bind User DN (Tùy chọn - Service Account)

Để trống nếu cho phép tìm kiếm trực tiếp tài khoản người dùng.

User Search Filter

Bộ lọc tìm kiếm user. Dùng {username} làm biến thế thế.

Cài đặt AI & RAG

Điều chỉnh mô hình và thông số tìm kiếm

Tên Mô hình / Combo Model (Chat Model)

Nhập tên model hoặc tên Combo được cấu hình trên 9router (VD: Chatbot) hoặc OpenAI (VD: gpt-4o)

Top K — Số chunk trả về tối đa

5

Số lượng đoạn văn bản liên quan nhất được gửi vào GPT prompt.

Similarity Threshold — Ngưỡng tin cậy

0.35

Nếu độ tương đồng thấp hơn ngưỡng này, AI sẽ trả về "Không tìm thấy thông tin".

Tích hợp App Nội Bộ

Cấu hình kết nối từ app nội bộ LDAP

Internal API Key (Session)

Lưu vào localStorage trình duyệt. Gửi kèm header X-API-Key trong mỗi request.

User ID

ID người dùng gửi kèm mỗi tin nhắn để lưu lịch sử chat.

Đã lưu: Chưa cài đặt

Mẫu Code Kết Nối API (Copy & Paste)

Dùng để tích hợp trực tiếp vào ứng dụng nội bộ của công ty

Chat API Endpoint URL

📖 Swagger Docs ↗

curl -X POST "http://192.168.1.37:8068/api/v1/chat" \
  -H "Content-Type: application/json" \
  -d '{
    "question": "Hướng dẫn cấu hình unifi",
    "conversation_id": "session_user_001",
    "user_id": 1
  }'

import requests

url = "http://192.168.1.37:8068/api/v1/chat"
payload = {
    "question": "Hướng dẫn cấu hình unifi",
    "conversation_id": "session_user_001",
    "user_id": 1
}

res = requests.post(url, json=payload)
data = res.json()

print("Câu trả lời:", data.get("answer"))
print("Độ tin cậy:", data.get("confidence"))
print("Nguồn trích dẫn:", data.get("sources"))

async function askChatbot(question, sessionID = "session_001") {
  const res = await fetch("http://192.168.1.37:8068/api/v1/chat", {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({
      question: question,
      conversation_id: sessionID,
      user_id: 1
    })
  });
  const data = await res.json();
  console.log("Trả lời:", data.answer, "Nguồn:", data.sources);
  return data;
}