סקירה כללית
Agentic UI toolkit (ערכת כלים לסוכן AI) של Maps Platform היא ערכת כלים למפתחים שנועדה במיוחד לעידן של AI בממשק שיחה. היא מספקת קבוצה של הוראות מערכת למודלים גדולים של שפה (LLM) וספרייה של רכיבי ממשק משתמש שעוזרים למודלים גדולים של שפה (LLM) ולסוכני AI ליצור תגובות חזותיות אינטראקטיביות בזמן אמת לנתונים גיאו-מרחביים.
במקום לקודד קשיח רכיבים חזותיים, מפתחים יכולים להשתמש בערכת הכלים כדי לתרגם 'הוראות מבוססות כוונות' מ-LLM למפות דינמיות ולתצוגות של מקומות שמודעות להקשר, וכך לשמור על מעורבות המשתמשים בחוויית הצ'אט.
תרחישים נפוצים לדוגמה:
- עוזרים מבוססי-AI: הוספת הקשר ויזואלי לתשובות טקסט לשאילתות מקומיות (למשל, מלונות, מסעדות).
- מתכנני נסיעות: הצגת מפות, מסלולים ופרטי מקומות בתוך התוכן.
- פיתוח עם מינימום קוד: הפחתת החיכוך שנוצר כתוצאה מתיאום ידני של כמה ממשקי Maps API בנקודות מגע באינטרנט ובנייד.
מושגים מרכזיים
1. ממשק משתמש מוכן לסוכנים
הפעלה של תוכן חזותי איכותי שניתן להתאמה לעומס – כמו כרטיסי מקומות, תצוגות מפה היקפיות ותצוגות מקדימות של מסלולים – שתוכנן במיוחד לחוויות בזמן אמת שמבוססות על מודלים גדולים של שפה (LLM).
2. חוויות עשירות בהקשר
המשתמשים יכולים לחפש ולבחור בלי לצאת מהצ'אט. הוספת הקשר עשיר למפות מוטבעות – כמו גלריות תמונות, דירוגים או אפשרויות מסלול – עוזרת לשמור על מעורבות המשתמשים ומעניקה להם את הביטחון לבצע פעולה.
3. רכיבים חכמים
ערכת הכלים של ממשק המשתמש מבוססת-הסוכן מטפלת אוטומטית בלוגיקה הגיאוספציאלית המורכבת – היא מתאימה את ההקשר והפריסה באופן מיידי לכוונת המשתמש – וגם מעצבת את הממשק כדי להבטיח שכל אינטראקציה תרגיש קשורה למותג שלכם.
4. מתאים לכל מודלי ה-LLM
ערכת הכלים לסוכן AI לא תלויה במודל מסוים בערימת ה-AI. בין אם אתם משתמשים ב-Gemini או במודלים של OpenAI או Anthropic, ובלי קשר למקור הנתונים המבוסס על עובדות, ערכת הכלים של ממשק המשתמש מבוסס-סוכנים מספקת את שכבת ההצגה הייעודית להצגת נתוני מיקום.
תחילת העבודה
כדי להתחיל להשתמש בערכת הכלים Agentic UI, צריך להפעיל אותה באמצעות מפתח Google Gemini API ומפתח Google Maps Platform API.
הוראות מפורטות זמינות במדריך לתחילת העבודה.
תוצאות בממשק המשתמש
ערכת הכלים לממשק משתמש מבוסס-סוכן מספקת חבילה מקיפה של יכולות ממשק משתמש ייעודיות, ללא צורך בהגדרה. הרכיבים האלה זמינים באינטרנט, ב-Android וב-iOS.
- פרטי מקום (קומפקטיים): מידע ספציפי על נקודת עניין בכרטיס קומפקטי.
- מפות מוטבעות: איתור נקודה או אזור.
- מפה מוטמעת + מסלול: תצוגות מקדימות של ניווט או מסלול.
- פרטים על המפה בתוך הטקסט: אווירה או הקשר של המיקום באמצעות תמונות עשירות.
הוראות מערכת
ערכת הכלים של ממשק המשתמש מבוסס-הסוכן מספקת 'הוראות מערכת' כדי להנחות את מודל ה-LLM המארח מתי ואיך לבנות את ממשק המשתמש.
הנחיות
המודל המארח צריך להבין:
איזה רכיב מתאים לאיזו כוונת משתמש (למשל, שימוש במפה מוטבעת לשאלות שקשורות להתמצאות).
מיפוי פרמטרים משפה טבעית לסכימה (למשל, אם המשתמש מבקש "נוף", צריך להגדיר את מצב המפה ללוויין).
סכמה של שימוש בכלי
ערכת הכלים של ממשק המשתמש מבוססת על קטלוג של הגדרות שתואמות לסכימה סטנדרטית של שימוש בכלים של מודלים גדולים של שפה (LLM) (לדוגמה, קריאה לפונקציה).
מדיניות ותנאים והגבלות
הספרייה הזו משתמשת בשירותים של Google Maps Platform. השימוש בשירותים של Google Maps Platform דרך הספרייה הזו כפוף לתנאים ולהגבלות של Google Maps Platform. חלק מממשקי ה-API ושירותי ה-Backend, כמו Grounding Lite ו-Grounding with Google Maps, כוללים דרישות נוספות של התנאים וההגבלות, שגם בהן צריך לעמוד.
הספרייה הזו היא לא שירות ליבה של Google Maps Platform. לכן, התנאים וההגבלות של הפלטפורמה של מפות Google (למשל, שירותי תמיכה טכנית, הסכמי רמת שירות ומדיניות הוצאה משימוש) לא חלים על הקוד בספרייה הזו.
תמיכה
הספרייה הזו מוצעת באמצעות רישיון קוד פתוח. היא לא כפופה להנחיות לשירותי תמיכה טכנית של Google Maps Platform, להסכם רמת השירות (SLA) או למדיניות הוצאה משימוש. עם זאת, כל השירותים של הפלטפורמה של מפות Google שנעשה בהם שימוש בספרייה עדיין כפופים לתנאים ולהגבלות של הפלטפורמה של מפות Google.
דרישות ייחוס למקורות במפות Google
כל תשובה של כלי מתוך ערכת הכלים של ממשק המשתמש מבוסס-סוכנים כוללת מקורות. כשמציגים תוצאות שמשתמשות בכלים שסופקו על ידי ערכת הכלים, צריך לכלול את המקורות המשויכים של מפות Google באופן שעומד בדרישות הבאות:
- המקורות של מפות Google צריכים להופיע מיד אחרי התוכן שנוצר ושנתמך על ידי המקורות.
- מקורות המידע במפות Google צריכים להיות גלויים באינטראקציה אחת של המשתמש.
שיתוף משוב
כדי לשלוח משוב על ערכת הכלים לסוכן AI ב-Maps, אפשר להשתמש בטפסים הבאים: