Triển khai tính năng tự động hoàn thành

Tính năng tự động hoàn thành của Cloud Search hỗ trợ người dùng bằng cách đề xuất các từ khi người dùng nhập cụm từ tìm kiếm. Ví dụ: các đề xuất có thể là từ trong tiêu đề tài liệu, toán tử tìm kiếm, giá trị toán tử tìm kiếm hoặc tên và địa chỉ email của tổ chức Google Workspace.

Tính năng tự động hoàn thành trích xuất các cụm từ từ tiêu đề của các tài liệu được lập chỉ mục và sử dụng mô hình n-gram, xác định các đề xuất để phân phát bằng Suggest API. Theo mặc định, các cụm từ trong tiêu đề tài liệu sẽ xuất hiện trong tính năng tự động hoàn thành. Bạn cũng có thể đánh dấu các thuộc tính văn bản và lược đồ enum là is_suggestable để tự động hoàn thành tên và giá trị thuộc tính tương ứng.

Suggest API sẽ kiểm tra cụm từ tìm kiếm để tìm gợi ý về ngôn ngữ của cụm từ đó (chẳng hạn như tiếng Anh hoặc tiếng Tây Ban Nha) và ưu tiên kết quả cho phù hợp. Trường languageCode của một yêu cầu cũng được dùng để cải thiện các đề xuất theo ngôn ngữ cụ thể.

Tình huống ví dụ

Ví dụ: giả sử bạn có nguồn dữ liệu sau đây chứa dữ liệu về phim:

  • Nguồn dữ liệu chứa 2 tài liệu.
  • Mỗi tài liệu đều có một tiêu đề (ItemMetadata.title) và hai thuộc tính: genre và characters.
  • Tài liệu đầu tiên có tiêu đề "Avengers Infinity War" (Biệt đội siêu anh hùng: Cuộc chiến vô cực) với genre=science fiction và characters=Iron Man, Hulk
  • Tài liệu thứ hai có tiêu đề "Harry Potter" với genre=Adventure, Fantasy andcharacters=Hermione, Harry Potter`

Hình 1 minh hoạ cách các đề xuất tự động hoàn thành được trích xuất từ tiêu đề tài liệu, thuộc tính và giá trị thuộc tính.

Hai tài liệu và n-gram kết quả
Hình 1. Hai tài liệu và n-gram kết quả được dùng cho tính năng tự động hoàn thành

Từ tài liệu 1, chúng ta trích xuất các n-gram (tối đa là 3-gram) "Avengers", "Infinity", "War", "Avengers Infinity", "Infinity War", "Avengers Infinity War". Tương tự, từ tài liệu 2, chúng ta tạo ra "Harry", "Potter", "Harry Potter".

Khi truy vấn nguồn dữ liệu này, giả sử người dùng bắt đầu bằng cách nhập "h". Các đề xuất mà người dùng nhìn thấy sẽ là:

  • Harry
  • Hermione
  • Hulk
  • Harry Potter

Giả sử người dùng chọn đề xuất tự động hoàn thành "Hermione" và lần nhấn phím tiếp theo của người dùng là ký tự "a". Các đề xuất tự động hoàn thành mà người dùng nhìn thấy sẽ là:

  • Hermione Adventure
  • Hermione Action
  • Hermione Avengers

Tính năng tự động hoàn thành sẽ cố gắng hoàn thành từ (hoặc n-gram) cuối cùng đang được nhập. Trong ví dụ trước, hệ thống chỉ mở rộng "a" thành "adventure", "action" và "avengers" vì không có văn bản nào bắt đầu bằng "hermione a" cùng nhau. Đề xuất này được gọi là đề xuất đuôi; chỉ tự động hoàn thành từ/n-gram cuối cùng đang được nhập.

Tính năng tự động hoàn thành của Cloud Search trả về tối đa 5 đề xuất từ nội dung tài liệu và 2 đề xuất về người dùng.

Theo mặc định, các cụm từ trong tiêu đề tài liệu sẽ xuất hiện trong tính năng tự động hoàn thành. Bạn phải đánh dấu rõ ràng các thuộc tính lược đồ là is_suggestable để API đề xuất tự động hoàn thành tên và giá trị thuộc tính tương ứng.

Tích hợp với Autocomplete API

Nếu bạn đang sử dụng ứng dụng tìm kiếm mặc định hoặc tiện ích tìm kiếm có thể nhúng, thì tính năng tự động hoàn thành của Cloud Search được hỗ trợ nguyên bản mà không cần thêm bất kỳ thao tác nào. Xin lưu ý rằng theo mặc định, các cụm từ trong tiêu đề tài liệu sẽ xuất hiện trong tính năng tự động hoàn thành. Bạn phải đánh dấu rõ ràng các thuộc tính lược đồ là is_suggestable để API đề xuất tự động hoàn thành tên và giá trị thuộc tính tương ứng.

Nếu bạn đang tạo một ứng dụng tìm kiếm tuỳ chỉnh, thì tính năng tự động hoàn thành sẽ có sẵn bằng cách truy vấn các điểm cuối API /query/suggest.

Các điểm hạn chế

Tính năng tự động hoàn thành có các giới hạn sau:

  • Không hỗ trợ việc hạn chế các cụm từ tự động hoàn thành của Cloud Search bằng FilterOptions được xác định trong giản đồ, ngoại trừ các bộ lọc tích hợp sau: objectype, mimetype và bộ lọc theo loại.

  • Đề xuất dựa trên nhật ký truy vấn (các cụm từ tìm kiếm mà người dùng đã thực hiện trước đó trong một ứng dụng tìm kiếm) không được hỗ trợ

  • Bạn có thể đánh dấu tối đa 20 tài sản là is_suggestable. Bạn có thể tăng hạn mức này bằng cách liên hệ với nhóm hỗ trợ Cloud Search.

  • Tính năng tự động hoàn thành toán tử tìm kiếm không dùng được cho những tài sản có exact_match_with_operator.

  • Tính năng tự động hoàn thành của Cloud Search trả về tối đa 5 đề xuất từ nội dung tài liệu và 2 đề xuất về người dùng.

  • Tính năng tự động hoàn thành của Cloud Search chỉ đề xuất các cụm từ trong những tài liệu mà người dùng có quyền truy cập.