Panoramica
Agentic UI toolkit di Maps Platform è un toolkit per sviluppatori progettato specificamente per l'era dell'AI conversazionale. Fornisce un insieme di istruzioni di sistema LLM e una libreria di componenti UI che aiutano i modelli linguistici di grandi dimensioni (LLM) e gli agenti AI a creare risposte visive interattive in tempo reale per i dati geospaziali.
Anziché codificare gli elementi visivi, gli sviluppatori possono utilizzare il toolkit per tradurre le "istruzioni basate sull'intent" di un LLM in mappe e visualizzazioni di luoghi dinamiche e sensibili al contesto, mantenendo gli utenti coinvolti nell'esperienza di chat.
I casi d'uso comuni includono:
- Assistenti AI: arricchimento delle risposte di testo con contesto visivo per le query locali (ad es. hotel, ristoranti).
- Pianificatori di viaggi:mostrano mappe, itinerari e dettagli dei luoghi in linea.
- Sviluppo low-code:riduce l'attrito dell'orchestrazione manuale di più API Maps su punti di contatto web e mobile.
Concetti fondamentali
1. UI pronta per l'agente
Abilita immagini scalabili e di alta qualità, come schede dei luoghi, visualizzazioni immersive delle mappe e anteprime dei percorsi, progettate specificamente per esperienze in tempo reale basate su LLM.
2. Esperienze legate al contesto
Consenti agli utenti di scoprire e decidere senza uscire dalla chat. Fornire un contesto ricco per le mappe inline, come gallerie fotografiche, valutazioni o opzioni di itinerario, mantiene gli utenti coinvolti e dà loro la sicurezza di agire.
3. Componenti intelligenti
Il toolkit dell'interfaccia utente con agenti gestisce automaticamente la complessa logica geospaziale, adattando istantaneamente il contesto e il layout all'intento dell'utente, mentre lo stile garantisce che ogni interazione sia collegata al tuo brand.
4. Indipendente dall'LLM
Il toolkit per la UI agentica è indipendente dal modello per il tuo stack AI. Indipendentemente dal fatto che utilizzi Gemini o modelli di OpenAI o Anthropic e dall'origine dei dati di base, Agentic UI toolkit fornisce il livello di presentazione dedicato per visualizzare i dati sulla posizione.
Per iniziare
Per iniziare a utilizzare il toolkit UI Agentic, devi inizializzarlo con una chiave API Google Gemini e una chiave API Google Maps Platform.
Per istruzioni dettagliate, consulta la guida introduttiva.
Risultati della UI
Agentic UI Toolkit fornisce una suite completa di funzionalità UI specializzate pronte all'uso. Questi componenti sono disponibili su web, Android e iOS.
- Dettagli luogo (compatto): informazioni specifiche sui PDI in una scheda compatta.
- Mappe in linea: localizzatore di punti o aree.
- Mappa in linea + Itinerario: anteprime di navigazione o viaggio.
- Dettagli della mappa in linea: atmosfera o contesto della posizione utilizzando immagini avanzate.
Istruzioni di sistema
Il toolkit UI agentico fornisce "istruzioni di sistema" per guidare l'LLM host su quando e come costruire la UI.
Linee guida
Il modello host deve comprendere:
Quale componente corrisponde a quale intento dell'utente (ad es. utilizza la mappa in linea per le query di orientamento).
Mappatura dei parametri dal linguaggio naturale allo schema (ad es. se l'utente chiede "panoramico", imposta la modalità mappa su satellite).
Schema di utilizzo dello strumento
Il toolkit UI agentico espone un catalogo di definizioni compatibili con lo schema di utilizzo degli strumenti LLM standard (ad es. chiamata di funzione).
Norme e Termini di servizio
Questa libreria utilizza i servizi Google Maps Platform. L'utilizzo dei servizi di Google Maps Platform tramite questa libreria è soggetto ai Termini di servizio di Google Maps Platform. Alcune API e servizi di backend, come Grounding Lite e Grounding con Google Maps, hanno requisiti aggiuntivi dei Termini di servizio che devono essere soddisfatti.
Questa libreria non è un servizio principale di Google Maps Platform. Pertanto, i Termini di servizio di Google Maps Platform (ad es. servizi di assistenza tecnica, accordi sul livello del servizio e norme di ritiro) non si applicano al codice di questa libreria.
Assistenza
Questa libreria viene offerta tramite una licenza open source. Non è regolato dalle Linee guida per i servizi di assistenza tecnica di Google Maps Platform, dal Contratto di livello di servizio o dalle Norme sul ritiro. Tuttavia, tutti i servizi Google Maps Platform utilizzati dalla libreria rimangono soggetti ai Termini di servizio di Google Maps Platform.
Requisiti di attribuzione per le fonti di Google Maps
Ogni risposta dello strumento del toolkit UI agentica include le fonti. Quando presenti risultati che utilizzano strumenti forniti dal toolkit, devi includere le origini di Google Maps associate in modo da soddisfare i seguenti requisiti:
- Le fonti di Google Maps devono seguire immediatamente i contenuti generati che supportano le fonti.
- Le fonti di Google Maps devono essere visualizzabili con una sola interazione dell'utente.
Condividere feedback
Per condividere il tuo feedback su Maps Agentic UI Toolkit, utilizza i seguenti moduli: