Định nghĩa từ đồng nghĩa

Thông thường, một tổ chức sẽ có thuật ngữ riêng hoặc nhiều cách để đề cập đến một khái niệm hoặc sự vật. Bạn nên xác định từ đồng nghĩa để thiết lập tính tương đương của các thuật ngữ nhằm giúp người dùng tìm thấy các mục khi tìm kiếm.

Lưu ý: Bạn chỉ có thể xác định từ đồng nghĩa tuỳ chỉnh cho các nguồn dữ liệu của bên thứ ba; bạn không thể xác định từ đồng nghĩa tuỳ chỉnh cho các nguồn dữ liệu của Google Workspace, chẳng hạn như Google Drive hoặc Gmail.

Từ đồng nghĩa được xác định bằng cách lập chỉ mục các mục bằng giản đồ phổ biến _dictionaryEntry.

Các mục thuộc loại _dictionaryEntry có thể có các thuộc tính sau:

Thuộc tính	Loại	Mô tả	Bắt buộc?
_term	string	Thuật ngữ cần xác định. Bạn nên sử dụng các từ hoặc cụm từ không có dấu câu và không được nối với nhau.	Bắt buộc
_synonym	string (repeated)	Các cụm từ thay thế sẽ được đưa vào các cụm từ tìm kiếm khớp với chuỗi được xác định trong _term.	Bắt buộc
_onlyApplicableForAttachedSearchApplications	boolean	Cho phép bạn nhóm các từ đồng nghĩa theo nguồn dữ liệu và ứng dụng tìm kiếm. Để biết thêm thông tin, hãy xem bài viết Xác định từ đồng nghĩa dành riêng cho nguồn dữ liệu.	Không bắt buộc

Lưu ý: Các mục được lập chỉ mục bằng giản đồ _dictionaryEntry không được tính vào hạn mức nguồn dữ liệu trong ứng dụng tìm kiếm.

Khi người dùng đưa giá trị của thuộc tính _term vào một truy vấn, truy vấn có hiệu lực sẽ trở thành "từ khoá HOẶC từ đồng nghĩa". Ví dụ: nếu từ khoá "scifi" được xác định bằng từ đồng nghĩa "science fiction", thì truy vấn chứa từ "scifi" sẽ khớp với các mục chứa "scifi" hoặc "science fiction."

Từ đồng nghĩa không được áp dụng theo hai chiều. Nếu truy vấn là "science fiction," Cloud Search thì không áp dụng từ đồng nghĩa nào cho truy vấn. Truy vấn chỉ khớp với các mục chứa "science fiction." mục chứa "scifi" sẽ bị bỏ qua.

Để có thể thay thế cả hai thuật ngữ, hãy xác định riêng từng thuật ngữ:

Thuật ngữ	Từ đồng nghĩa
scifi	science fiction
science fiction	scifi

Trong quá trình xử lý truy vấn, dấu gạch nối và các dấu câu khác sẽ bị xoá trước khi áp dụng từ đồng nghĩa. Truy vấn của người dùng "sci-fi" khớp với _term "sci fi." Để tạo từ đồng nghĩa cho các từ mà người dùng có thể thêm dấu gạch nối, trước tiên, hãy chuẩn hoá _term để sử dụng khoảng trắng thay vì dấu gạch nối.

Tiếp tục ví dụ, các định nghĩa sau đây so khớp với truy vấn của người dùng, coi "sci-fi," "sci fi," "scifi," và "science fiction" là thay thế được cho nhau:

Thuật ngữ	Từ đồng nghĩa
scifi	science fiction, sci fi
sci fi	science fiction, scifi
science fiction	scifi, sci fi

Lưu ý: Có thể mất đến 5 giờ thì các từ đồng nghĩa mới được xử lý và dùng để viết lại truy vấn.

Theo mặc định, từ đồng nghĩa trong bất kỳ nguồn dữ liệu nào đều áp dụng cho toàn bộ miền. Cụ thể, các từ đồng nghĩa được áp dụng trên các ứng dụng tìm kiếm cho mọi lượt tìm kiếm bất kể nguồn dữ liệu là gì. Nếu bạn muốn sử dụng từ đồng nghĩa theo nguồn dữ liệu, hãy tham khảo phần Xác định từ đồng nghĩa theo nguồn dữ liệu.

Xác định từ đồng nghĩa chung bằng SDK Cloud Search

Bạn có thể sử dụng SDK Content Connector để xác định các thuật ngữ và từ đồng nghĩa của các thuật ngữ đó. Hãy xem phần Tạo trình kết nối nội dung để biết hướng dẫn về cách tạo trình kết nối.

Đoạn mã sau đây minh hoạ cách tạo một RepositoryDoc đại diện cho thuật ngữ và từ đồng nghĩa dựa trên bản ghi tệp CSV:

DictionaryConnector.java

Xem trên GitHub

/**
 * Creates a document for indexing.
 *
 * For this connector sample, the created document is domain public
 *  searchable. The content is a simple text string.
 *
 * @param record The current CSV record to convert
 * @return the fully formed document ready for indexing
 */
private ApiOperation buildDocument(CSVRecord record) {
  // Extract term and synonyms from record
  String term = record.get(0);
  List<String> synonyms = StreamSupport.stream(record.spliterator(), false)
      .skip(1) // Skip term
      .collect(Collectors.toList());

  Multimap<String, Object> structuredData = ArrayListMultimap.create();
  structuredData.put("_term", term);
  structuredData.putAll("_synonym", synonyms);

  if (Configuration.getBoolean("dictionary.attachedToSearchApp", false).get()) {
    structuredData.put("_onlyApplicableForAttachedSearchApplications", true);
  }

  String itemName = String.format("dictionary/%s", term);

  // Using the SDK item builder class to create the item
  Item item =
      IndexingItemBuilder.fromConfiguration(itemName)
          .setItemType(IndexingItemBuilder.ItemType.CONTENT_ITEM)
          .setObjectType("_dictionaryEntry")
          .setValues(structuredData)
          .setAcl(DOMAIN_PUBLIC_ACL)
          .build();

  // Create the fully formed document
  return new RepositoryDoc.Builder()
      .setItem(item)
      .build();
}

Lưu ý những điều sau đây khi xác định các từ đồng nghĩa:

• Mục từ đồng nghĩa phải thuộc miền công khai. Trong ví dụ trước, việc này được thực hiện bằng cách đặt ACL thành DOMAIN_PUBLIC_ACL.
• Bạn không nên xác định các thuộc tính sau cho tệp cấu hình vì các thuộc tính này sẽ ghi đè chế độ cài đặt miền công khai trong mã:
  • defaultAcl.mode=FALLBACK
  • defaultAcl.public=true

Xác định từ đồng nghĩa dành riêng cho ứng dụng tìm kiếm

Theo mặc định, từ đồng nghĩa được áp dụng cho tất cả các nguồn dữ liệu trên tất cả ứng dụng tìm kiếm.

Tuy nhiên, giả sử tổ chức của bạn có các nhóm kỹ sư và bán hàng riêng biệt, đồng thời bạn muốn cung cấp cho mỗi nhóm một trải nghiệm tìm kiếm khác nhau, bao gồm cả các từ đồng nghĩa dành riêng cho vai trò công việc. Trong trường hợp này, bạn có thể tạo một ứng dụng tìm kiếm bằng từ đồng nghĩa và nguồn dữ liệu dành riêng cho kỹ thuật, còn một ứng dụng tìm kiếm khác bằng từ đồng nghĩa và nguồn dữ liệu dành riêng cho hoạt động bán hàng. Để hoàn thành mục tiêu này, hãy lập chỉ mục từng từ đồng nghĩa trong một nguồn dữ liệu cụ thể bằng _onlyApplicableForAttachedSearchApplications=true. Chế độ cài đặt này giới hạn các từ đồng nghĩa để chỉ áp dụng cho các ứng dụng tìm kiếm có chứa một nguồn dữ liệu cụ thể.

Ví dụ: việc thêm dòng mã sau đây vào mã mẫu trước đó đảm bảo các từ đồng nghĩa được lập chỉ mục là dành riêng cho nguồn dữ liệu:

structuredData.put("_onlyApplicableForAttachedSearchApplications", true);