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

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

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

Suggest 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 รายการและ N-gram ที่ได้
รูปที่ 1 เอกสาร 2 รายการและ n-gram ที่ได้ซึ่งใช้สำหรับการเติมข้อความอัตโนมัติ

จากเอกสารที่ 1 เราจะดึงข้อมูล n-gram (สูงสุด 3-gram) "Avengers", "Infinity", "War", "Avengers Infinity", "Infinity War", "Avengers Infinity War" และจากเอกสารที่ 2 เราจะสร้าง "Harry", "Potter", "Harry Potter"

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

  • 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 เพื่อให้ Suggest API เติมชื่อและค่าพร็อพเพอร์ตี้ที่เกี่ยวข้องให้สมบูรณ์

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

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

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

ข้อจำกัด

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

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

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

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

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

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

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