Update weather-integration.md

This commit is contained in:
hrz
2025-09-02 14:04:42 +08:00
committed by GitHub
parent 0f0a0814b7
commit 5db638c075
+18 -15
View File
@@ -23,39 +23,42 @@
- **凭据名称**:如"小智语音助手"
- **身份认证方式**:选择"API Key"
6. 点击保存
7. 在凭据中复制API Key到配置文件中
7. 在凭据中复制`API Key`,这是第一个关键的配置信息
### 3. 获取API Host
1. 在控制台中点击["设置"](https://console.qweather.com/setting?lang=zh) → "API Host"
2. 查看分配给你的专属API Host地址
3. 将地址复制到配置文件的 `api_host` 字段
2. 查看分配给你的专属`API Host`地址,这个是第二个关键的配置信息
### 4. 额度说明
- **免费额度**:每天1000次免费调用
- **付费计划**:超出免费额度后按调用次数计费
- **建议**:个人使用免费额度通常足够
以上操作,会得到两个重要的配置信息:`API Key``API Host`
## 配置方式(任选一种)
### 方式1. 通过Web管理界面配置(推荐)
### 方式1. 如果你使用了智控台部署(推荐)
1. 登录智控台
2. 进入"角色配置"页面
3. 选择要配置的智能体
4. 点击"编辑功能"按钮
5. 在右侧参数配置区域找到"天气查询"插件
6. 配置相关参数(天气插件API密钥、默认查询城市等)
6. 勾选"天气查询"
7. 将复制过来的第一个关键配置`API Key`,填入到`天气插件 API 密钥`
8. 将复制过来的第二个关键配置`API Host`,填入到`开发者 API Host`
9. 保存配置,再保存智能体配置
### 方式2. 配置文件方式
### 方式2. 如果你只是单模块xiaozhi-server部署
`config.yaml` 中配置:
`data/.config.yaml` 中配置:
1. 将复制过来的第一个关键配置`API Key`,填入到`api_key`
2. 将复制过来的第二个关键配置`API Host`,填入到`api_host`
3. 将你所在的城市填入到`default_location`里,例如`广州`
```yaml
plugins:
get_weather:
api_host: "你的和风天气API主机地址" # 和风天气API主机地址
api_key: "你的和风天气API密钥" # 必填:API密钥
default_location: "你的默认查询城市" # 默认查询城市
api_key: "你的和风天气API密钥"
api_host: "你的和风天气API主机地址"
default_location: "你的默认查询城市"
```