ใช้การเติมข้อความอัตโนมัติ

การเติมข้อความอัตโนมัติของ Cloud Search จะช่วยผู้ใช้โดยการแนะนำคำ เมื่อผู้ใช้พิมพ์คำค้นหา เช่น คำแนะนำอาจเป็นคำ จากชื่อเอกสาร โอเปอเรเตอร์การค้นหา ค่าโอเปอเรเตอร์การค้นหา หรือชื่อและ อีเมลจากองค์กร Google Workspace

การเติมข้อความอัตโนมัติจะดึงวลีจากชื่อของเอกสารที่จัดทำดัชนี และใช้โมเดล n-gram เพื่อกำหนดคำแนะนำที่จะแสดงโดยใช้ Suggest API โดยค่าเริ่มต้น ระบบจะแสดงวลีจาก ชื่อเอกสารในการเติมข้อความอัตโนมัติ นอกจากนี้ คุณยังทําเครื่องหมายพร็อพเพอร์ตี้ข้อความและพร็อพเพอร์ตี้ enum schema เป็น is_suggestable เพื่อเติมชื่อและค่าพร็อพเพอร์ตี้ที่เกี่ยวข้องโดยอัตโนมัติได้ด้วย

API คำแนะนำจะตรวจสอบคำค้นหาเพื่อหาคำใบ้เกี่ยวกับภาษาของคำค้นหา เช่น ภาษาอังกฤษหรือสเปน และจัดลำดับความสำคัญของผลการค้นหาตามนั้น ระบบยังใช้ฟิลด์ languageCode ของคำขอเพื่อปรับปรุงคำแนะนำที่เฉพาะเจาะจงสำหรับภาษาด้วย

สถานการณ์ตัวอย่าง

ตัวอย่างเช่น สมมติว่าคุณมีแหล่งข้อมูลต่อไปนี้ซึ่งมีข้อมูลเกี่ยวกับ ภาพยนตร์

  • แหล่งข้อมูลมีเอกสาร 2 รายการ
  • เอกสารแต่ละฉบับมีชื่อ (ItemMetadata.title) และพร็อพเพอร์ตี้ 2 รายการ ได้แก่ genre และ characters
  • เอกสารแรกชื่อ "Avengers Infinity War" มี genre=science fictionและcharacters=Iron Man, Hulk
  • เอกสารที่ 2 มีชื่อว่า "Harry Potter" โดยมีgenre=Adventure, Fantasy andcharacters=Hermione, Harry Potter`

รูปที่ 1 แสดงวิธีดึงคำแนะนำที่เติมข้อความอัตโนมัติจาก ชื่อเอกสาร พร็อพเพอร์ตี้ และค่าพร็อพเพอร์ตี้

เอกสาร 2 ฉบับและ Ngram ที่ได้
รูปที่ 1 เอกสาร 2 ฉบับและ N-gram ที่ได้ซึ่งใช้สำหรับการเติมข้อความอัตโนมัติ

จากเอกสาร 1 เราจะแยก Ngram (สูงสุด 3 คำ) "Avengers" "Infinity" "War" "Avengers Infinity" "Infinity War" "Avengers Infinity War" ในทำนองเดียวกันจากเอกสาร 2 เราจะสร้าง "Harry" "Potter" "Harry Potter"

เมื่อค้นหาแหล่งข้อมูลนี้ สมมติว่าผู้ใช้เริ่มพิมพ์ "h" คำแนะนำที่แสดงต่อผู้ใช้จะเป็นดังนี้

  • CANNOT TRANSLATE
  • Hermione
  • Hulk
  • Harry Potter

สมมติว่าผู้ใช้เลือกคำแนะนำในการเติมข้อความอัตโนมัติ "Hermione" และการกดแป้นครั้งถัดไปจากผู้ใช้คืออักขระ "a" คำแนะนำการเติมข้อความอัตโนมัติที่แสดงต่อผู้ใช้จะเป็นดังนี้

  • Hermione Adventure
  • Hermione Action
  • Hermione Avengers

การเติมข้อความอัตโนมัติจะพยายามเติมคำสุดท้าย (หรือ n-gram) ที่กำลังพิมพ์ ในตัวอย่างก่อนหน้า ระบบจะขยาย "a" เป็น "adventure" "action" และ "avengers" เนื่องจากไม่มีข้อความที่เริ่มต้นด้วย "hermione a" คำแนะนำนี้เรียกว่าคำแนะนำส่วนท้าย ซึ่งจะเติมคำอัตโนมัติเฉพาะคำสุดท้าย/n-gram ที่พิมพ์

การเติมข้อความอัตโนมัติของ Cloud Search จะแสดงคำแนะนำสูงสุด 5 รายการ จากเนื้อหาในเอกสารและคำแนะนำเกี่ยวกับบุคคล 2 รายการ

โดยค่าเริ่มต้น ระบบจะแสดงวลีจากชื่อเอกสารในการเติมข้อความอัตโนมัติ ต้องทำเครื่องหมายพร็อพเพอร์ตี้ Schema อย่างชัดเจนเป็น is_suggestable เพื่อให้ API คำแนะนำ เติมชื่อและค่าพร็อพเพอร์ตี้ที่เกี่ยวข้องโดยอัตโนมัติ

ผสานรวมกับ Autocomplete API

หากคุณใช้แอปพลิเคชันการค้นหาเริ่มต้นหรือวิดเจ็ตการค้นหาที่ฝังได้ ระบบจะรองรับฟีเจอร์เติมข้อความอัตโนมัติของ Cloud Search โดยค่าเริ่มต้นโดยที่คุณไม่ต้องดำเนินการใดๆ เพิ่มเติม โปรดทราบว่าโดยค่าเริ่มต้น ระบบจะแสดงวลีจากชื่อเอกสารในการเติมข้อความอัตโนมัติ ต้องทําเครื่องหมายพร็อพเพอร์ตี้ Schema อย่างชัดเจนเป็น is_suggestable เพื่อให้ API คําแนะนําทําการเติมข้อความอัตโนมัติสําหรับชื่อและค่าพร็อพเพอร์ตี้ที่เกี่ยวข้อง

หากคุณกำลังสร้างแอปพลิเคชันการค้นหาที่กำหนดเอง ฟีเจอร์เติมข้อความอัตโนมัติ จะพร้อมใช้งานโดยการค้นหา/query/suggestปลายทาง API

ข้อจำกัด

การเติมข้อความอัตโนมัติมีข้อจำกัดต่อไปนี้

  • ระบบไม่รองรับการจำกัดวลีการเติมข้อความอัตโนมัติของ Cloud Search โดยใช้ FilterOptions ที่กำหนดไว้ในสคีมา ยกเว้นตัวกรองในตัวต่อไปนี้ objectype, mimetype และตัวกรองประเภท

  • ไม่รองรับคําแนะนําตามประวัติการค้นหา (การค้นหาที่ผู้ใช้เคยทําในแอปพลิเคชันค้นหา)

  • ทำเครื่องหมายพร็อพเพอร์ตี้เป็น is_suggestable ได้สูงสุด 20 รายการ คุณเพิ่มขีดจำกัดนี้ได้โดยติดต่อทีมสนับสนุนของ Cloud Search

  • การเติมข้อความอัตโนมัติของตัวดำเนินการค้นหาไม่พร้อมใช้งานสำหรับพร็อพเพอร์ตี้ที่มี exact_match_with_operator

  • การเติมข้อความอัตโนมัติของ Cloud Search จะแสดงคำแนะนำสูงสุด 5 รายการ จากเนื้อหาในเอกสารและคำแนะนำเกี่ยวกับบุคคล 2 รายการ

  • การเติมข้อความอัตโนมัติของ Cloud Search จะแนะนำวลีจากเอกสารที่ผู้ใช้มีสิทธิ์เข้าถึงเท่านั้น