Maps Agentic UI Toolkit (experimentell)

Übersicht

Das Agentic UI Toolkit für die Google 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 Entwickler das Toolkit verwenden, um „absichtsbasierte Anweisungen“ eines LLM in dynamische, kontextbezogene Karten und Ortsanzeigen zu übersetzen. So können 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. Hotels, Restaurants) ergänzt.
  • Reiseplaner:Karten, Routen und Ortsdetails werden inline angezeigt.
  • Low-Code-Entwicklung:Die manuelle Orchestrierung mehrerer Maps APIs wird vereinfacht.

Wichtige Konzepte

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 Umgebungen

Nutzer können direkt im Chat Informationen finden und Entscheidungen treffen. Wenn Sie Inline-Karten mit Kontextinformationen wie Fotogalerien, Bewertungen oder Routenoptionen bereitstellen, können Sie Nutzer besser einbinden und ihnen die Sicherheit geben, Aktionen auszuführen.

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 verbindet.

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 fundierten Datenquelle bietet das Agentic UI-Toolkit die spezielle Darstellungsebene zum Visualisieren von Standortdaten.

Erste Schritte

Bevor Sie das Agentic UI-Toolkit verwenden können, müssen Sie es mit einem einzelnen API-Schlüssel initialisieren. Dadurch werden die zugrunde liegenden Maps-Dienste abstrahiert, sodass Sie keine separaten APIs verwalten müssen.

Eine ausführliche Anleitung finden Sie im Startleitfaden.

UI-Ergebnisse

Das Agentic UI Toolkit bietet eine umfassende Suite von speziellen UI-Funktionen, die sofort einsatzbereit sind.

  • 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 mithilfe von 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:

  1. Welche Komponente passt zu welcher Nutzerabsicht (z.B. Inline-Karte für Orientierungsanfragen).

  2. Parameterzuordnung von natürlicher Sprache zum Schema (z.B. wenn der Nutzer nach „landschaftlich schön“ fragt, wird der Kartenmodus auf „Satellit“ festgelegt).

Schema für die Tool-Nutzung

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 Fundierung mit 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. technische Supportdienste, Service Level Agreements und Richtlinie zur Einstellung von Produkten und 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 Supportdienste 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 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 direkt auf die generierten Inhalte folgen, die durch die Quellen belegt werden.
  • Die Google Maps-Quellen müssen innerhalb einer Nutzerinteraktion sichtbar sein.