Übersicht
Das Agentic UI Toolkit für die Maps Platform ist ein Entwicklertoolkit, das speziell für das Zeitalter der konversationellen KI entwickelt wurde. Es bietet eine Reihe von LLM-Systemanweisungen und eine Bibliothek mit UI-Komponenten, die Large Language Models (LLMs) und KI-Agenten dabei helfen, interaktive visuelle Echtzeitantworten für Geodaten zu erstellen.
Anstatt visuelle Elemente fest zu codieren, können Sie mit dem Toolkit „absichtsbasierte Anweisungen“ eines LLM in dynamische, kontextbezogene Karten und Ortsanzeigen umwandeln, damit Nutzer im Chat bleiben.
Zu den häufigsten Anwendungsfällen gehören:
- KI-Assistenten:Textantworten werden mit visuellem Kontext für lokale Anfragen (z.B. zu Hotels, Restaurants) ergänzt.
- Reiseplaner:Karten, Routen und Ortsdetails werden inline angezeigt.
- Low-Code-Entwicklung:Die manuelle Orchestrierung mehrerer Maps APIs über Web- und mobile Touchpoints hinweg wird vereinfacht.
Schlüsselkonzepte
1. Für den Einsatz von KI-Agenten geeignete Benutzeroberfläche
Aktivieren Sie skalierbare, hochwertige Visualisierungen wie Ortskarten, immersive Kartenansichten und Routenvorschauen, die speziell für LLM-basierte Echtzeitanwendungen entwickelt wurden.
2. Kontextreiche Funktionen
Nutzer können Informationen finden und Entscheidungen treffen, ohne den Chat zu verlassen. Wenn Sie Inline-Karten mit vielen Kontextinformationen wie Fotogalerien, Bewertungen oder Routenoptionen bereitstellen, können Sie Nutzer besser einbinden und ihnen die Sicherheit geben, die sie für eine Aktion benötigen.
3. Intelligente Komponenten
Das Agentic UI-Toolkit übernimmt die komplexe geospatiale Logik automatisch und passt Kontext und Layout sofort an die Nutzerabsicht an. Gleichzeitig wird das Design so angepasst, dass sich jede Interaktion mit Ihrer Marke verbunden anfühlt.
4. LLM-unabhängig
Das Agentic UI-Toolkit ist modellunabhängig für Ihren KI-Stack. Unabhängig davon, ob Sie Gemini oder Modelle von OpenAI oder Anthropic verwenden und unabhängig von Ihrer Fundierungsdatenquelle bietet das Agentic UI-Toolkit die spezielle Darstellungsebene zum Visualisieren von Standortdaten.
5. Serverseitige Vorlagenarchitektur
Die serverseitige Vorlagenarchitektur beschleunigt das Rendern von Komponenten, da die Vorlagenerweiterung und die Parameterauflösung auf dem Server erfolgen. Dadurch wird die Latenz für Echtzeit-Dialoge deutlich verbessert.
Erste Schritte
Um das Agentic UI-Toolkit zu verwenden, müssen Sie es mit einem Google Gemini API-Schlüssel und einem Google Maps Platform API-Schlüssel initialisieren.
Eine ausführliche Anleitung finden Sie im Startleitfaden.
UI-Ergebnisse
Das Agentic UI Toolkit bietet eine umfassende Suite spezialisierter UI-Funktionen, die sofort einsatzbereit sind. Diese Komponenten sind im Web sowie auf Android- und iOS-Geräten verfügbar.
- Place Detail (Compact) (Ortsdetails (kompakt)): Spezifische Informationen zu einem POI in einer kompakten Karte.
- Inline-Karten: Punkt- oder Bereichs-Locator.
- Inline-Karte + Route: Vorschauen für Navigation oder Fahrten.
- Inline-Kartendetails: Stimmung oder Kontext des Orts mit aussagekräftigen Bildern.
Systemanweisungen
Das Agentic UI-Toolkit enthält „Systemanweisungen“, die das Host-LLM anleiten, wann und wie die Benutzeroberfläche erstellt werden soll.
Richtlinien
Das Hostmodell muss Folgendes verstehen:
Welche Komponente passt zu welcher Nutzerintention (z.B. Inline-Karte für Orientierungsanfragen).
Parameterzuordnung von natürlicher Sprache zum Schema (z.B. wenn der Nutzer nach „malerisch“ fragt, wird der Kartenmodus auf „Satellit“ gesetzt).
Schema für die Toolnutzung
Das Agentic UI-Toolkit bietet einen Katalog mit Definitionen, die mit dem Standardschema für die Tool-Nutzung von LLMs (z.B. Funktionsaufrufe) kompatibel sind.
Richtlinien und Nutzungsbedingungen
Diese Bibliothek verwendet Google Maps Platform-Dienste. Die Nutzung von Google Maps Platform-Diensten über diese Bibliothek unterliegt den Nutzungsbedingungen der Google Maps Platform. Für einige APIs und Backend-Dienste wie Grounding Lite und Grounding with Google Maps gelten zusätzliche Nutzungsbedingungen, die ebenfalls eingehalten werden müssen.
Diese Bibliothek ist kein Google Maps Platform-Hauptdienst. Daher gelten die Google Maps Platform-Nutzungsbedingungen (z.B. für Support-Dienste, Service Level Agreements und Richtlinien zur Einstellung von Diensten) nicht für den Code in dieser Bibliothek.
Support
Diese Bibliothek wird unter einer Open-Source-Lizenz angeboten. Sie unterliegt nicht den Richtlinien für technische Support-Dienste für die Google Maps Platform, dem SLA oder der Richtlinie zur Einstellung von Produkten und Diensten. Alle von der Bibliothek verwendeten Google Maps Platform-Dienste unterliegen jedoch weiterhin den Nutzungsbedingungen der Google Maps Platform.
Anforderungen bezüglich Quellenangaben für Google Maps-Quellen
Jede Tool-Antwort aus dem Agentic UI-Toolkit enthält Quellen. Wenn Sie Ergebnisse präsentieren, für die Tools aus dem Toolkit verwendet werden, müssen Sie die zugehörigen Google Maps-Quellen so angeben, dass die folgenden Anforderungen erfüllt sind:
- Die Google Maps-Quellen müssen unmittelbar auf die generierten Inhalte folgen, die durch die Quellen belegt werden.
- Die Google Maps-Quellen müssen innerhalb einer Nutzerinteraktion sichtbar sein.
Feedback geben
Wenn Sie Feedback zum Maps Agentic UI Toolkit geben möchten, verwenden Sie die folgenden Formulare: