Skip to main content
LibreChat is joining ClickHouse to power the open-source Agentic Data Stack 🎉 Learn more
LibreChat

OpenWeather

Configureer de OpenWeather tool voor LibreChat

De OpenWeather tool stelt agents in staat om weergegevens op te halen, waaronder actuele omstandigheden, voorspellingen, historische gegevens en dagelijkse samenvattingen met behulp van OpenWeather's One Call API 3.0.

Vereisten

  • Een OpenWeather-account
  • Een OpenWeather API-sleutel (specifiek voor de One Call API 3.0)

Een API-sleutel verkrijgen

  1. Meld je aan voor een OpenWeather-account op OpenWeather
  2. Nadat je bent ingelogd, ga je naar je API keys pagina
  3. Genereer een nieuwe API-sleutel als je er nog geen hebt
  4. Abonneer je op het One Call API 3.0 plan
  5. Wacht tot je API-sleutel is geactiveerd (dit kan tot 2 uur duren)

Configuratie

Omgevingsvariabelen

Voeg het volgende toe aan je .env bestand:

OPENWEATHER_API_KEY=your_api_key_here

De Tool toevoegen aan een Agent

Herstart LibreChat na het wijzigen van .env en voeg vervolgens OpenWeather toe aan een willekeurige agent.

DeploymentCommand
Dockerdocker compose down && docker compose up -d
LokaalStop de server en voer daarna opnieuw npm run backend uit

Selecteer in LibreChat Agents, maak of bewerk een agent, open de Tools-lijst van de agent, selecteer OpenWeather en sla de agent op.

Gebruik

De OpenWeather tool ondersteunt de volgende acties:

  • current_forecast: Haal actuele weer- en voorspellingsgegevens op
  • timestamp: Haal historische weergegevens op voor een specifieke datum
  • daily_aggregation: Haal geaggregeerde weergegevens op voor een specifieke datum
  • overview: Krijg een voor mensen leesbare weersamenvatting

Voorbeeldprompts

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?

Parameters

  • city: Naam van de stad (indien lat/lon niet is opgegeven)
  • lat: Breedtegraad-coördinaat (optioneel indien stad is opgegeven)
  • lon: Lengtegraad-coördinaat (optioneel indien stad is opgegeven)
  • units: Temperatuureenheden ("Celsius", "Kelvin", of "Fahrenheit")
  • lang: Taalkode voor weersbeschrijvingen (bijv. "en", "fr", "es")
  • date: Datum in YYYY-MM-DD formaat (vereist voor timestamp en daily_aggregation acties)
  • tz: Tijdzone (optioneel, voor de daily_aggregation actie)

Probleemoplossing

Veelvoorkomende problemen en oplossingen:

  1. 403 Onbevoegde fout

    • Controleer of uw API-sleutel correct is
    • Controleer of je API-sleutel is geactiveerd (wacht 2 uur na aanmaak)
    • Zorg ervoor dat je geabonneerd bent op de One Call API 3.0
  2. Stad niet gevonden

    • Controleer de spelling van de stadsnaam
    • Probeer de landcode toe te voegen (bijv. "London,UK")
    • Gebruik in plaats daarvan breedtegraad- en lengtegraadcoördinaten
  3. Ongeldige datumnotatie

    • Zorg ervoor dat datums in het YYYY-MM-DD formaat zijn.
    • Historische gegevens zijn alleen beschikbaar vanaf 1979-01-01
    • Toekomstige gegevens zijn beperkt tot 1,5 jaar vooruit

API-limieten

  • Controleer je OpenWeather subscription voor je specifieke limieten
  • Overweeg het implementeren van rate limiting in omgevingen met veel verkeer

Ondersteuning

Voor problemen met de tool:

Opmerkingen

  • Temperatuurwaarden worden automatisch afgerond op de dichtstbijzijnde graad
  • De standaard temperatuureenheid is Celsius indien niet gespecificeerd

Hoe is deze gids?