112 lines
3.7 KiB
Markdown
112 lines
3.7 KiB
Markdown
---
|
||
name: get_weather_open
|
||
description: 使用 OpenWeather API 获取指定城市的实时天气信息
|
||
metadata:
|
||
status: archived
|
||
---
|
||
|
||
# 获取天气技能 (OpenWeather API 版本)
|
||
|
||
## 使用场景
|
||
当用户询问某个城市的天气情况时使用此技能。使用 OpenWeather API 替代 wttr.in，提供更稳定和详细的天气信息。
|
||
|
||
## 前提条件
|
||
1. 需要 OpenWeather API 密钥
|
||
2. 需要在环境变量中设置 OPENWEATHER_API_KEY
|
||
|
||
## 执行步骤
|
||
|
||
1. 从用户消息中提取城市名称
|
||
2. 使用 `python_repl` 工具编写 Python 代码调用 OpenWeather API：
|
||
```python
|
||
import os
|
||
import requests
|
||
import json
|
||
|
||
# 从环境变量获取 API 密钥
|
||
api_key = os.getenv("OPENWEATHER_API_KEY")
|
||
city = "城市名" # 从用户输入中提取
|
||
|
||
if not api_key:
|
||
print("错误：未设置 OPENWEATHER_API_KEY 环境变量")
|
||
else:
|
||
# 调用 OpenWeather API
|
||
url = f"https://api.openweathermap.org/data/2.5/weather?q={city}&appid={api_key}&units=metric&lang=zh_cn"
|
||
response = requests.get(url)
|
||
|
||
if response.status_code == 200:
|
||
data = response.json()
|
||
# 提取天气信息
|
||
weather = {
|
||
"城市": data["name"],
|
||
"国家": data["sys"]["country"],
|
||
"温度": f"{data['main']['temp']}°C",
|
||
"体感温度": f"{data['main']['feels_like']}°C",
|
||
"天气状况": data["weather"][0]["description"],
|
||
"湿度": f"{data['main']['humidity']}%",
|
||
"气压": f"{data['main']['pressure']} hPa",
|
||
"风速": f"{data['wind']['speed']} m/s",
|
||
"风向": data["wind"].get("deg", "未知"),
|
||
"能见度": f"{data.get('visibility', 0) / 1000} km" if data.get('visibility') else "未知"
|
||
}
|
||
print(json.dumps(weather, ensure_ascii=False, indent=2))
|
||
else:
|
||
print(f"错误：无法获取天气信息，状态码：{response.status_code}")
|
||
print(f"错误信息：{response.text}")
|
||
```
|
||
|
||
3. 解析返回的 JSON 数据，提取关键信息
|
||
4. 用自然语言向用户汇报天气情况
|
||
|
||
## 示例
|
||
|
||
用户：「查询北京的天气」
|
||
|
||
执行流程：
|
||
1. 提取城市：北京 (Beijing)
|
||
2. 在 python_repl 中执行上述代码，将 city 替换为 "Beijing"
|
||
3. 解析返回的 JSON 结果
|
||
4. 回复：「北京当前天气：晴，温度 25°C，体感温度 26°C，湿度 40%，风速 3.5 m/s。」
|
||
|
||
## 备用方案
|
||
如果 OpenWeather API 不可用，可以回退到使用 fetch_url 访问 wttr.in：
|
||
```python
|
||
import requests
|
||
try:
|
||
# 尝试 OpenWeather API
|
||
# ...
|
||
except Exception as e:
|
||
# 回退到 wttr.in
|
||
fallback_url = f"https://wttr.in/{city}?format=j1&lang=zh"
|
||
fallback_response = requests.get(fallback_url)
|
||
# 解析 wttr.in 数据
|
||
```
|
||
|
||
## 注意事项
|
||
1. **API 密钥**：必须先在环境变量中设置 OPENWEATHER_API_KEY
|
||
2. **城市格式**：建议使用英文城市名，OpenWeather API 支持中文但英文更可靠
|
||
3. **单位系统**：使用公制单位 (metric)
|
||
4. **语言**：设置为中文 (lang=zh_cn)
|
||
5. **错误处理**：妥善处理 API 调用失败的情况
|
||
6. **速率限制**：OpenWeather 免费版有调用限制，注意不要频繁调用
|
||
|
||
## 环境变量设置
|
||
在 .env 文件中添加：
|
||
```
|
||
OPENWEATHER_API_KEY=your_api_key_here
|
||
```
|
||
|
||
## 获取 API 密钥
|
||
1. 访问 https://openweathermap.org/api
|
||
2. 注册账号
|
||
3. 在 Dashboard 中创建 API 密钥
|
||
4. 免费版每天有 60 次调用限制
|
||
|
||
## 数据字段说明
|
||
- main.temp: 当前温度 (摄氏度)
|
||
- main.feels_like: 体感温度
|
||
- weather[0].description: 天气描述
|
||
- main.humidity: 湿度百分比
|
||
- wind.speed: 风速 (米/秒)
|
||
- visibility: 能见度 (米)
|