Przegląd
Zestaw agentowych narzędzi interfejsu Google Maps Platform to zestaw narzędzi dla programistów zaprojektowany specjalnie z myślą o erze konwersacyjnej AI. Zawiera zestaw instrukcji systemowych LLM i bibliotekę komponentów interfejsu, które pomagają dużym modelom językowym (LLM) i agentom AI tworzyć interaktywne odpowiedzi wizualne w czasie rzeczywistym na podstawie danych geoprzestrzennych.
Zamiast kodować na stałe elementy wizualne, deweloperzy mogą używać tego zestawu narzędzi do tłumaczenia „instrukcji opartych na intencjach” z LLM na dynamiczne, uwzględniające kontekst mapy i wyświetlanie miejsc, dzięki czemu użytkownicy pozostaną zaangażowani w czat.
Częste przypadki użycia:
- Asystenci AI: uzupełnianie odpowiedzi tekstowych kontekstem wizualnym w przypadku zapytań lokalnych (np. dotyczących hoteli czy restauracji).
- Planowanie podróży: wyświetlanie map, tras i szczegółów miejsc w tekście.
- Programowanie z użyciem małej ilości kodu: zmniejszenie trudności związanych z ręcznym koordynowaniem wielu interfejsów API Map Google w różnych punktach styku w internecie i na urządzeniach mobilnych.
Kluczowych pojęć
1. Interfejs gotowy do użycia przez agenta
Umożliwia wyświetlanie skalowalnych, wysokiej jakości elementów wizualnych, takich jak karty miejsc, widoki mapy z elementami 3D i podglądy tras, które są specjalnie zaprojektowane do obsługi w czasie rzeczywistym przez funkcje oparte na LLM.
2. Usługi oparte na kontekście
Umożliwiaj użytkownikom odkrywanie i podejmowanie decyzji bez opuszczania czatu. Zapewnienie bogatego kontekstu map wbudowanych, np. galerii zdjęć, ocen lub opcji trasy, zwiększa zaangażowanie użytkowników i zachęca ich do działania.
3. Inteligentne komponenty
Zestaw narzędzi do tworzenia interfejsu opartego na agentach automatycznie obsługuje złożoną logikę geoprzestrzenną, natychmiast dostosowując kontekst i układ do intencji użytkownika, a także stylizując elementy, aby każda interakcja była powiązana z Twoją marką.
4. Niezależne od LLM
Zestaw narzędzi interfejsu agentowego jest niezależny od modelu w Twoim stosie AI. Niezależnie od tego, czy korzystasz z Gemini, modeli OpenAI czy Anthropic, i niezależnie od źródła danych, zestaw narzędzi interfejsu Agentic zapewnia dedykowaną warstwę prezentacji do wizualizacji danych o lokalizacji.
Pierwsze kroki
Aby zacząć korzystać z zestawu narzędzi Agentic UI, musisz go zainicjować za pomocą klucza interfejsu Google Gemini API i klucza interfejsu API Google Maps Platform.
Szczegółowe instrukcje znajdziesz w przewodniku dla początkujących.
Wyniki UI
Zestaw agentowych narzędzi interfejsu zapewnia kompleksowy zestaw specjalistycznych funkcji interfejsu od razu po wyjęciu z pudełka. Te komponenty są dostępne w przeglądarce oraz na urządzeniach z Androidem i iOS.
- Szczegóły miejsca (kompaktowe): szczegółowe informacje o interesującym Cię miejscu na kompaktowej karcie.
- Mapy w tekście: lokalizator punktu lub obszaru.
- Mapa w tekście + trasa: podgląd nawigacji lub podróży.
- Szczegóły mapy w tekście: klimat lub kontekst lokalizacji z wykorzystaniem bogatych obrazów.
Instrukcje systemowe
Zestaw narzędzi interfejsu agenta udostępnia „instrukcje systemowe”, które informują model LLM hosta, kiedy i jak tworzyć interfejs.
Wytyczne
Model hosta musi rozumieć:
który komponent pasuje do intencji użytkownika (np. używaj mapy wbudowanej w przypadku zapytań dotyczących orientacji);
Mapowanie parametrów z języka naturalnego na schemat (np. jeśli użytkownik poprosi o „widokową”, ustaw tryb mapy na satelitarny).
Schemat użycia narzędzia
Zestaw narzędzi do tworzenia interfejsu agenta udostępnia katalog definicji zgodnych ze standardowym schematem używania narzędzi LLM (np. wywoływania funkcji).
Zasady i warunki korzystania z usługi
Ta biblioteka korzysta z usług Google Maps Platform. Korzystanie z usług Google Maps Platform za pomocą tej biblioteki podlega Warunkom korzystania z usługi Google Maps Platform. Niektóre interfejsy API i usługi backendu, takie jak Grounding Lite i Grounding z użyciem Map Google, mają dodatkowe wymagania dotyczące Warunków korzystania z usługi, które również muszą być spełnione.
Ta biblioteka nie jest Usługą podstawową Google Maps Platform. Dlatego Warunki korzystania z usług Google Maps Platform (np. usługi wsparcia technicznego, gwarancje jakości usług i zasady wycofywania usług) nie mają zastosowania do kodu w tej bibliotece.
Pomoc
Ta biblioteka jest oferowana na licencji open source. Nie podlegają one Wskazówkom dotyczącym usług wsparcia technicznego Google Maps Platform, gwarancji jakości usług ani zasadom wycofywania (funkcji lub usług). Jednak wszelkie usługi Google Maps Platform używane przez bibliotekę nadal podlegają Warunkom korzystania z usługi Google Maps Platform.
Wymagania dotyczące atrybucji w przypadku źródeł Map Google
Każda odpowiedź narzędzia z zestawu narzędzi interfejsu agenta zawiera źródła. Podczas prezentowania wyników uzyskanych za pomocą narzędzi udostępnianych przez zestaw narzędzi musisz podać powiązane źródła Map Google w sposób spełniający te wymagania:
- Źródła Map Google muszą znajdować się bezpośrednio po wygenerowanych treściach, które obsługują.
- Źródła w Mapach Google muszą być widoczne w ramach jednej interakcji użytkownika.
Przesyłanie opinii
Aby przesłać opinię o zestawie agentowych narzędzi interfejsu Map, użyj tych formularzy: