OpenWeather

OpenWeather 도구는 에이전트가 OpenWeather의 One Call API 3.0을 사용하여 현재 상태, 예보, 과거 데이터 및 일일 요약을 포함한 날씨 데이터를 가져올 수 있도록 합니다.

필수 조건

• OpenWeather 계정
• OpenWeather API 키 (특히 One Call API 3.0용)

API 키 발급받기

1. OpenWeather에서 OpenWeather 계정을 등록하세요.
2. 로그인 후, API keys 페이지로 이동하세요.
3. API 키가 없다면 새로 생성하세요
4. One Call API 3.0 플랜을 구독하세요
5. API 키가 활성화될 때까지 기다려 주세요(최대 2시간 소요될 수 있음)

구성

환경 변수

.env 파일에 다음을 추가하세요:

OPENWEATHER_API_KEY=your_api_key_here

에이전트에 도구 추가하기

.env를 변경한 후 LibreChat을 재시작하고, agent에 OpenWeather를 추가하세요.

LibreChat에서 Agents를 선택하고, 에이전트를 생성하거나 편집한 다음, 에이전트의 Tools 목록을 열고 OpenWeather를 선택한 후 에이전트를 저장하세요.

사용법

OpenWeather 도구는 다음 작업을 지원합니다:

• current_forecast: 현재 날씨 및 예보 데이터 가져오기
• timestamp: 특정 날짜의 과거 날씨 데이터를 가져옵니다.
• daily_aggregation: 특정 날짜에 대한 집계된 날씨 데이터를 가져옵니다.
• overview: 사람이 읽을 수 있는 날씨 요약 정보 가져오기

예시 프롬프트

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?

매개변수

• city: 도시 이름 (lat/lon이 제공되지 않은 경우)
• lat: 위도 좌표 (도시가 제공된 경우 선택 사항)
• lon: 경도 좌표 (도시가 제공된 경우 선택 사항)
• units: 온도 단위 ("Celsius", "Kelvin" 또는 "Fahrenheit")
• lang: 날씨 설명에 대한 언어 코드 (예: "en", "fr", "es")
• date: YYYY-MM-DD 형식의 날짜 (timestamp 및 daily_aggregation 작업에 필수)
• tz: 시간대 (선택 사항, daily_aggregation 작업용)

문제 해결

일반적인 문제 및 해결 방법:

1. 403 Unauthorized 오류

   • API 키가 올바른지 확인하세요
   • API 키가 활성화되었는지 확인하세요(생성 후 2시간 대기).
   • One Call API 3.0을 구독했는지 확인하세요.

2. 도시를 찾을 수 없음

   • 도시 이름의 철자를 확인하세요
   • 국가 코드를 추가해 보세요 (예: "London,UK")
   • 대신 위도와 경도 좌표를 사용하세요

3. 잘못된 날짜 형식

   • 날짜가 YYYY-MM-DD 형식인지 확인하세요
   • 과거 데이터는 1979-01-01부터만 제공됩니다.
   • 미래 데이터는 1.5년 후까지로 제한됩니다

API 제한

• OpenWeather 구독에서 특정 제한 사항을 확인하세요.
• 트래픽이 많은 환경에서는 속도 제한(rate limiting) 구현을 고려하십시오.

지원

도구 관련 문제 발생 시:

• You may open an issue at https://github.com/jmaddington/LibreChat/issues or
• LibreChat Issues를 확인하세요.
• OpenWeather의 API 문서를 검토하세요.
• API 관련 문제는 OpenWeather support에 문의하세요.

참고 사항

• Temperature 값은 가장 가까운 정수로 자동 반올림됩니다.
• 지정되지 않은 경우 기본 온도 단위는 섭씨(Celsius)입니다.