OpenWeather - Agno

OpenWeatherTools 使 Agent 能够从 OpenWeatherMap API 访问天气数据。

先决条件

以下示例需要 requests 库和一个 API 密钥，该密钥可从 OpenWeatherMap 获取。注册后，您提到的 API 密钥将在几小时后激活，请耐心等待。

export OPENWEATHER_API_KEY=***

示例

下面的 Agent 将使用 OpenWeatherMap 获取东京当前的天气信息。

cookbook/tools/openweather_tools.py

from agno.agent import Agent
from agno.tools.openweather import OpenWeatherTools

# 创建一个包含 OpenWeatherTools 的 Agent
agent = Agent(
    tools=[
        OpenWeatherTools(
            units="imperial",  # 可选值：'standard', 'metric', 'imperial'
        )
    ],
    markdown=True,
)

# 获取某个地点的当前天气
agent.print_response("What's the current weather in Tokyo?", markdown=True)

Toolkit 参数

参数	类型	默认值	描述
`api_key`	`str`	`None`	OpenWeatherMap API 密钥。如果未提供，则使用 OPENWEATHER_API_KEY 环境变量。
`units`	`str`	`metric`	测量单位。可选值：‘standard’, ‘metric’, ‘imperial’。
`current_weather`	`bool`	`True`	启用当前天气功能。
`forecast`	`bool`	`True`	启用天气预报功能。
`air_pollution`	`bool`	`True`	启用空气污染数据功能。
`geocoding`	`bool`	`True`	启用地理编码功能。

Toolkit 函数

函数	描述
`get_current_weather`	获取某个地点的当前天气数据。接受地点名称（例如，“London”）。
`get_forecast`	获取某个地点的天气预报。接受地点名称和可选的天数（默认为 5 天）。
`get_air_pollution`	获取某个地点的当前空气污染数据。接受地点名称。
`geocode_location`	将地点名称转换为地理坐标。接受地点名称和可选的结果限制。

开发者资源

查看 Tools
查看 Cookbook