OpenWeather

L'outil OpenWeather permet aux agents d'obtenir des données météorologiques, notamment les conditions actuelles, les prévisions, les données historiques et les résumés quotidiens, en utilisant l'API One Call 3.0 d'OpenWeather.

Prérequis

• Un compte OpenWeather
• Une clé API OpenWeather (spécifiquement pour l'API One Call 3.0)

Obtenir une clé API

1. Inscrivez-vous à un compte OpenWeather sur OpenWeather
2. Après vous être connecté, accédez à votre page API keys
3. Générez une nouvelle clé API si vous n'en avez pas
4. Abonnez-vous au plan One Call API 3.0
5. Attendez que votre clé API soit activée (cela peut prendre jusqu'à 2 heures)

Configuration

Variables d'environnement

Ajoutez ce qui suit à votre fichier .env :

OPENWEATHER_API_KEY=your_api_key_here

Ajouter l'outil à un Agent

Redémarrez LibreChat après avoir modifié .env, puis ajoutez OpenWeather à n'importe quel agent.

Dans LibreChat, sélectionnez Agents, créez ou modifiez un agent, ouvrez la liste Tools de l'agent, sélectionnez OpenWeather, puis enregistrez l'agent.

Utilisation

L'outil OpenWeather prend en charge les actions suivantes :

• current_forecast: Obtenir les données météorologiques actuelles et les prévisions
• timestamp : Obtenir des données météorologiques historiques pour une date spécifique
• daily_aggregation : Obtenir des données météorologiques agrégées pour une date spécifique
• overview: Obtenir un résumé météo lisible par un humain

Exemples de prompts

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?

Paramètres

• city : Nom de la ville (si lat/lon n'est pas fourni)
• lat : Coordonnée de latitude (optionnel si la ville est fournie)
• lon : Coordonnée de longitude (optionnelle si la ville est fournie)
• units : Unités de température (« Celsius », « Kelvin » ou « Fahrenheit »)
• lang : Code de langue pour les descriptions météorologiques (par ex. "en", "fr", "es")
• date: Date au format AAAA-MM-JJ (requis pour les actions timestamp et daily_aggregation)
• tz: Fuseau horaire (optionnel, pour l'action daily_aggregation)

Dépannage

Problèmes courants et solutions :

1. Erreur 403 non autorisée

   • Vérifiez que votre clé API est correcte
   • Vérifiez si votre clé API a été activée (attendez 2 heures après sa création)
   • Assurez-vous d'avoir souscrit à l'API One Call 3.0

2. Ville introuvable

   • Vérifiez l'orthographe du nom de la ville
   • Essayez d'ajouter le code pays (par exemple, "London,UK")
   • Utilisez plutôt les coordonnées de latitude et de longitude

3. Format de date invalide

   • Assurez-vous que les dates sont au format AAAA-MM-JJ
   • Les données historiques ne sont disponibles qu'à partir du 1979-01-01
   • Les données futures sont limitées à 1,5 an à l'avance

Limites de l'API

• Vérifiez votre OpenWeather subscription pour connaître vos limites spécifiques
• Envisagez de mettre en œuvre une limitation de débit (rate limiting) dans les environnements à fort trafic.

Support

Pour les problèmes liés à l'outil :

• Vous pouvez ouvrir une issue sur https://github.com/jmaddington/LibreChat/issues ou
• Consultez les LibreChat Issues
• Consultez la documentation de l'API d'OpenWeather
• Contactez le support d'OpenWeather pour les problèmes spécifiques à l'API

Notes

• Les valeurs de température sont automatiquement arrondies au degré le plus proche.
• L'unité de température par défaut est Celsius si elle n'est pas spécifiée