91 lines
1.3 KiB
Markdown
91 lines
1.3 KiB
Markdown
# Air Conditioner Agent
|
||
|
||
Moss AI 空调控制系统，专门负责家庭空调系统的智能控制。
|
||
|
||
## 功能特性
|
||
|
||
- ⚡ 电源控制（开/关）
|
||
- 🌡️ 温度调节
|
||
- 🔄 模式切换
|
||
- ❄️ 制冷模式
|
||
- 🔥 制热模式
|
||
- 💨 送风模式
|
||
- 💧 除湿模式
|
||
- 🌪️ 风速调节
|
||
- 📊 状态查询
|
||
|
||
## 快速开始
|
||
|
||
### 安装依赖
|
||
|
||
使用 uv（推荐）：
|
||
```bash
|
||
cd agents/air_conditioner_agent
|
||
uv sync
|
||
```
|
||
|
||
### 启动服务
|
||
|
||
使用 uv：
|
||
```bash
|
||
uv run .
|
||
```
|
||
|
||
或使用 Python 模块方式：
|
||
```bash
|
||
python -m .
|
||
```
|
||
|
||
或运行 main.py：
|
||
```bash
|
||
python main.py
|
||
```
|
||
|
||
### 命令行参数
|
||
|
||
```bash
|
||
# 指定主机和端口
|
||
uv run . --host 0.0.0.0 --port 12002
|
||
```
|
||
|
||
## 配置
|
||
|
||
服务配置通过项目根目录的 `config.yaml` 文件管理：
|
||
|
||
```yaml
|
||
agents:
|
||
air_conditioner:
|
||
host: "0.0.0.0"
|
||
port: 12002
|
||
```
|
||
|
||
## 设备配置
|
||
|
||
需要在 `config.yaml` 中配置空调的 IP 和 Token：
|
||
|
||
```yaml
|
||
xiaomi_devices:
|
||
air_conditioner:
|
||
ip: "192.168.1.101"
|
||
token: "your_device_token"
|
||
model: "xiaomi.aircondition.xxx"
|
||
```
|
||
|
||
## 使用示例
|
||
|
||
- "打开空调"
|
||
- "设置温度为 22 度"
|
||
- "切换到制冷模式"
|
||
- "调高风速"
|
||
- "关闭空调"
|
||
|
||
## 依赖
|
||
|
||
- a2a: Agent-to-Agent 协议支持
|
||
- click: 命令行接口
|
||
- uvicorn: ASGI 服务器
|
||
- httpx: HTTP 客户端
|
||
- PyYAML: YAML 配置解析
|
||
- python-miio: 小米设备控制库
|
||
|