OpenWeather

Lo strumento OpenWeather consente agli agenti di ottenere dati meteorologici, incluse le condizioni attuali, le previsioni, i dati storici e i riepiloghi giornalieri, utilizzando la One Call API 3.0 di OpenWeather.

Prerequisiti

• Un account OpenWeather
• Una chiave API di OpenWeather (nello specifico per la One Call API 3.0)

Ottenere una API Key

1. Registrati per un account OpenWeather su OpenWeather
2. Dopo aver effettuato l'accesso, vai alla tua pagina API keys
3. Genera una nuova chiave API se non ne hai una
4. Iscriviti al piano One Call API 3.0
5. Attendi che la tua API key venga attivata (può richiedere fino a 2 ore)

Configurazione

Variabili d'ambiente

Aggiungi quanto segue al tuo file .env:

OPENWEATHER_API_KEY=your_api_key_here

Aggiungi lo strumento a un Agent

Riavvia LibreChat dopo aver modificato .env, quindi aggiungi OpenWeather a qualsiasi agent.

In LibreChat, seleziona Agents, crea o modifica un agente, apri l'elenco Tools dell'agente, seleziona OpenWeather e salva l'agente.

Utilizzo

Lo strumento OpenWeather supporta le seguenti azioni:

• current_forecast: Ottieni i dati meteo attuali e le previsioni
• timestamp: Ottieni dati meteorologici storici per una data specifica
• daily_aggregation: Ottieni dati meteorologici aggregati per una data specifica
• overview: Ottieni un riepilogo meteorologico leggibile dall'uomo

Esempi di prompt

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?

Parametri

• city: Nome della città (se lat/lon non forniti)
• lat: Coordinata di latitudine (opzionale se viene fornita la città)
• lon: Coordinata di longitudine (opzionale se viene fornita la città)
• units: Unità di temperatura ("Celsius", "Kelvin" o "Fahrenheit")
• lang: Codice lingua per le descrizioni meteo (es. "en", "fr", "es")
• date: Data nel formato AAAA-MM-GG (richiesto per le azioni timestamp e daily_aggregation)
• tz: Fuso orario (opzionale, per l'azione daily_aggregation)

Risoluzione dei problemi

Problemi comuni e soluzioni:

1. Errore 403 Non autorizzato

   • Verifica che la tua API key sia corretta
   • Controlla se la tua chiave API è stata attivata (attendi 2 ore dopo la creazione)
   • Assicurati di aver sottoscritto la One Call API 3.0

2. Città non trovata

   • Controlla l'ortografia del nome della città
   • Prova ad aggiungere il prefisso del paese (ad esempio, "London,UK")
   • Usa invece le coordinate di latitudine e longitudine

3. Formato data non valido

   • Assicurati che le date siano nel formato YYYY-MM-DD
   • I dati storici sono disponibili solo a partire dal 1979-01-01
   • I dati futuri sono limitati a 1,5 anni in avanti

Limiti API

• Controlla il tuo OpenWeather subscription per i tuoi limiti specifici
• Valuta l'implementazione del rate limiting in ambienti ad alto traffico

Supporto

Per problemi con lo strumento:

• You may open an issue at https://github.com/jmaddington/LibreChat/issues or
• Controlla le LibreChat Issues
• Consulta la documentazione API di OpenWeather
• Contatta il supporto di OpenWeather per problemi specifici dell'API

Note

• I valori della temperatura vengono arrotondati automaticamente al grado più vicino
• L'unità di temperatura predefinita è Celsius se non specificato