Przegląd
Zestaw agentowych narzędzi interfejsu Google Maps Platform to zestaw narzędzi dla deweloperów zaprojektowany specjalnie na potrzeby ery konwersacyjnej AI. Zawiera on zestaw instrukcji systemowych dla LLM oraz 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, co pozwala utrzymać zaangażowanie użytkowników w czacie.
Typowe przypadki użycia:
- Asystenci AI: wzbogacanie odpowiedzi tekstowych o kontekst wizualny w przypadku zapytań lokalnych (np. o hotele, restauracje).
- Planiści podróży: wyświetlanie map, tras i szczegółów miejsc w tekście.
- Tworzenie aplikacji bez kodu: zmniejszenie trudności związanych z ręcznym zarządzaniem wieloma interfejsami API Map.
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 perspektywy użytkownika i podglądy tras, które zostały zaprojektowane specjalnie pod kątem interakcji w czasie rzeczywistym z wykorzystaniem LLM.
2. Interakcje z bogatym kontekstem
Umożliwia użytkownikom odkrywanie i podejmowanie decyzji bez opuszczania czatu. Dzięki bogatemu kontekstowi mapy w tekście, np. galeriom zdjęć, ocenom czy opcjom tras, użytkownicy są zaangażowani i mają pewność, że mogą podjąć działanie.
3. Inteligentne komponenty
Zestaw agentowych narzędzi interfejsu automatycznie obsługuje złożoną logikę geoprzestrzenną, natychmiast dostosowując kontekst i układ do intencji użytkownika, a jednocześnie stylizując elementy, aby każda interakcja była zgodna z Twoją marką.
4. Niezależność od LLM
Zestaw agentowych narzędzi interfejsu jest niezależny od modelu w Twoim stosie AI. Niezależnie od tego, czy używasz Gemini, modeli OpenAI czy Anthropic oraz niezależnie od źródła danych, zestaw agentowych narzędzi interfejsu zapewnia dedykowaną warstwę prezentacji do wizualizacji danych o lokalizacji.
Pierwsze kroki
Aby zacząć korzystać z zestawu agentowych narzędzi interfejsu, musisz go zainicjować za pomocą jednego klucza API. Dzięki temu możesz korzystać z usług Map bez konieczności zarządzania oddzielnymi interfejsami API.
Szczegółowe instrukcje znajdziesz w przewodniku dla początkujących .
Wyniki interfejsu
Zestaw agentowych narzędzi interfejsu zapewnia kompleksowy zestaw specjalistycznych funkcji interfejsu.
- Szczegóły miejsca (kompaktowe): szczegółowe informacje o punkcie zainteresowania 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: atmosfera lub kontekst lokalizacji dzięki bogatym obrazom.
Instrukcje systemowe
Zestaw agentowych narzędzi interfejsu zawiera „instrukcje systemowe”, które informują LLM hosta, kiedy i jak tworzyć interfejs.
Wytyczne
Model hosta musi rozumieć:
który komponent odpowiada której intencji użytkownika (np. użyj mapy w tekście w przypadku zapytań o orientację);
mapowanie parametrów z języka naturalnego na schemat (np. jeśli użytkownik zapyta o „malownicze”, ustaw tryb mapy na satelitarny).
Schemat użycia narzędzia
Zestaw agentowych narzędzi interfejsu udostępnia katalog definicji zgodnych ze standardowym schematem użycia narzędzia LLM (np. wywoływanie 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 powiązanie ze źródłami informacji przy użyciu Map Google, mają dodatkowe wymagania dotyczące 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ługi Google Maps Platform (np. usługi pomocy technicznej, umowy SLA i zasady wycofywania usług) nie mają zastosowania do kodu w tej bibliotece.
Pomoc
Ta biblioteka jest udostępniana na licencji open source. Nie podlegają jej Wskazówki dotyczące usług pomocy technicznej Google Maps Platform, umowa SLA ani zasady wycofywania usług. Jednak wszystkie usługi Google Maps Platform używane przez bibliotekę nadal podlegają Warunkom korzystania z usługi Google Maps Platform.
Wymagania dotyczące atrybucji źródeł Map Google
Każda odpowiedź narzędzia z zestawu agentowych narzędzi interfejsu zawiera źródła. Podczas prezentowania wyników, które korzystają z 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 wygenerowanej treści, którą obsługują.
- Źródła Map Google muszą być widoczne w ramach jednej interakcji użytkownika.