OpenWeather

Alat OpenWeather memungkinkan agen untuk mendapatkan data cuaca termasuk kondisi saat ini, prakiraan cuaca, data historis, dan ringkasan harian menggunakan One Call API 3.0 dari OpenWeather.

Prasyarat

• Akun OpenWeather
• Kunci API OpenWeather (khususnya untuk One Call API 3.0)

Mendapatkan API Key

1. Daftarkan akun OpenWeather di OpenWeather
2. Setelah masuk, buka halaman API keys Anda
3. Buat kunci API baru jika Anda belum memilikinya
4. Berlangganan paket One Call API 3.0
5. Tunggu hingga kunci API Anda diaktifkan (bisa memakan waktu hingga 2 jam)

Konfigurasi

Variabel Lingkungan

Tambahkan berikut ini ke file .env Anda:

OPENWEATHER_API_KEY=your_api_key_here

Menambahkan Tool ke Agent

Mulai ulang LibreChat setelah mengubah .env, lalu tambahkan OpenWeather ke agent mana pun.

Di LibreChat, pilih Agents, buat atau edit agen, buka daftar Tools agen tersebut, pilih OpenWeather, lalu simpan agennya.

Penggunaan

Alat OpenWeather mendukung tindakan berikut:

• current_forecast: Mendapatkan data cuaca terkini dan prakiraan cuaca
• timestamp: Dapatkan data cuaca historis untuk tanggal tertentu
• daily_aggregation: Dapatkan data cuaca teragregasi untuk tanggal tertentu
• overview: Dapatkan ringkasan cuaca yang mudah dibaca manusia

Contoh 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?

Parameter

• city: Nama kota (jika lat/lon tidak disediakan)
• lat: Koordinat lintang (opsional jika kota disediakan)
• lon: Koordinat bujur (opsional jika kota disediakan)
• units: Satuan suhu ("Celsius", "Kelvin", atau "Fahrenheit")
• lang: Kode bahasa untuk deskripsi cuaca (contoh: "en", "fr", "es")
• date: Tanggal dalam format YYYY-MM-DD (diperlukan untuk tindakan timestamp dan daily_aggregation)
• tz: Zona waktu (opsional, untuk tindakan daily_aggregation)

Pemecahan Masalah

Masalah umum dan solusinya:

1. 403 Unauthorized Error

   • Verifikasi bahwa API key Anda sudah benar
   • Periksa apakah kunci API Anda telah diaktifkan (tunggu 2 jam setelah pembuatan)
   • Pastikan Anda telah berlangganan One Call API 3.0

2. Kota Tidak Ditemukan

   • Periksa ejaan nama kota tersebut
   • Coba tambahkan kode negara (contoh: "London,UK")
   • Gunakan koordinat latitude dan longitude sebagai gantinya

3. Format Tanggal Tidak Valid

   • Pastikan tanggal dalam format YYYY-MM-DD
   • Data historis hanya tersedia mulai dari 1979-01-01
   • Data masa depan dibatasi hingga 1,5 tahun ke depan

Batas API

• Periksa OpenWeather subscription Anda untuk batas spesifik Anda
• Pertimbangkan untuk menerapkan pembatasan laju (rate limiting) di lingkungan dengan lalu lintas tinggi

Dukungan

Untuk masalah terkait alat tersebut:

• Anda dapat membuka issue di https://github.com/jmaddington/LibreChat/issues atau
• Periksa LibreChat Issues
• Tinjau dokumentasi API OpenWeather
• Hubungi dukungan OpenWeather untuk masalah spesifik API

Catatan

• Nilai temperature dibulatkan secara otomatis ke derajat terdekat
• Satuan suhu default adalah Celsius jika tidak ditentukan