Năng lực AI dùng chung

N2NAI Platform

Một bộ năng lực AI chạy sẵn cho mọi sản phẩm của N2NAI. Sản phẩm gắn năng lực có sẵn thay vì tự xây lại: hỏi đáp trên tài liệu có dẫn nguồn, trợ lý gọi công cụ, kho tri thức, bảo vệ nội dung.

Trang này cho biết năng lực nào đang chạy, và hướng dẫn đặt khung chat vào trang web của bạn bằng một đoạn mã.

Nhúng khung chat Xem API công khai

7/7 năng lực đang chạy Xem bảng tình trạng

Tình trạng các năng lực

Bảng tự cập nhật trong lúc bạn mở trang.

Năng lực	Tình trạng	Phiên bản
Cổng mô hìnhNơi duy nhất giữ khoá mô hình AI, chọn mô hình theo tên gọi, tính chi phí theo từng sản phẩm	Đang chạy	0.2.0
Kho tri thứcNạp tài liệu, tìm kiếm theo nghĩa và theo từ khoá, trả đoạn có dẫn nguồn	Đang chạy	0.2.0
Hỏi đáp tài liệuChatbot trả lời có trích dẫn trên kho tài liệu, chuyển người thật khi cần	Đang chạy	0.3.2
AgentTrợ lý gọi công cụ của sản phẩm, có bước chờ xác nhận trước thao tác quan trọng	Đang chạy	0.1.1
Phone AITrả lời cuộc gọi điện thoại bằng giọng nói, đặt lịch, gửi tóm tắt cuộc gọi. Chưa nhận cuộc gọi thật	Đang chạy	0.1.0
Bảo vệ nội dungChe dữ liệu cá nhân, phát hiện khủng hoảng tâm lý, chặn câu lệnh lừa trợ lý	Đang chạy	0.1.1
Viết học thuật và học liệuViết báo khoa học, soạn bài giảng và học liệu, kiểm đề Moodle, đối chiếu số liệu với kết quả chạy, dựng bảng điểm và nhận xét	Đang chạy	0.2.0

Nhúng khung chat

Khung chat hỏi đáp trên tài liệu của bạn, đặt vào trang web bằng một thẻ script. Không cần viết giao diện, không cần máy chủ trung gian.

Đăng ký địa chỉ trang web

Gửi cho quản trị viên N2NAI địa chỉ trang sẽ đặt khung chat, ví dụ https://tuyensinh.truong.example. Mỗi địa chỉ được đăng ký riêng và phải khớp chính xác, kể cả https và tên miền con.
Nhận mã bot và khoá công khai

Quản trị viên đăng ký địa chỉ đó cho bot trên Elite Team rồi gửi lại hai thứ: mã bot và khoá công khai, bắt đầu bằng cap_cb_pub_.
Dán đoạn mã vào trang

Đặt đoạn mã dưới đây ngay trước thẻ đóng body, thay mã bot và khoá công khai của bạn. Trang sẽ có nút tròn ở góc phải, bấm vào là mở khung chat.

HTML

<script src="https://platform.n2nai.io/chat/widget.js"
        data-api="https://platform.n2nai.io/chat"
        data-bot="ma-bot-cua-ban"
        data-key="cap_cb_pub_..."
        async></script>

Tuỳ chỉnh thường dùng

data-target: Bộ chọn CSS của phần tử chứa khung chat, khi muốn khung nằm trong trang thay vì nổi ở góc
data-brand: Màu thương hiệu, ví dụ #0b6e4f. Màu chữ được tự chọn cho dễ đọc
data-theme: light, dark hoặc auto theo máy người dùng
data-title: Tên hiện ở đầu khung, mặc định là tên bot
data-lang: Ngôn ngữ chữ trên giao diện, vi hoặc en
data-open: Đặt true để mở khung ngay khi tải trang

Về khoá

Khoá công khai được phép nằm trong mã trang web. Khoá chỉ dùng được từ các địa chỉ đã đăng ký và chỉ cho đúng một bot.
Khoá bí mật của sản phẩm không đặt trong trình duyệt. Địa chỉ này từ chối mọi yêu cầu mang khoá bí mật.
Đổi tên miền hoặc thêm trang mới thì báo quản trị viên để đăng ký thêm địa chỉ. Nghi khoá bị lạm dụng thì xin đổi khoá, khoá cũ hết hiệu lực ngay.
Mỗi người dùng có giới hạn số tin nhắn theo phút, giờ và ngày để tránh lạm dụng.

API công khai của khung chat

Dùng khi bạn tự viết giao diện chat. Đây là toàn bộ các đường gọi được từ trình duyệt.

Cách gọi

Địa chỉ gốc: https://platform.n2nai.io/chat
Xác thực: Đầu Authorization: Bearer cap_cb_pub_... với khoá công khai của bot
Nơi gọi: Từ trang web đã đăng ký. Trình duyệt tự gửi đầu Origin
Dữ liệu: JSON, đầu Content-Type: application/json

Lỗi và giới hạn

Mọi lỗi có cùng một dạng, kèm mã HTTP đúng nghĩa:

{"error": {"code": "rate_limited",
           "message": "...",
           "request_id": "..."}}

Mã 429 nghĩa là gửi quá nhanh, chờ số giây ghi ở đầu Retry-After rồi thử lại. Mã 403 nghĩa là khoá hoặc địa chỉ trang chưa được phép.

GET /v1/bots/{bot}/public
Thông tin hiển thị của bot: tên, lời chào, câu gợi ý, chủ đề, biểu mẫu liên hệ
POST /v1/bots/{bot}/conversations
Mở một cuộc trò chuyện, trả conversation_id và lời chào
Thân yêu cầu {user_ref?, channel?, mode?, profile?}
POST /v1/conversations/{id}/messages
Gửi một câu hỏi. Đặt stream là true để nhận câu trả lời phát dần (SSE)
Thân yêu cầu {text, stream?, mode?, context?}
GET /v1/bots/{bot}/lead-form
Các trường của biểu mẫu liên hệ
POST /v1/bots/{bot}/leads
Gửi biểu mẫu liên hệ
Thân yêu cầu {fields, consent?, conversation_id?}
POST /v1/messages/{id}/feedback
Ghi phản hồi cho một câu trả lời
Thân yêu cầu {rating: 1 hoặc -1, note?}

Khi stream là true, câu trả lời về theo từng sự kiện delta, sau đó là citations và done.

Liên hệ

Cần khoá công khai, đăng ký thêm địa chỉ trang web hoặc muốn đưa một năng lực vào sản phẩm của bạn, liên hệ đội N2NAI tại n2nai.io.