mirror of
https://github.com/xinnan-tech/xiaozhi-esp32-server.git
synced 2026-07-24 08:03:53 +08:00
62 lines
1.9 KiB
Markdown
62 lines
1.9 KiB
Markdown
# 天气插件使用指南
|
|
|
|
## 概述
|
|
|
|
天气插件 `get_weather` 是小智ESP32语音助手的核心功能之一，支持通过语音查询全国各地的天气信息。插件基于和风天气API，提供实时天气和7天天气预报功能。
|
|
|
|
## API Key 申请指南
|
|
|
|
### 1. 注册和风天气账号
|
|
|
|
1. 访问 [和风天气控制台](https://console.qweather.com/)
|
|
2. 注册账号并完成邮箱验证
|
|
3. 登录控制台
|
|
|
|
### 2. 创建应用获取API Key
|
|
|
|
1. 进入控制台后，点击右侧"项目管理"(https://console.qweather.com/project?lang=zh) → "创建项目"
|
|
2. 填写项目信息：
|
|
- **项目名称**：如"小智语音助手"
|
|
3. 点击保存
|
|
4. 项目创建完成后，在该项目中点击"创建凭据"
|
|
5. 填写凭据信息：
|
|
- **凭据名称**：如"小智语音助手"
|
|
- **身份认证方式**：选择"API Key"
|
|
6. 点击保存
|
|
7. 在凭据中复制API Key到配置文件中
|
|
|
|
### 3. 获取API Host
|
|
|
|
1. 在控制台中点击"设置"(https://console.qweather.com/setting?lang=zh) → "API Host"
|
|
2. 查看分配给你的专属API Host地址
|
|
3. 将地址复制到配置文件的 `api_host` 字段
|
|
|
|
### 4. 额度说明
|
|
|
|
- **免费额度**：每天1000次免费调用
|
|
- **付费计划**：超出免费额度后按调用次数计费
|
|
- **建议**：个人使用免费额度通常足够
|
|
|
|
## 配置方式(任选一种)
|
|
|
|
### 方式1. 通过Web管理界面配置（推荐）
|
|
|
|
1. 登录智控台
|
|
2. 进入"角色配置"页面
|
|
3. 选择要配置的智能体
|
|
4. 点击"编辑功能"按钮
|
|
5. 在右侧参数配置区域找到"天气查询"插件
|
|
6. 配置相关参数（天气插件API密钥、默认查询城市等）
|
|
|
|
### 方式2. 配置文件方式
|
|
|
|
在 `config.yaml` 中配置：
|
|
|
|
```yaml
|
|
plugins:
|
|
get_weather:
|
|
api_host: "你的和风天气API主机地址" # 和风天气API主机地址
|
|
api_key: "你的和风天气API密钥" # 必填：API密钥
|
|
default_location: "你的默认查询城市" # 默认查询城市
|
|
```
|