Bắt đầu nhanh

Nhận lời mời và đăng nhập consoleSao chép liên kết

Người quản trị tổ chức của bạn mời bạn qua email. Chấp nhận lời mời rồi đăng nhập vào app.harnix.vn. Bạn sẽ thấy console quản trị của tổ chức — nơi tạo agent, knowledge base, và lấy key tích hợp.

Tạo một agentSao chép liên kết

Vào Trợ lý AI → Trợ lý AI mới. Chọn provider/model (ví dụ OpenAI hoặc một endpoint tương thích OpenAI), viết một system prompt ngắn mô tả agent làm gì. Xem Xây dựng agent để biết đầy đủ tuỳ chọn (cửa sổ lịch sử, ngân sách token mỗi ngày, bật/tắt agent).

Tạo knowledge base và tải tài liệuSao chép liên kết

Vào Cơ sở tri thức → Cơ sở tri thức mới, tải lên vài tài liệu (PDF, DOCX, Markdown, text — tối đa 20 MB mỗi file). Đợi trạng thái ingest chuyển sang completed, rồi gán knowledge base này vào agent vừa tạo ở bước trên. Khi một agent có knowledge base được gán, knowledge_search tự động bật — không có công tắc riêng để bật/tắt. Chi tiết ở Knowledge base.

Lấy publishable keySao chép liên kết

Vào Tích hợp. Sao chép Khoá công khai (pk_...) — đây là khoá được phép nằm trong HTML công khai của trang bạn, không phải bí mật. Thêm domain bạn sẽ nhúng widget vào Origin được phép (khớp chính xác scheme + host + port, ví dụ https://example.com) — thiếu bước này widget sẽ bị chặn bởi lỗi origin_not_allowed.

Nhúng widgetSao chép liên kết

Dán hai dòng này vào trang HTML của bạn, ngay trước </body>:

<script src="https://api.harnix.vn/v2/widget/v1/widget.js" async></script>
<harnix-chat pk="pk_xxxxxxxxxxxxxxxx"></harnix-chat>

Mở lại trang: một bong bóng chat xuất hiện ở góc dưới bên phải. Xem Widget để biết cách đổi vị trí, theme, tiêu đề, hay nhúng inline thay vì bong bóng nổi.

Hỏi thửSao chép liên kết

Bấm vào widget, hỏi một câu mà câu trả lời nằm trong tài liệu bạn vừa tải lên. Câu trả lời trả về kèm trích dẫn — nguồn cụ thể trong tài liệu mà agent đã tra cứu để trả lời, không phải một câu trả lời model tự bịa.