Panoramica
L'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, puoi 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: arricchiscono le risposte di testo con il contesto visivo per le query locali, come hotel e 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
Crea immagini scalabili e di alta qualità, come schede dei luoghi, viste immersive delle mappe e anteprime dei percorsi, progettate specificamente per esperienze in tempo reale basate su LLM.
2. Esperienze basate sul contesto
Aiuta gli utenti a scoprire e decidere senza uscire dalla chat. Fornisci un contesto ricco per le mappe incorporate, ad esempio gallerie fotografiche, valutazioni o opzioni di itinerario, per mantenere gli utenti coinvolti e dare loro la sicurezza di agire.
3. Componenti intelligenti
Il toolkit UI agentico gestisce automaticamente la complessa logica geospaziale, adattando istantaneamente il contesto e il layout all'intento dell'utente e applicando uno stile per garantire 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, modelli di OpenAI o Anthropic e dalla fonte dei dati di base, il toolkit fornisce un livello di presentazione dedicato per visualizzare i dati sulla posizione.
5. Architettura dei modelli lato server
L'architettura dei modelli lato server accelera il rendering dei componenti eseguendo l'espansione dei modelli e la risoluzione dei parametri sul lato server. In questo modo si riduce la latenza per le esperienze di conversazione in tempo reale.
Inizia
Per iniziare a utilizzare il toolkit UI Agentic, devi inizializzarlo con una chiave API Google Gemini e una chiave API Google Maps Platform.
Per saperne di più, consulta la sezione Guida introduttiva.
Risultati dell'UI
Il toolkit UI agentico fornisce una suite completa di funzionalità UI specializzate pronte all'uso. Questi componenti sono disponibili sul web, Android e iOS.
- Dettagli del luogo, compatti: informazioni specifiche su un punto d'interesse (PDI) in una scheda compatta
- Mappe in linea: indicatore di punto o area
- Mappa in linea + Itinerario: anteprime di navigazione o del viaggio
- Dettagli della mappa in linea: dettagli o contesto della posizione utilizzando immagini avanzate
Istruzioni di sistema
Il toolkit UI agentico fornisce "istruzioni di sistema" per guidare il LLM host su quando e come costruire la UI.
Linee guida
Il modello host deve comprendere i seguenti concetti:
- Come abbinare i componenti all'intento dell'utente, ad esempio utilizzando la mappa in linea per le query di orientamento.
- Come mappare i parametri dal linguaggio naturale allo schema, ad esempio impostando la modalità mappa su satellite se l'utente chiede "panoramica".
Schema di utilizzo dello strumento
Il toolkit UI agentico espone un catalogo di definizioni compatibili con lo schema di utilizzo degli strumenti LLM standard, come le chiamate 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, come i servizi di assistenza tecnica, gli accordi sul livello del servizio e le norme di ritiro, non si applicano al codice di questa libreria.
Assistenza
Questa libreria è offerta con 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 di 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 dell'interfaccia utente 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.
Condividi feedback
Per condividere il tuo feedback sul toolkit Maps Agentic UI, utilizza i seguenti moduli: