סקירה כללית
Agentic UI toolkit (ערכת כלים לסוכן AI) של הפלטפורמה של מפות Google היא ערכת כלים למפתחים שנועדה במיוחד לעידן של AI בממשק שיחה. היא מספקת קבוצה של הוראות מערכת למודלים גדולים של שפה (LLM) וספרייה של רכיבי ממשק משתמש שעוזרים למודלים גדולים של שפה (LLM) ולסוכני AI ליצור תשובות חזותיות אינטראקטיביות בזמן אמת לנתונים גיאו-מרחביים.
במקום לקודד באופן קשיח רכיבים חזותיים, אפשר להשתמש בערכת הכלים כדי לתרגם 'הוראות מבוססות-כוונה' מ-LLM למפות דינמיות ולתצוגות של מקומות שמודעות להקשר, וכך לשמור על מעורבות המשתמשים בחוויית הצ'אט.
תרחישים נפוצים לדוגמה:
- עוזרים מבוססי-AI: הוספת הקשר ויזואלי לתשובות טקסט לשאילתות מקומיות (למשל, מלונות, מסעדות).
- מתכנני נסיעות: הצגת מפות, מסלולים ופרטי מקומות בתוך הטקסט.
- פיתוח עם תכנות מינימלי: הפחתת החיכוך שנוצר כתוצאה מתיאום ידני של כמה ממשקי Maps API בנקודות מגע באינטרנט ובנייד.
מושגים מרכזיים
1. ממשק משתמש מוכן לסוכן
הפעלת תוכן חזותי איכותי שניתן להתאמה לעומס – כמו כרטיסי מקומות, תצוגות מרהיבות של מפות ותצוגות מקדימות של מסלולים – שנועד במיוחד לחוויות בזמן אמת שמבוססות על מודלים גדולים של שפה (LLM).
2. חוויות עשירות בהקשר
המשתמשים יכולים לגלות ולבחור אפליקציות בלי לצאת מהצ'אט. הוספת הקשר עשיר למפות מוטבעות – כמו גלריות תמונות, דירוגים או אפשרויות מסלול – עוזרת לשמור על העניין של המשתמשים ומעודדת אותם לפעול.
3. רכיבים חכמים
ערכת הכלים של ממשק המשתמש מבוססת-הסוכן מטפלת בלוגיקה הגיאוספציאלית המורכבת באופן אוטומטי – היא מתאימה את ההקשר והפריסה באופן מיידי לכוונת המשתמש – וגם מעצבת את הממשק כדי להבטיח שכל אינטראקציה תרגיש קשורה למותג שלכם.
4. מתאים לכל מודלי ה-LLM
ערכת הכלים לסוכן AI מתאימה לכל המודלים של סטאק ה-AI. בין אם אתם משתמשים ב-Gemini או במודלים של OpenAI או Anthropic, ובלי קשר למקור הנתונים המבוסס, ערכת הכלים של ממשק המשתמש מבוסס-סוכנים מספקת את שכבת ההצגה הייעודית להצגת נתוני מיקום.
5. ארכיטקטורת תבניות בצד השרת
ארכיטקטורת התבניות בצד השרת מאיצה את עיבוד הרכיבים על ידי ביצוע הרחבת התבנית ופתרון הפרמטרים בצד השרת. השינוי הזה משפר באופן משמעותי את זמן האחזור בחוויית שיחה בזמן אמת.
תחילת העבודה
כדי להתחיל להשתמש בערכת הכלים Agentic UI, צריך להפעיל אותה באמצעות מפתח Google Gemini API ומפתח Google Maps Platform API.
הוראות מפורטות זמינות במדריך לתחילת העבודה.
תוצאות בממשק המשתמש
ערכת הכלים לסוכן AI מספקת חבילה מקיפה של יכולות ממשק משתמש ייעודיות שמוכנות לשימוש. הרכיבים האלה זמינים באינטרנט, ב-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 Maps Platform שנעשה בהם שימוש בספרייה עדיין כפופים לתנאים ולהגבלות של Google Maps Platform.
דרישות השיוך למקורות של מפות Google
כל תשובה של כלי מתוך ערכת הכלים של Agentic UI כוללת מקורות. כשמציגים תוצאות שנוצרו באמצעות כלים שסופקו בערכת הכלים, צריך לכלול את המקורות הרלוונטיים של מפות Google באופן שעומד בדרישות הבאות:
- המקורות של מפות Google חייבים להופיע מיד אחרי התוכן שנוצר ושנתמך על ידי המקורות.
- מקורות המידע במפות Google צריכים להיות גלויים במהלך אינטראקציה אחת של המשתמש.
שיתוף משוב
כדי לשתף משוב על ערכת הכלים לסוכן AI ב-Maps, אפשר להשתמש בטפסים הבאים: