Tích hợp Cloudflare AI Search

Tài liệu này giới thiệu về tính năng tìm kiếm ngữ nghĩa (Semantic Search) và trợ lý ảo đối thoại (Ask AI) được tích hợp trên theme TanaFlows thông qua giải pháp Cloudflare AI Search.

1. Giới thiệu về Cloudflare AI Search

Cloudflare AI Search là giải pháp tìm kiếm thế hệ mới dựa trên AI, kết hợp giữa hai công nghệ cốt lõi:

1. Semantic Search (Tìm kiếm ngữ nghĩa): Khác với tìm kiếm từ khóa truyền thống (chỉ khớp chính xác các ký tự), tìm kiếm ngữ nghĩa hiểu được ý định, ngữ cảnh của người dùng để trả về kết quả chính xác nhất ngay cả khi từ khóa không khớp hoàn toàn.
2. RAG Chat (Retrieval-Augmented Generation): Trợ lý Ask AI sử dụng các tài liệu, bài viết thu thập từ trang web của bạn làm ngữ cảnh đầu vào cho mô hình ngôn ngữ lớn (LLM), từ đó trả lời trực tiếp các câu hỏi của người đọc một cách chính xác và trích nguồn tin cậy từ chính site của bạn.

2. Các Tính năng Tích hợp trên Theme TanaFlows

Theme TanaFlows đã được tối ưu hóa toàn diện để tích hợp các tính năng của Cloudflare AI Search:

• Tìm kiếm Ngữ nghĩa (Search Modal): Khi nhấp vào biểu tượng kính lúp trên header hoặc trang lỗi 404, một cửa sổ popup hiện đại sẽ xuất hiện để người dùng nhập câu hỏi tìm kiếm.
• Trợ lý Ask AI (Sliding Drawer): Bấm nút Ask AI trên header để mở bảng hội thoại trượt từ cạnh phải màn hình. Giao diện lịch sử chat được ẩn đi mặc định để giữ khung chat sạch sẽ và tập trung tối đa trên máy tính.
• Đồng bộ giao diện (Dark/Light Mode): Cả hai Web Component tự động chuyển giao diện tối/sáng đồng bộ với cài đặt theme của người dùng.
• Tự động hoá đề xuất (Error 404 & Related Posts):
  • Trang 404: Tự động đề xuất các bài viết liên quan dựa trên URL/từ khóa lỗi thông qua API AI Search của Cloudflare.
  • Related Posts: Gợi ý các bài viết liên quan thông minh ở cuối mỗi bài đọc dựa trên nội dung ngữ nghĩa thay vì chỉ dựa vào thẻ tags thông thường.

3. Hướng dẫn chi tiết thiết lập trên Cloudflare

Dưới đây là hướng dẫn chi tiết từng bước để bạn thiết lập và kích hoạt Cloudflare AI Search (bao gồm cả ô tìm kiếm và trợ lý Ask AI) trên trang quản trị Cloudflare:

Bước 1: Tạo và cấu hình Instance trên Cloudflare

1. Đăng nhập vào tài khoản Cloudflare Dashboard.
2. Tìm đến mục AI Search ở thanh điều hướng bên trái và chọn Instances.
3. Nhấp vào Create Instance (nếu chưa có) và đặt tên cho bộ tìm kiếm của bạn.
4. Trong phần Data Sources, hãy thêm nguồn dữ liệu cho website bằng cách nhập link sitemap của Ghost (Ví dụ: https://ten-mien-cua-ban.com/sitemap.xml) và nhấn chạy Crawl/Index để Cloudflare đồng bộ các bài viết.

Bước 2: Kích hoạt Public Endpoint & Phân quyền (Quan trọng)

Để mã nguồn của theme có thể truy vấn trực tiếp đến Cloudflare mà không bị lỗi 401 hay 403, bạn cần mở khóa cổng kết nối công khai:

1. Vào Instance AI Search bạn vừa cấu hình, chọn tab Settings -> Public Endpoint.
2. Bật nút Enable Public Endpoint.
3. Phân quyền Endpoint (Quan trọng): Đảm bảo bạn tích chọn cả 2 tùy chọn sau:
   • Enable Search (Cho phép tìm kiếm)
   • Enable Chat hoặc Chat/Completions (Cho phép trò chuyện - dùng cho nút Ask AI).
4. Cấu hình Model cho Ask AI:
   • Trong phần cài đặt Chat, chọn một mô hình ngôn ngữ lớn (LLM) hỗ trợ hội thoại tốt. Cloudflare khuyến nghị sử dụng các mô hình instruct như: @cf/meta/llama-3-8b-instruct.
5. Cấu hình Allowed Origins (CORS - Chống lỗi chặn localhost/domain):
   • Nếu bạn đang thử nghiệm ở máy cá nhân, hãy thêm http://localhost:2368 và http://127.0.0.1:2368 vào danh sách Allowed Origins.
   • Khi chạy thực tế, hãy điền tên miền website của bạn (ví dụ: https://ten-mien-cua-ban.com).
   • Mẹo: Bạn có thể điền dấu * để mở quyền truy cập cho tất cả các nguồn (origins) nếu muốn thử nghiệm nhanh.

Bước 3: Lấy Endpoint URL

Sau khi lưu cấu hình Public Endpoint, Cloudflare sẽ cung cấp cho bạn một đường dẫn API công khai có cấu trúc dạng:

https://a36c95f2-f156-4d52-bd1b-aa5ead5841d3.search.ai.cloudflare.com/search

(Hãy sao chép toàn bộ đường dẫn này)

4. Kích hoạt trên Ghost Admin

1. Truy cập vào trang quản trị trang web của bạn: Ghost Admin > Settings > Design > Site design.
2. Tìm đến phần tùy biến cấu hình theme TanaFlows.
3. Tại mục Custom Search, chuyển tùy chọn từ Native Search sang AI Search by Cloudflare.
4. Tại mục Search Endpoint URL, dán đường dẫn API bạn đã sao chép ở Bước 3 vào (đường dẫn chứa /search ở cuối).
5. Nhấn Save ở góc trên bên phải để lưu lại.

Lúc này, toàn bộ hệ thống tìm kiếm trên trang web của bạn sẽ tự động chuyển sang cấu hình Cloudflare AI và nút Ask AI trên Header sẽ xuất hiện.

5. Hướng dẫn Xử lý Sự cố & Lưu ý vận hành