OpenWeather

Công cụ OpenWeather cho phép các tác nhân (agents) lấy dữ liệu thời tiết bao gồm điều kiện hiện tại, dự báo, dữ liệu lịch sử và tóm tắt hàng ngày bằng cách sử dụng One Call API 3.0 của OpenWeather.

Điều kiện tiên quyết

Một tài khoản OpenWeather
Một khóa API OpenWeather (cụ thể là cho One Call API 3.0)

Nhận API Key

Đăng ký tài khoản OpenWeather tại OpenWeather
Sau khi đăng nhập, hãy truy cập trang API keys của bạn
Tạo một API key mới nếu bạn chưa có.
Đăng ký gói One Call API 3.0
Đợi cho đến khi API key của bạn được kích hoạt (có thể mất tới 2 giờ)

Cấu hình

Các biến môi trường

Thêm nội dung sau vào tệp .env của bạn:

OPENWEATHER_API_KEY=your_api_key_here

Thêm Công cụ vào một Agent

Khởi động lại LibreChat sau khi thay đổi .env, sau đó thêm OpenWeather vào bất kỳ agent nào.

Triển khai	Lệnh
Docker	`docker compose down && docker compose up -d`
Local	Dừng máy chủ, sau đó chạy lại `npm run backend`

Trong LibreChat, hãy chọn Agents, tạo hoặc chỉnh sửa một agent, mở danh sách Tools của agent đó, chọn OpenWeather, và lưu agent lại.

Cách sử dụng

Công cụ OpenWeather hỗ trợ các hành động sau:

current_forecast: Lấy dữ liệu thời tiết hiện tại và dự báo
timestamp: Lấy dữ liệu thời tiết lịch sử cho một ngày cụ thể
daily_aggregation: Lấy dữ liệu thời tiết đã tổng hợp cho một ngày cụ thể
overview: Nhận bản tóm tắt thời tiết ở định dạng con người có thể đọc được

Các câu lệnh mẫu

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?

Các tham số

city: Tên của thành phố (nếu không cung cấp lat/lon)
lat: Tọa độ vĩ độ (tùy chọn nếu đã cung cấp thành phố)
lon: Tọa độ kinh độ (tùy chọn nếu đã cung cấp thành phố)
units: Các đơn vị nhiệt độ ("Celsius", "Kelvin", hoặc "Fahrenheit")
lang: Mã ngôn ngữ cho mô tả thời tiết (ví dụ: "en", "fr", "es")
date: Ngày ở định dạng YYYY-MM-DD (bắt buộc cho các hành động timestamp và daily_aggregation)
tz: Múi giờ (tùy chọn, cho hành động daily_aggregation)

Khắc phục sự cố

Các vấn đề thường gặp và giải pháp:

Lỗi 403 Unauthorized
- Xác minh rằng API key của bạn là chính xác
- Kiểm tra xem API key của bạn đã được kích hoạt chưa (đợi 2 giờ sau khi tạo)
- Đảm bảo rằng bạn đã đăng ký One Call API 3.0
Không tìm thấy thành phố
- Kiểm tra chính tả của tên thành phố
- Hãy thử thêm mã quốc gia (ví dụ: "London,UK")
- Thay vào đó, hãy sử dụng tọa độ vĩ độ và kinh độ
Định dạng ngày không hợp lệ
- Đảm bảo ngày tháng ở định dạng YYYY-MM-DD
- Dữ liệu lịch sử chỉ khả dụng từ 1979-01-01
- Dữ liệu tương lai bị giới hạn trong vòng 1,5 năm tới

Giới hạn API

Kiểm tra OpenWeather subscription của bạn để biết các giới hạn cụ thể.
Hãy cân nhắc việc triển khai giới hạn tốc độ (rate limiting) trong các môi trường có lưu lượng truy cập cao.

Hỗ trợ

Đối với các vấn đề liên quan đến công cụ:

Bạn có thể mở một issue tại https://github.com/jmaddington/LibreChat/issues hoặc
Kiểm tra LibreChat Issues
Xem tài liệu API của OpenWeather
Liên hệ bộ phận support của OpenWeather để giải quyết các vấn đề cụ thể về API

Ghi chú

Các giá trị Temperature được tự động làm tròn đến độ gần nhất
Đơn vị nhiệt độ mặc định là Celsius nếu không được chỉ định

OpenWeather

Trên trang này