Maps Agentic UI toolkit (sperimentale)

Panoramica

Il toolkit dell'interfaccia utente agentica 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 dell'interfaccia utente 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'intento" da un LLM in mappe dinamiche e sensibili al contesto e visualizzazioni dei luoghi, mantenendo gli utenti coinvolti nell'esperienza di chat.

I casi d'uso comuni includono:

  • Assistenti AI: aumento delle risposte di testo con contesto visivo per le query locali (ad es. hotel, ristoranti).
  • Pianificatori di viaggi: visualizzazione in linea di mappe, itinerari e dettagli dei luoghi.
  • Sviluppo low-code: riduzione delle difficoltà di orchestrazione manuale di più API Maps.

Concetti fondamentali

1. Interfaccia utente pronta per l'agente

Abilita elementi visivi scalabili e di alta qualità, come schede dei luoghi, visualizzazioni immersive delle mappe e anteprime degli itinerari, progettati specificamente per le esperienze in tempo reale basate su LLM.

2. Esperienze ricche di contesto

Consenti agli utenti di scoprire e decidere senza uscire dalla chat. Fornire un contesto di mappe in linea ricco, come gallerie di foto, valutazioni o opzioni di itinerario, mantiene gli utenti coinvolti e dà loro la sicurezza di agire.

3. Componenti intelligenti

Il toolkit dell'interfaccia utente agentica gestisce automaticamente la complessa logica geospaziale, adattando istantaneamente il contesto e il layout all'intento dell'utente, applicando uno stile per garantire che ogni interazione sia connessa al tuo brand.

4. Indipendente da LLM

Il toolkit dell'interfaccia utente agentica è indipendente dal modello dello stack AI. Che tu utilizzi Gemini o modelli di OpenAI o Anthropic e indipendentemente dalla fonte di dati basata su grounding, il toolkit dell'interfaccia utente agentica fornisce il livello di presentazione dedicato per visualizzare i dati sulla posizione.

Per iniziare

Per iniziare a utilizzare il toolkit dell'interfaccia utente agentica, devi inizializzarlo con una singola chiave API. In questo modo, i servizi Maps sottostanti vengono astratti, quindi non devi gestire API separate.

Per istruzioni dettagliate, consulta la guida introduttiva.

Risultati dell'interfaccia utente

Il toolkit dell'interfaccia utente agentica fornisce una suite completa di funzionalità dell'interfaccia utente specializzate.

  • Dettagli del luogo (compatti): 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 località utilizzando immagini ricche.

Istruzioni di sistema

Il toolkit dell'interfaccia utente agentica fornisce "istruzioni di sistema" per guidare l'LLM host su quando e come costruire l'interfaccia utente.

Linee guida

Il modello host deve comprendere:

  1. Quale componente corrisponde a quale intento dell'utente (ad es. utilizzare la mappa in linea per le query di orientamento).

  2. Mappatura dei parametri dal linguaggio naturale allo schema (ad es. se l'utente chiede "panoramico", imposta la modalità mappa su satellite).

Schema di utilizzo degli strumenti

Il toolkit dell'interfaccia utente agentica espone un catalogo di definizioni compatibili con lo schema di utilizzo degli strumenti LLM standard (ad es. chiamata di funzioni).

Norme e Termini di servizio

Questa libreria utilizza i servizi di 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 alcuni 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 sul ritiro) non si applicano al codice di questa libreria.

Assistenza

Questa libreria viene offerta tramite una licenza open source. Non è regolata da le Linee guida per i servizi di assistenza tecnica di Google Maps Platform, dall'accordo sul livello del servizio, o dalle norme sul ritiro. Tuttavia, tutti i servizi di 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 i risultati che utilizzano gli strumenti forniti dal toolkit, devi includere le fonti 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 in un'unica interazione dell'utente.