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