Grounding Lite

เวอร์ชันทดลอง: Grounding Lite อยู่ในขั้นทดลอง (ก่อน GA) ผลิตภัณฑ์และฟีเจอร์ก่อนเวอร์ชันสำหรับผู้ใช้ทั่วไป อาจมีการรองรับที่จำกัด และการเปลี่ยนแปลงผลิตภัณฑ์ และฟีเจอร์ก่อนเวอร์ชันสำหรับผู้ใช้ทั่วไปอาจไม่เข้ากันกับเวอร์ชันก่อนเวอร์ชันสำหรับผู้ใช้ทั่วไปอื่นๆ ข้อเสนอก่อนเปิดให้ใช้งานทั่วไปอยู่ภายใต้ข้อกำหนดเฉพาะบริการของ Google Maps Platform ดูข้อมูลเพิ่มเติมได้ที่คำอธิบายระยะการเปิดตัว ไม่มี ค่าใช้จ่ายในการใช้ Grounding Lite ขณะที่ยังเป็นเวอร์ชันทดลอง

Google Maps Platform Grounding Lite เป็นบริการที่รองรับ Model Context Protocol (MCP) ซึ่งช่วยให้คุณเชื่อมโยงแอปพลิเคชัน AI กับข้อมูลเชิงพื้นที่ที่เชื่อถือได้จาก Google Maps ได้อย่างง่ายดาย เซิร์ฟเวอร์ MCP มีเครื่องมือที่ช่วยให้ LLM เข้าถึงความสามารถสำหรับสถานที่ สภาพอากาศ และเส้นทาง คุณลองใช้ Grounding Lite ได้โดยเปิดใช้ในเครื่องมือที่รองรับเซิร์ฟเวอร์ MCP

เครื่องมือ

Grounding Lite มีเครื่องมือที่ช่วยให้ LLM เข้าถึงความสามารถของ Google Maps ต่อไปนี้ได้

• ค้นหาสถานที่: ขอข้อมูลเกี่ยวกับสถานที่และรับสรุปข้อมูลสถานที่ที่ AI สร้างขึ้น รวมถึงรหัสสถานที่ พิกัดละติจูดและลองจิจูด และลิงก์ Google Maps สำหรับแต่ละสถานที่ที่รวมอยู่ในสรุป คุณสามารถใช้รหัสสถานที่ที่ส่งคืนและพิกัดละติจูดและลองจิจูดกับ Google Maps Platform API อื่นๆ เพื่อแสดงสถานที่บนแผนที่ได้
• ค้นหาสภาพอากาศ: ขอข้อมูลเกี่ยวกับสภาพอากาศและแสดงสภาพอากาศปัจจุบัน พยากรณ์อากาศรายชั่วโมง และพยากรณ์อากาศรายวัน

• คำนวณเส้นทาง: ขอข้อมูลเกี่ยวกับเส้นทางการขับรถหรือเส้นทางเดินระหว่าง 2 สถานที่ และแสดงข้อมูลระยะทางและระยะเวลาของเส้นทาง

  หมายเหตุ: Grounding Lite ไม่ได้ให้การกำหนดเส้นทาง คำแนะนำ การจราจรแบบเรียลไทม์ หรือข้อมูลการนำทางแบบทีละขั้นตอน

การเปิดใช้เซิร์ฟเวอร์ MCP ของ Maps Grounding Lite จะช่วยให้ LLM เรียกใช้เครื่องมือใหม่ ที่เซิร์ฟเวอร์เปิดเผยเพื่อแสดงข้อมูลการอ้างอิงเพิ่มเติมสำหรับข้อมูล ประเภทที่ระบุไว้ข้างต้น แม้ว่า LLM จะใช้ข้อมูลเพิ่มเติมนี้เพื่อ บริบทได้ แต่คำตอบที่ LLM สร้างขึ้นในท้ายที่สุดอาจไม่มี ข้อมูลที่แน่นอนซึ่งเซิร์ฟเวอร์ MCP ส่งคืน คุณควรตรวจสอบความถูกต้องของคำตอบที่สร้างขึ้น

ลองใช้แอปตัวอย่าง Grounding Lite (เปิดในแท็บใหม่)

การเรียกเก็บเงินและโควต้า

ไม่มีค่าใช้จ่ายในการใช้ Grounding Lite ในช่วงทดลอง อย่างไรก็ตาม โควต้าต่อไปนี้จะมีผลกับเครื่องมือที่ Grounding Lite มีให้

• ค้นหาสถานที่: 100 คำค้นหาต่อนาทีต่อโปรเจ็กต์ การค้นหา 1,000 ครั้งต่อวันต่อโปรเจ็กต์
• ค้นหาสภาพอากาศ: 300 คำค้นหาต่อนาทีต่อโปรเจ็กต์
• เส้นทางการคำนวณ: 300 คำค้นหาต่อนาทีต่อโปรเจ็กต์

นโยบายและข้อกำหนดในการให้บริการ

Grounding Lite อยู่ภายใต้ข้อกำหนดในการให้บริการของ Google Maps Platform รวมถึงข้อกำหนดเฉพาะบริการสำหรับบริการนี้ ส่วนนี้จะอธิบายข้อกำหนดเพิ่มเติมในการใช้บริการสำหรับ Grounding Lite ซึ่งรวมถึง LLM ที่เข้ากันได้และข้อกำหนดในการระบุแหล่งที่มา

ข้อกำหนดสำหรับ LLM ที่เข้ากันได้

คุณใช้ Grounding Lite ได้เฉพาะกับ LLM ที่เป็นไปตามข้อกำหนดในการให้บริการของ Google Maps Platform เท่านั้น

ตัวอย่างเช่น คุณมีหน้าที่รับผิดชอบในการตรวจสอบว่าเนื้อหาของ Google Maps ไม่ได้ แคช จัดเก็บ หรือใช้เพื่อปรับปรุง LLM ที่คุณเลือกใช้ ก่อนใช้ Grounding Lite คุณจะต้องอ่านข้อกำหนดในการให้บริการของโมเดลที่คุณต้องการใช้กับ Grounding Lite คุณต้องไม่ใช้ Grounding Lite กับโมเดลที่ใช้ข้อมูลที่ป้อนลงในโมเดลเพื่อการฝึกหรือปรับปรุงโมเดล คุณมีหน้าที่รับผิดชอบในการตรวจสอบว่าการใช้โมเดลของคุณเป็นไปตามข้อจำกัดเกี่ยวกับเนื้อหา Google Maps ในข้อกำหนดในการให้บริการของ Google Maps Platform อย่างครบถ้วน ซึ่งรวมถึงข้อกำหนดเฉพาะของบริการ

ข้อกำหนดในการระบุแหล่งที่มาสำหรับแหล่งที่มาของ Google Maps

การตอบกลับของเครื่องมือแต่ละรายการจาก Grounding Lite จะมีแหล่งที่มา เมื่อนำเสนอผลลัพธ์ ที่ใช้เครื่องมือที่ Grounding Lite จัดหาให้ คุณต้องระบุแหล่งที่มาของ Google Maps ที่เกี่ยวข้อง ในลักษณะที่เป็นไปตามข้อกำหนดต่อไปนี้

• แหล่งที่มาของ Google Maps ต้องอยู่ต่อจากเนื้อหาที่สร้างขึ้นซึ่งแหล่งที่มานั้นรองรับทันที เนื้อหาที่สร้างขึ้นนี้เรียกอีกอย่างว่าเอาต์พุตที่อิงตามข้อมูล
• แหล่งข้อมูลของ Google Maps ต้องดูได้ภายใน 1 การโต้ตอบของผู้ใช้

แหล่งที่มาของเครื่องมือค้นหาสถานที่

ฟิลด์search_placesเครื่องมือplacesจะระบุแหล่งข้อมูลที่สนับสนุน summary สำหรับ places ระบบจะแสดงข้อมูลเมตาดังต่อไปนี้

• place (ชื่อทรัพยากร)
• id
• location
• googleMapsLinks

คุณต้องสร้างตัวอย่างลิงก์ที่ตรงตามข้อกำหนดต่อไปนี้สำหรับแต่ละสถานที่

• ระบุแหล่งที่มาแต่ละแหล่งไปยัง Google Maps โดยทำตามข้อความ Grounding Lite หลักเกณฑ์การระบุแหล่งที่มา
• ลิงก์ไปยังแหล่งที่มาโดยใช้ places.googleMapsLinks.placeUrl จากคำตอบ

กำหนดค่า LLM ให้ใช้เซิร์ฟเวอร์ MCP

หากต้องการใช้ Grounding Lite คุณต้องมีโปรเจ็กต์ Google Cloud ที่เปิดใช้บริการ API Maps Grounding Lite รวมถึงคีย์ API หรือรหัสไคลเอ็นต์ OAuth จากนั้นคุณจะกำหนดค่า LLM ให้เข้าถึงเซิร์ฟเวอร์ MCP ได้ เซิร์ฟเวอร์ Grounding Lite MCP ใช้การรับส่งข้อมูล HTTP ที่สตรีมได้

เปิดใช้บริการ Maps Grounding Lite ในโปรเจ็กต์ Google Cloud

วิธีเปิดใช้ API ในโปรเจ็กต์

1. ใน Google Cloud Console เลือกโปรเจ็กต์ที่ต้องการใช้สำหรับ Grounding Lite
2. เปิดใช้การเรียกเก็บเงินสำหรับโปรเจ็กต์ใน Google Cloud Console
3. เปิดเทอร์มินัล Cloud Shell จากการนำทางด้านบน

4. เรียกใช้คำสั่งต่อไปนี้เพื่อเปิดใช้บริการและปลายทาง MCP

   gcloud beta services enable mapstools.googleapis.com --project=PROJECT_ID
   gcloud beta services mcp enable mapstools.googleapis.com --project=PROJECT_ID
   

หมายเหตุ: Maps Grounding Lite API จะไม่เรียกเก็บเงินในระหว่างช่วงทดลอง แต่ต้องเปิดใช้การเรียกเก็บเงินในโปรเจ็กต์

ตรวจสอบสิทธิ์โดยใช้คีย์ API

คุณสามารถใช้คีย์ API ที่มีอยู่กับ Maps Grounding Lite หรือสร้างคีย์ใหม่ได้ ตราบใดที่คุณเปิดใช้Maps Grounding Lite API service ทั้งในโปรเจ็กต์ Google Cloud และคีย์

วิธีตรวจสอบสิทธิ์โดยใช้คีย์ API

1. สร้างหรือกำหนดค่าคีย์ API โดยทำตามขั้นตอนในการเริ่มต้นใช้งาน Google Maps Platform
2. ส่งคีย์ไปยังเซิร์ฟเวอร์ MCP โดยใช้ส่วนหัว X-Goog-Api-Key คุณต้อง ระบุสิ่งนี้เป็นส่วนหัว HTTP ที่กำหนดเองในการกำหนดค่าเครื่องมือ MCP ของ LLM

หมายเหตุ: เมื่อสร้างหรือกำหนดค่าคีย์ API โปรดอย่าลืมจำกัดการใช้คีย์โดยใช้ข้อจำกัดที่เหมาะสม ดูข้อมูลเพิ่มเติมได้ที่จำกัดคีย์ API

ตรวจสอบสิทธิ์โดยใช้ OAuth

คุณสามารถตรวจสอบสิทธิ์โดยใช้ OAuth ได้ด้วยการสร้างข้อมูลเข้าสู่ระบบ OAuth และส่งข้อมูลดังกล่าว ไปยังโฮสต์ MCP หรือแอปพลิเคชันเซิร์ฟเวอร์ MCP

วิธีตรวจสอบสิทธิ์โดยใช้ OAuth

1. ใน Google Cloud Console เลือกโปรเจ็กต์ที่ต้องการใช้สำหรับ Grounding Lite
2. ในเมนู API และบริการ ให้เลือกข้อมูลเข้าสู่ระบบ
3. ในเมนูด้านบน ให้เลือกสร้างข้อมูลเข้าสู่ระบบ > รหัสไคลเอ็นต์ OAuth
4. หากโปรเจ็กต์ไม่มีหน้าจอคำยินยอมที่กำหนดค่าไว้ ให้คลิกกำหนดค่า หน้าจอคำยินยอม แล้วทำตามวิธีการบนหน้าจอ
5. ในส่วนเมตริก ให้คลิกสร้างไคลเอ็นต์ OAuth
6. ในหน้าจอสร้างรหัสไคลเอ็นต์ OAuth ให้เลือกประเภทแอปพลิเคชันและป้อน ชื่อสำหรับรหัสไคลเอ็นต์
7. ระบุรายละเอียดเพิ่มเติมที่เกี่ยวข้องกับประเภทการสมัคร เช่น หากคุณสร้างเว็บแอปพลิเคชัน ให้เพิ่ม URI ที่ได้รับอนุญาตสำหรับคำขอของเบราว์เซอร์และเซิร์ฟเวอร์
8. เมื่อสร้างไคลเอ็นต์แล้ว ให้บันทึกรหัสไคลเอ็นต์และรหัสลับ
9. เมื่อกำหนดค่าโฮสต์ MCP หรือแอปพลิเคชันเซิร์ฟเวอร์ MCP เพื่อเข้าถึง Grounding Lite ให้ส่งรหัสไคลเอ็นต์และรหัสลับ OAuth

ดูข้อมูลเพิ่มเติมได้ที่การใช้ OAuth 2.0 เพื่อเข้าถึง Google APIs

กำหนดค่า LLM ให้เข้าถึงเซิร์ฟเวอร์ MCP ของ Grounding Lite

เมื่อมีโปรเจ็กต์ Google Cloud ที่เปิดใช้บริการ Maps Grounding Lite API และมีข้อมูลเข้าสู่ระบบที่ถูกต้อง เช่น คีย์ API หรือรหัสไคลเอ็นต์และข้อมูลลับของ OAuth คุณจะกำหนดค่า LLM ให้เข้าถึงเซิร์ฟเวอร์ MCP ได้โดยทำตาม เอกสารประกอบการกำหนดค่า MCP และใช้ URL ของเซิร์ฟเวอร์ Grounding Lite MCP ดังนี้ https://mapstools.googleapis.com/mcp

ดูข้อมูลเพิ่มเติมได้ที่กำหนดค่า MCP ในแอปพลิเคชัน AI

กำหนดค่า Grounding Lite ด้วย Gemini CLI

ส่วนนี้จะแสดงตัวอย่างวิธีกำหนดค่าเซิร์ฟเวอร์ Grounding Lite MCP โดยใช้ Gemini CLI โปรดดูรายละเอียดเพิ่มเติมที่เซิร์ฟเวอร์ MCP ที่มี Gemini CLI

1. เมื่อติดตั้ง Gemini CLI แล้ว คุณจะใช้คำสั่ง add เพื่อกำหนดค่าเซิร์ฟเวอร์ MCP ของ Maps Grounding Lite ได้โดยทำดังนี้

   gemini mcp add -s user -t http -H 'X-Goog-Api-Key: API_KEY' maps-grounding-lite-mcp https://mapstools.googleapis.com/mcp
   

   หากกำหนดค่าสำเร็จ คุณควรเห็นการยืนยันว่าระบบได้เพิ่มเซิร์ฟเวอร์ลงในการตั้งค่าผู้ใช้แล้ว

2. หากต้องการตรวจสอบว่าเซิร์ฟเวอร์ทำงานอย่างถูกต้อง ให้เรียกใช้/mcp list คำสั่งต่อไปนี้

   > /mcp list
   
   Configured MCP servers:
   
   maps-grounding-lite-mcp - Ready (3 tools)
   Tools:
   -   compute_routes
   -   lookup_weather
   -   search_places
   

3. เริ่มถามคำถามที่เกี่ยวข้องกับ Maps ด้วย CLI เช่น ลองพูดว่า "แนะนำร้านอาหารในเมาน์เทนวิวให้หน่อย" ซึ่งควรเรียกใช้เครื่องมือ search_places ในนามของคุณ

หมายเหตุ: ดูข้อมูลเกี่ยวกับการกำหนดค่าส่วนขยาย Gemini CLI เพื่อเข้าถึง Grounding Lite โดยใช้ OAuth ได้ที่ส่วน Gemini CLI ในเอกสารประกอบของ MCP ใน Google Cloud

การแชร์ความคิดเห็น

หากต้องการแชร์ความคิดเห็นเกี่ยวกับ Grounding Lite ให้ใช้แบบฟอร์มต่อไปนี้

• รายงานข้อบกพร่อง
• ส่งคำขอฟีเจอร์
• แสดงความคิดเห็น