search_places |
Wywołaj to narzędzie, gdy użytkownik prosi o znalezienie miejsc, firm, adresów, lokalizacji, ciekawych miejsc lub o inne wyszukiwanie związane z Mapami Google. Wymagania dotyczące danych wejściowych (KRYTYCZNE):
text_query (ciąg znaków – WYMAGANY): podstawowe zapytanie. Musi on jasno określać, czego szuka użytkownik.
- Przykłady:
'restaurants in New York', 'coffee shops near Golden Gate Park', 'SF MoMA', '1600 Amphitheatre Pkwy, Mountain View, CA, USA', 'pets friendly parks in Manhattan, New York', 'date night restaurants in Chicago', 'accessible public libraries in Los Angeles'.
- Aby uzyskać szczegółowe informacje o miejscu: dodaj żądany atrybut (np.
'Google Store Mountain View opening hours', 'SF MoMa phone number', 'Shoreline Park Mountain View address').
location_bias (obiekt – OPCJONALNY): użyj tego parametru, aby nadać priorytet wynikom w pobliżu określonego obszaru geograficznego.
- Format:
{"location_bias": {"circle": {"center": {"latitude": [value], "longitude": [value]}, "radius_meters": [value (optional)]}}}
- Wykorzystanie:
- Aby ustawić promień 5 km:
{"location_bias": {"circle": {"center": {"latitude": 34.052235, "longitude": -118.243683}, "radius_meters": 5000}}}
- Aby silnie przesunąć środek:
{"location_bias": {"circle": {"center": {"latitude": 34.052235, "longitude": -118.243683}}}} (pomijając radius_meters).
language_code (ciąg znaków – OPCJONALNY): język, w którym ma być wyświetlane podsumowanie wyników wyszukiwania.
- Format: dwuliterowy kod języka (ISO 639-1), po którym opcjonalnie następuje podkreślenie i dwuliterowy kod kraju (ISO 3166-1 alfa-2), np.
en, ja, en_US, zh_CN, es_MX. Jeśli nie podasz kodu języka, wyniki będą w języku angielskim.
region_code (ciąg znaków – OPCJONALNY): kod regionu CLDR Unicode użytkownika. Ten parametr służy do wyświetlania informacji o miejscu, takich jak nazwa miejsca w danym regionie, jeśli jest dostępna. Parametr może wpływać na wyniki na podstawie obowiązujących przepisów.
- Format: 2-literowy kod kraju (ISO 3166-1 alfa-2), np.
US, CA.
Instrukcje dotyczące wywołania narzędzia:
Informacje o lokalizacji (KRYTYCZNE): wyszukiwanie musi zawierać wystarczające informacje o lokalizacji. Jeśli lokalizacja jest niejednoznaczna (np. „pizzerie”), musisz określić ją w parametrze text_query (np. „pizzerie w Nowym Jorku”) lub użyć parametru location_bias. Jeśli jest to konieczne, podaj nazwę miasta, stanu/prowincji i regionu/kraju w celu uściślenia. Zawsze podawaj jak najbardziej szczegółowe i bogate w kontekst text_query. Używaj location_bias tylko wtedy, gdy współrzędne są wyraźnie podane lub gdy określenie lokalizacji na podstawie znanego kontekstu użytkownika jest odpowiednie i konieczne do uzyskania lepszych wyników. Wygenerowane odpowiedzi muszą być przypisane do źródła za pomocą informacji z pola attribution, jeśli są dostępne.
|
lookup_weather |
Pobiera kompleksowe dane pogodowe, w tym aktualne warunki oraz prognozy godzinowe i dzienne. Dostępne dane: temperatura (bieżąca, odczuwalna, maksymalna/minimalna, indeks ciepła), wiatr (prędkość, porywy, kierunek), zdarzenia astronomiczne (wschód/zachód słońca, faza księżyca), opady (rodzaj, prawdopodobieństwo, ilość/QPF), warunki atmosferyczne (indeks UV, wilgotność, zachmurzenie, prawdopodobieństwo burzy) i adres lokalizacji z kodem geograficznym. Lokalizacja i reguły dotyczące lokalizacji (KRYTYCZNE): Lokalizacja, dla której są wymagane dane pogodowe, jest określana za pomocą pola location. To pole ma strukturę „oneof”, co oznacza, że aby zapewnić dokładne wyszukiwanie danych o pogodzie, MUSISZ podać wartość TYLKO JEDNEGO z 3 poniższych pól podrzędnych lokalizacji.
Współrzędne geograficzne (lat_lng)
- Używaj go, gdy masz dokładne współrzędne szerokości i długości geograficznej.
- Przykład: {"location": {"lat_lng": {"latitude": 34.0522, "longitude": -118.2437}}} // Los Angeles
Identyfikator miejsca (place_id)
- Jednoznaczny identyfikator w postaci ciągu znaków (identyfikator miejsca w Mapach Google).
- Identyfikator place_id można pobrać z narzędzia search_places.
- Przykład: {"location": {"place_id": "ChIJLU7jZClu5kcR4PcOOO6p3I0"}} // Wieża Eiffla
Ciąg znaków adresu (address)
- Ciąg znaków w formacie swobodnym, który wymaga podania szczegółowych informacji na potrzeby geokodowania.
- Miasto i region: zawsze podawaj region lub kraj (np. „Londyn, Wielka Brytania”, a nie „Londyn”).
- Adres: podaj pełny adres (np. „1600 Pennsylvania Ave NW, Washington, DC”).
- Kody pocztowe: MUSZĄ zawierać nazwę kraju (np. „90210, USA”, a nie „90210”).
- Przykład: {"location": {"address": "1600 Pennsylvania Ave NW, Washington, DC"}}
Tryby użytkowania:
Aktualna pogoda: podaj tylko location. Nie podawaj parametrów date i hour. Prognoza godzinowa: podaj location, date i hour (0–23). Używaj konkretnych godzin (np. „o 17:00”) lub określeń takich jak „w ciągu najbliższych kilku godzin” lub „później dzisiaj”. Jeśli użytkownik określi minuty, zaokrąglij w dół do najbliższej godziny. Prognoza godzinowa na okres dłuższy niż 120 godzin nie jest obsługiwana. Historyczne dane o pogodzie są dostępne do 24 godzin wstecz. Prognoza dzienna: podaj location i date. Nie podawaj parametru hour. Używaj w przypadku ogólnych zapytań o dzień (np. „pogoda na jutro”, „pogoda w piątek”, „pogoda 25 grudnia”). Jeśli w kontekście nie ma dzisiejszej daty, poproś użytkownika o jej podanie. Prognoza dzienna obejmująca więcej niż 10 dni (wliczając dzisiejszy) nie jest obsługiwana. Dane historyczne dotyczące pogody nie są obsługiwane. Ograniczenia parametrów:
|
compute_routes |
Oblicza trasy podróży między miejscem początkowym a docelowym, opcjonalnie z przystankami pośrednimi. Zwraca odległość i czas trwania każdej trasy. Wymagania dotyczące danych wejściowych (KRYTYCZNE):
origin i destination (obiekty – WYMAGANE): każdy z nich musi być podany za pomocą dokładnie jednej z tych opcji:
address (ciąg znaków, np. 'Eiffel Tower, Paris'). Nazwane miejsca, punkty orientacyjne i firmy są rozpoznawane bezpośrednio, więc NIE wywołuj najpierw search_places tylko po to, aby uzyskać kod geograficzny punktu na trasie. Uwzględnij miasto, region lub kraj, o którym wspomniał użytkownik.lat_lng (obiekt, {"latitude": number, "longitude": number}).place_id (ciąg znaków, np. 'ChIJOwE_Id1w5EAR4Q27FkL6T_0'), na przykład z search_places. intermediate_waypoints (tablica obiektów – OPCJONALNIE): maksymalnie 10 przystanków, przez które należy przejechać, w kolejności między miejscem początkowym a docelowym. Taki sam format jak w polu origin. Nieobsługiwane w przypadku TRANSIT. Uwzględniaj tylko przystanki, o które prosi użytkownik.
travel_mode (typ wyliczeniowy – OPCJONALNY): DRIVE (domyślny), WALK, BICYCLE lub TRANSIT.
Czas (OPCJONALNIE – ustaw maksymalnie JEDNĄ wartość): sygnatury czasowe RFC 3339 z przesunięciem UTC, np. '2026-09-19T08:00:00-07:00'. Domyślnie jest to odjazd teraz. W przypadku TRANSIT czas może wynosić do 7 dni w przeszłości lub do 100 dni w przyszłości. W przypadku innych trybów czas może wynosić do 365 dni w przyszłości i nie może być w przeszłości.
departure_time: użyj, gdy użytkownik podaje, kiedy wyjeżdża (np. „jutro o 8:00”).arrival_time: używaj, gdy użytkownik określa, kiedy musi dotrzeć na miejsce (np. „bądź tam o 9:00”). routing_preference (typ wyliczeniowy – OPCJONALNY):
ROUTING_PREFERENCE_TRAFFIC_UNAWARE (domyślna): ignoruje aktualne informacje o natężeniu ruchu, zdarzeniach drogowych i zamkniętych drogach. Najkrótszy czas oczekiwania.ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL: korzysta z informacji o warunkach na drodze w czasie rzeczywistym, jeśli są dostępne. Nieobsługiwane w przypadku WALK i BICYCLE. Ustaw tę opcję TYLKO wtedy, gdy użytkownik pyta o ruch, korki lub szacowany czas dotarcia na miejsce dostosowany do natężenia ruchu. Powoduje to wyższe koszty i dłuższy czas oczekiwania. location_bias (obiekt – OPCJONALNY): {"latitude": number, "longitude": number} używany do uściślania nazw miejsc w adresach punktów orientacyjnych. Jeśli nazwa jest niejednoznaczna (np. „Springfield”), a użytkownik nie podał regionu, zachowaj nazwę podaną w polu address i ustaw pole location_bias na obszar docelowy, zamiast zgadywać region.
compute_alternative_routes (wartość logiczna – OPCJONALNA): ustaw na true tylko wtedy, gdy użytkownik prosi o opcje lub alternatywne trasy. Domyślna wartość to false, co powoduje zwrócenie tylko zalecanej trasy.
include_polyline (wartość logiczna – OPCJONALNA): ustaw wartość true tylko wtedy, gdy potrzebna jest geometria trasy (encoded_polyline). Domyślna wartość to false.
Instrukcje dotyczące wywołania narzędzia:
- Jeśli brakuje miejsca wylotu lub przylotu, przed wywołaniem narzędzia MUSISZ poprosić użytkownika o wyjaśnienie.
- W przypadku pytań typu „Jak daleko jest z A do B?” użyj B jako
origin i A jako destination.
Przykładowe wywołanie narzędzia: {"origin":{"address":"Eiffel Tower"},"destination":{"place_id":"ChIJt_5xIthw5EARoJ71mGq7t74"},"intermediate_waypoints":[{"address":"Louvre Museum"}],"travel_mode":"DRIVE","departure_time":"2026-09-19T08:00:00+02:00"} Instrukcje dotyczące odpowiedzi:
- Gdy wysyłane jest żądanie tras alternatywnych, trasy są uporządkowane od najbardziej do najmniej zalecanych.
- Jeśli
routes jest puste, poinformuj użytkownika, że nie znaleziono trasy. Nie zgaduj trasy.
- Podawaj tylko fakty zwrócone przez narzędzie. NIE wymyślaj szczegółowych wskazówek dojazdu, linii transportu publicznego, stacji, peronów ani przesiadek.
- Uziemione dane wyjściowe muszą być przypisane do źródła za pomocą pola
attribution każdej trasy, jeśli jest dostępne.
|
resolve_names |
Rozpoznaje listę zbiorczą konkretnych zapytań o lokalizację (nazwy punktów orientacyjnych lub dokładne adresy) i przekształca je w kanoniczne identyfikatory miejsc w Mapach Google. Wymagania dotyczące danych wejściowych (KRYTYCZNE):
queries (tablica obiektów – WYMAGANA): lista zapytań o lokalizację do rozwiązania. Możesz podać maksymalnie 20 zapytań.
- Każdy obiekt zapytania musi zawierać:
text (ciąg tekstowy – WYMAGANY): zapytanie tekstowe reprezentujące konkretną nazwę miejsca lub adres do rozpoznania.
- Przykłady:
'Googleplex, Mountain View, CA', '1600 Amphitheatre Pkwy, Mountain View, CA', 'Eiffel Tower, Paris'.
location_bias (obiekt – OPCJONALNY): użyj tego parametru, aby nadać priorytet wynikom w pobliżu określonego obszaru geograficznego.
- Format:
{"viewport": {"low": {"latitude": [value], "longitude": [value]}, "high": {"latitude": [value], "longitude": [value]}}}
region_code (ciąg znaków – OPCJONALNY): kod regionu Unicode CLDR (dwuliterowy kod kraju, np. US, CA) użytkownika, który ma być używany do filtrowania wyników.
Instrukcje dotyczące wywołania narzędzia:
- Konkretność (KRYTYCZNA): zapytania muszą zawierać konkretną nazwę miejsca lub adres. Ogólne wyszukiwania, takie jak
'restaurants', lub nazwy sieci, takie jak 'Starbucks', nie są obsługiwane.
- NIE wywołuj tego narzędzia, jeśli narzędzia, które planujesz wywołać, akceptują już bezpośrednio nieprzetworzone ciągi znaków adresu lub nazwy miejsca.
Zapisywanie w Mapach Google:
- Odpowiedź zawiera pole
save_to_maps_url: pojedynczy link do Map Google zawierający wszystkie miejsca, które udało się znaleźć.
- Gdy użytkownik chce zapisać, udostępnić lub otworzyć znalezione miejsca jako listę w Mapach Google, wyświetl mu ten link. NIE twórz tego linku samodzielnie.
Obsługa błędów (KRYTYCZNE):
- To narzędzie do przetwarzania wsadowego. Żądanie może zwrócić „mieszane wyniki” (np. niektóre zapytania zostaną rozwiązane, a inne nie).
- Lista wyjściowa
results jest gwarantowana do mapowania 1:1 z indeksami wejściowymi queries. Nieudane zapytanie spowoduje wyświetlenie pustego komunikatu Result (nie ustawiono entity) w odpowiednim indeksie na liście results.
- MUSISZ sprawdzić pole mapy
failed_requests w odpowiedzi, aby określić, który indeks zapytania nie został utworzony. Klucz failed_requests reprezentuje indeks nieudanego zapytania w żądaniu (liczony od 0). Nie zakładaj, że całe wywołanie zbiorcze nie powiodło się z powodu częściowego błędu.
|
resolve_maps_urls |
Rozpoznaje listę adresów URL Map Google i przekształca je w kanoniczne identyfikatory miejsc w Mapach Google. Kiedy wywołać to narzędzie (KRYTYCZNE):
- Użyj tego narzędzia, gdy użytkownik poda co najmniej 1 link lub adres URL udostępniania w Mapach Google (np. „https://maps.app.goo.gl/...”, 'https://www.google.com/maps/place/...' lub 'https://maps.google.com/...') i musisz wyodrębnić podstawowe kanoniczne identyfikatory miejsc.
- W jednym żądaniu zbiorczym możesz określić maksymalnie 20 adresów URL do rozpoznania.
Wymagania dotyczące danych wejściowych (KRYTYCZNE):
urls (tablica ciągów znaków – WYMAGANE): lista adresów URL Map Google do rozpoznania. Każdy adres URL musi być prawidłowym adresem URL Map Google wskazującym jedno miejsce. Zapisywanie w Mapach Google:
- Odpowiedź zawiera pole
save_to_maps_url: pojedynczy link do Map Google zawierający wszystkie miejsca, które udało się znaleźć.
- Gdy użytkownik chce zapisać, udostępnić lub otworzyć znalezione miejsca jako listę w Mapach Google (np. zbierając miejsca udostępnione w rozmowie), wyświetl mu ten link. NIE twórz tego linku samodzielnie.
Obsługa błędów (KRYTYCZNE):
- To narzędzie do przetwarzania wsadowego. Żądanie może zwrócić „mieszane wyniki” (np. niektóre adresy URL zostaną rozwiązane, a inne nie).
- Lista wyjściowa
entities jest gwarantowana do mapowania 1:1 z indeksami wejściowymi urls. Niepowodzenie rozpoznania adresu URL spowoduje wyświetlenie pustego komunikatu Entity (nie ustawiono żadnych pól) w odpowiednim indeksie na liście entities.
- MUSISZ sprawdzić pole mapy
failed_requests w odpowiedzi, aby określić, który indeks adresu URL nie został utworzony. Klucz failed_requests reprezentuje indeks nieudanego adresu URL w żądaniu (liczony od 0). Nie zakładaj, że całe wywołanie zbiorcze nie powiodło się z powodu częściowego błędu.
|
