Tích hợp Wagtail
Trợ lý AI trả lời câu hỏi trên trang Wagtail của bạn
Tổng quan
Gói Wagtail đặt một trợ lý AI lên trang của bạn. Nút trò chuyện nằm ở góc mỗi trang, khách hỏi bằng lời của họ, và câu trả lời đến từ nội dung của chính bạn: trang web của bạn, tài liệu bạn đã tải lên và các bài trợ giúp của bạn.
Lưu ý về AI: Câu trả lời trên trang của bạn do AI tạo ra. Đôi khi chúng có thể sai hoặc thiếu. Hãy kiểm tra trước khi dựa vào chúng, nhất là với quyết định quan trọng.
Cách hoạt động
Gói thêm một middleware đặt một đoạn mã nhỏ ngay trước thẻ đóng body của mỗi trang. Đoạn mã chờ trang tải xong rồi mới lấy widget trò chuyện từ Asyntai, nên trang của bạn hiện ra trước và tốc độ trang không đổi. Máy chủ của bạn không bao giờ nói chuyện với Asyntai; chỉ trình duyệt của khách làm việc đó.
Bạn không đổi gì trong các mẫu của mình. Middleware để yên trang quản trị Wagtail, và để yên mọi thứ không phải trang HTML.
Yêu cầu
- Một tài khoản Asyntai. Gói miễn phí là đủ để bắt đầu.
- Một trang Wagtail phiên bản 5.2 trở lên, chạy Django 4.2 trở lên và Python 3.9 trở lên.
- Quyền truy cập mã nguồn của trang đó, vì bạn cài một gói Python.
Cài đặt
Làm theo các bước sau để thêm Asyntai vào trang Wagtail của bạn:
Cài gói
Cài từ Python Package Index, trong cùng môi trường với trang của bạn:
pip install wagtail-ai-chatbot
Thêm vào phần cài đặt
Thêm ứng dụng và mô-đun cài đặt của Wagtail vào INSTALLED_APPS, và middleware lên đầu MIDDLEWARE:
INSTALLED_APPS = ["wagtail_asyntai", "wagtail.contrib.settings", ...]
MIDDLEWARE = ["wagtail_asyntai.middleware.AsyntaiWidgetMiddleware", ...]
Chạy migration
Lệnh này tạo bảng giữ các cài đặt của bạn:
python manage.py migrate wagtail_asyntai
Dán ID widget của bạn
Trong trang quản trị Wagtail, mở Settings rồi Asyntai chat assistant. Dán ID widget của bạn và chọn Save. Bạn tìm thấy ID trong bảng điều khiển Asyntai ở mục Setup & Integration. Bạn có thể dán cả đoạn mã; gói chỉ giữ lại ID.
Mẹo: Trước khi xuất bản, hãy thêm tài liệu, phần hỏi đáp và hướng dẫn của bạn trong bảng điều khiển Asyntai, để trợ lý trả lời đúng ngay từ khách truy cập đầu tiên.
Cài đặt
- ID widget: trò chuyện bật khi ô này có ID hợp lệ, và tắt khi ô trống.
- Chỉ hiện trò chuyện cho khách chưa đăng nhập: người dùng đã đăng nhập không bao giờ thấy khung trò chuyện. Hữu ích khi trợ lý dành cho những người chưa đăng ký.
- Địa chỉ mã widget: hãy để nguyên giá trị này, trừ khi bộ phận hỗ trợ Asyntai yêu cầu bạn đổi.
Cài đặt theo từng trang, nên một dự án phục vụ nhiều trang từ một bản cài Wagtail có thể cho mỗi trang một trợ lý riêng.
Cài đặt trong tệp cài đặt của bạn
Dự án giữ cấu hình trong biến môi trường có thể bỏ qua trang quản trị và đặt giá trị trong mã. Nếu điền cả hai nơi, trang quản trị thắng.
ASYNTAI_WIDGET_ID = "asyntai_ab12cd34"
Ba giá trị khác là tuỳ chọn: ASYNTAI_SHOW_TO_ANONYMOUS_ONLY, ASYNTAI_SCRIPT_URL và ASYNTAI_SKIP_PREFIXES. Giá trị cuối liệt kê các đường dẫn widget không bao giờ chạm tới, và bạn cần nó khi trang quản trị của bạn không ở /admin/.
Đặt widget bằng tay
Nếu bạn muốn tự chọn chỗ, hãy bỏ middleware và đặt thẻ vào mẫu cơ sở của bạn. Thẻ và middleware không bao giờ cùng chạy, nên bạn giữ cả hai cũng được.
{% load asyntai %} ... {% asyntai_widget %}
Trợ lý có thể làm gì
- Trả lời câu hỏi của khách ngay lập tức, suốt ngày đêm, trên mọi trang
- Trả lời bằng hơn 80 ngôn ngữ, tự nhận biết ngôn ngữ từ câu hỏi
- Vẫn mở khi khách chuyển từ trang này sang trang khác
- Dùng tài liệu bạn tải lên, câu hỏi thường gặp và hướng dẫn của bạn để trả lời chính xác
Quyền riêng tư
Gói công bố đúng hai giá trị lên trang: ID widget và địa chỉ mã. Không có thông tin nào về các trang hay người dùng của bạn được gửi tới Asyntai. Chỉ trình duyệt của khách nói chuyện với Asyntai, và chỉ khi khách mở khung trò chuyện.
Gói dịch vụ và giá
Tích hợp Wagtail có trong mọi gói Asyntai, kể cả gói miễn phí. Mỗi gói gồm một lượng tin nhắn hằng tháng dùng chung cho tất cả kênh và tích hợp của bạn. Xem bảng giá.
Gỡ cài đặt
Xóa trống ô ID widget để tắt trò chuyện. Để gỡ gói, lấy middleware và ứng dụng ra khỏi phần cài đặt rồi gỡ bằng pip.
Mã nguồn
Gói là phần mềm tự do và mã nguồn mở, theo giấy phép MIT. Bạn có thể đọc từng dòng trên GitHub.
Cần Trợ giúp?
Nếu bạn có bất kỳ câu hỏi nào hoặc gặp vấn đề, hãy liên hệ chúng tôi tại [email protected].