סקירה כללית
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, ולא משנה מה מקור הנתונים המבוסס, ערכת הכלים של ממשק המשתמש מבוסס-סוכן מספקת את שכבת ההצגה הייעודית להצגת נתוני מיקום.
תחילת העבודה
כדי להתחיל להשתמש בערכת הכלים של ממשק המשתמש מבוסס-הסוכן, צריך לאתחל אותה באמצעות מפתח API יחיד. הספרייה הזו מפשטת את שירותי מפות Google הבסיסיים, כך שלא צריך לנהל ממשקי API נפרדים.
הוראות מפורטות זמינות במדריך לתחילת העבודה.
תוצאות בממשק המשתמש
ערכת הכלים לממשק משתמש מבוסס-סוכן מספקת חבילה מקיפה של יכולות ממשק משתמש ייעודיות, מוכנות לשימוש.
- פרטי מקום (קומפקטי): מידע ספציפי על נקודת עניין בכרטיס קומפקטי.
- מפות מוטבעות: איתור נקודה או אזור.
- מפה מוטמעת + מסלול: תצוגות מקדימות של ניווט או מסלול.
- פרטים במפה בתוך הטקסט: אווירה או הקשר של המיקום באמצעות תמונות עשירות.
הוראות מערכת
ערכת הכלים של ממשק המשתמש מבוסס-הסוכן מספקת 'הוראות מערכת' כדי להנחות את מודל ה-LLM המארח מתי ואיך לבנות את ממשק המשתמש.
הנחיות
המודל המארח צריך להבין:
איזה רכיב מתאים לאיזו כוונת משתמש (למשל, שימוש במפה מוטמעת לשאלות שקשורות להתמצאות).
מיפוי פרמטרים משפה טבעית לסכימה (לדוגמה, אם המשתמש מבקש "נוף", צריך להגדיר את מצב המפה ללוויין).
סכמה של שימוש בכלי
ערכת הכלים של ממשק המשתמש מבוסס-הסוכן חושפת קטלוג של הגדרות שתואמות לסכימה סטנדרטית של שימוש בכלים ב-LLM (לדוגמה, קריאה לפונקציה).
מדיניות ותנאים והגבלות
הספרייה הזו משתמשת בשירותים של Google Maps Platform. השימוש בשירותים של Google Maps Platform דרך הספרייה הזו כפוף לתנאים ולהגבלות של Google Maps Platform. חלק מממשקי ה-API ושירותי ה-Backend, כמו Grounding Lite ו-עיגון בעזרת מפות Google, כפופים לדרישות לגבי שירותים נוספים של התנאים וההגבלות, שגם בהן צריך לעמוד.
הספרייה הזו היא לא שירות ליבה של Google Maps Platform. לכן, התנאים וההגבלות של הפלטפורמה של מפות Google (למשל, שירותי תמיכה טכנית, הסכמי רמת שירות ומדיניות הוצאה משימוש) לא חלים על הקוד בספרייה הזו.
תמיכה
הספרייה הזו מוצעת באמצעות רישיון קוד פתוח. היא לא כפופה להנחיות לשירותי תמיכה טכנית של Google Maps Platform, להסכם רמת השירות (SLA) או למדיניות הוצאה משימוש. עם זאת, כל השירותים של הפלטפורמה של מפות Google שנעשה בהם שימוש בספרייה עדיין כפופים לתנאים ולהגבלות של הפלטפורמה של מפות Google.
דרישות ייחוס למקורות של מפות Google
כל תשובה של כלי מ-Agentic UI toolkit כוללת מקורות. כשמציגים תוצאות שמשתמשות בכלים שסופקו על ידי ערכת הכלים, צריך לכלול את המקורות המשויכים של מפות Google באופן שעומד בדרישות הבאות:
- המקורות של מפות Google צריכים להופיע מיד אחרי התוכן שנוצר ושנתמך על ידי המקורות.
- מקורות המידע במפות Google צריכים להיות גלויים באינטראקציה אחת של המשתמש.