OpenWeather

Narzędzie OpenWeather pozwala agentom pobierać dane pogodowe, w tym aktualne warunki, prognozy, dane historyczne oraz podsumowania dzienne, przy użyciu interfejsu OpenWeather One Call API 3.0.

Wymagania wstępne

• Konto OpenWeather
• Klucz API OpenWeather (konkretnie dla One Call API 3.0)

Uzyskiwanie klucza API

1. Zarejestruj się w serwisie OpenWeather na stronie OpenWeather
2. Po zalogowaniu przejdź do strony API keys.
3. Wygeneruj nowy klucz API, jeśli jeszcze go nie masz
4. Zasubskrybuj plan One Call API 3.0
5. Poczekaj na aktywację swojego klucza API (może to potrwać do 2 godzin)

Konfiguracja

Zmienne środowiskowe

Dodaj poniższe do swojego pliku .env:

OPENWEATHER_API_KEY=your_api_key_here

Dodawanie narzędzia do Agenta

Zrestartuj LibreChat po zmianie .env, a następnie dodaj OpenWeather do dowolnego agenta.

W LibreChat wybierz Agents, utwórz lub edytuj agenta, otwórz listę Tools agenta, wybierz OpenWeather i zapisz agenta.

Użycie

Narzędzie OpenWeather obsługuje następujące akcje:

• current_forecast: Pobierz aktualną pogodę i dane prognozy
• timestamp: Pobierz historyczne dane pogodowe dla określonej daty
• daily_aggregation: Pobierz zagregowane dane pogodowe dla określonej daty
• overview: Uzyskaj czytelne dla człowieka podsumowanie pogody

Przykładowe prompty

What's the current weather in London?
What was the weather like in Paris on 2023-01-01?
Give me a weather summary for Tokyo.
What's the temperature in New York in Fahrenheit?

Parametry

• city: Nazwa miasta (jeśli nie podano szer./dł. geograficznej)
• lat: Współrzędna szerokości geograficznej (opcjonalna, jeśli podano miasto)
• lon: Współrzędna długości geograficznej (opcjonalna, jeśli podano miasto)
• units: Jednostki temperatury ("Celsius", "Kelvin" lub "Fahrenheit")
• lang: Kod języka dla opisów pogody (np. "en", "fr", "es")
• date: Data w formacie RRRR-MM-DD (wymagana dla akcji timestamp i daily_aggregation)
• tz: Strefa czasowa (opcjonalnie, dla akcji daily_aggregation)

Rozwiązywanie problemów

Typowe problemy i rozwiązania:

1. Błąd 403 Unauthorized

   • Sprawdź, czy Twój klucz API jest poprawny
   • Sprawdź, czy Twój klucz API został aktywowany (odczekaj 2 godziny od momentu utworzenia)
   • Upewnij się, że zasubskrybowałeś One Call API 3.0

2. Nie znaleziono miasta

   • Sprawdź pisownię nazwy miasta
   • Spróbuj dodać kod kraju (np. „London,UK”)
   • Użyj zamiast tego współrzędnych szerokości i długości geograficznej

3. Nieprawidłowy format daty

   • Upewnij się, że daty są w formacie YYYY-MM-DD
   • Dane historyczne są dostępne tylko od 1979-01-01
   • Przyszłe dane są ograniczone do 1,5 roku do przodu

Limity API

• Sprawdź swoją subskrypcję OpenWeather, aby poznać swoje limity
• Rozważ wdrożenie limitowania zapytań (rate limiting) w środowiskach o dużym natężeniu ruchu.

Wsparcie

W przypadku problemów z narzędziem:

• Możesz otworzyć zgłoszenie (issue) pod adresem https://github.com/jmaddington/LibreChat/issues lub
• Sprawdź LibreChat Issues
• Zapoznaj się z dokumentacją API OpenWeather
• Skontaktuj się z support OpenWeather w przypadku problemów związanych z API

Uwagi

• Wartości temperatury są automatycznie zaokrąglane do najbliższego stopnia
• Domyślną jednostką temperatury jest stopień Celsjusza, jeśli nie określono inaczej