OpenWeather

OpenWeather aracı, temsilcilerin OpenWeather'ın One Call API 3.0'ını kullanarak mevcut koşullar, tahminler, geçmiş veriler ve günlük özetler dahil olmak üzere hava durumu verilerini almasını sağlar.

Ön Koşullar

• Bir OpenWeather hesabı
• Bir OpenWeather API anahtarı (özellikle One Call API 3.0 için)

API Anahtarı Alma

1. OpenWeather adresinden bir OpenWeather hesabı için kaydolun.
2. Oturum açtıktan sonra API keys sayfanıza gidin
3. Henüz bir API anahtarınız yoksa yeni bir tane oluşturun
4. One Call API 3.0 planına abone olun
5. API anahtarınızın etkinleştirilmesini bekleyin (2 saate kadar sürebilir)

Yapılandırma

Ortam Değişkenleri

.env dosyanıza aşağıdakileri ekleyin:

OPENWEATHER_API_KEY=your_api_key_here

Bir Araca Ajan Ekleme

.env dosyasını değiştirdikten sonra LibreChat'i yeniden başlatın, ardından herhangi bir agent kısmına OpenWeather ekleyin.

LibreChat içinde Agents kısmını seçin, bir agent oluşturun veya düzenleyin, agent'ın Tools listesini açın, OpenWeather öğesini seçin ve agent'ı kaydedin.

Kullanım

OpenWeather aracı aşağıdaki eylemleri destekler:

• current_forecast: Mevcut hava durumu ve tahmin verilerini alın
• timestamp: Belirli bir tarih için geçmiş hava durumu verilerini alın
• daily_aggregation: Belirli bir tarih için toplanmış hava durumu verilerini alın
• overview: İnsan tarafından okunabilir bir hava durumu özeti alın

Örnek İstemi

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?

Parametreler

• city: Şehrin adı (eğer enlem/boylam sağlanmadıysa)
• lat: Enlem koordinatı (şehir belirtilmişse isteğe bağlıdır)
• lon: Boylam koordinatı (şehir belirtilmişse isteğe bağlıdır)
• units: Sıcaklık birimleri ("Celsius", "Kelvin" veya "Fahrenheit")
• lang: Hava durumu açıklamaları için dil kodu (örneğin, "en", "fr", "es")
• date: YYYY-MM-DD formatında tarih (timestamp ve daily_aggregation eylemleri için gereklidir)
• tz: Saat dilimi (isteğe bağlı, daily_aggregation eylemi için)

Sorun Giderme

Yaygın sorunlar ve çözümler:

1. 403 Yetkisiz Erişim Hatası

   • API anahtarınızın doğru olduğunu doğrulayın
   • API anahtarınızın etkinleştirilip etkinleştirilmediğini kontrol edin (oluşturulduktan sonra 2 saat bekleyin)
   • One Call API 3.0'a abone olduğunuzdan emin olun

2. Şehir Bulunamadı

   • Şehir isminin yazımını kontrol edin
   • Ülke kodunu eklemeyi deneyin (örneğin, "London,UK")
   • Bunun yerine enlem ve boylam koordinatlarını kullanın

3. Geçersiz Tarih Formatı

   • Tarihlerin YYYY-MM-DD formatında olduğundan emin olun
   • Geçmiş veriler yalnızca 1979-01-01 tarihinden itibaren mevcuttur
   • Gelecek verileri 1,5 yıl ile sınırlıdır

API Limitleri

• Belirli limitleriniz için OpenWeather aboneliğinizi kontrol edin
• Yüksek trafikli ortamlarda hız sınırlaması (rate limiting) uygulamayı düşünün

Destek

Araç ile ilgili sorunlar için:

• You may open an issue at https://github.com/jmaddington/LibreChat/issues or
• LibreChat Issues sayfasını kontrol edin
• OpenWeather'ın API dokümantasyonunu inceleyin
• API ile ilgili sorunlar için OpenWeather destek ekibiyle iletişime geçin

Notlar

• Temperature değerleri otomatik olarak en yakın dereceye yuvarlanır
• Belirtilmediği takdirde varsayılan sıcaklık birimi Celsius'tur