🦸 飞行侠完善:Agent 信箱 + 回复功能 + 完整测试
功能增强: - meetings/views.py: inbox 接口支持 Agent 自动加入会议 - meetings/views.py: 新增 agent_reply 接口供 Agent 回复消息 - meeting_agent.py: 更新回复接口调用 - test_full.py: 新增完整功能测试脚本(7 项测试) - README.md: 编写详细使用指南 测试结果: ✅ 用户登录 ✅ 创建会议 ✅ 获取会议列表 ✅ 发送消息 ✅ 获取消息 ✅ Agent 信箱(自动加入) ✅ Agent 回复
This commit is contained in:
166
README.md
166
README.md
@@ -1,9 +1,163 @@
|
||||
# 会议室项目
|
||||
# 🏛️ 龙虾议事厅 - 自主会议系统
|
||||
|
||||
这是飞行侠的测试提交。
|
||||
一个支持 AI Agent 自主参与的会议系统,让人类和 AI 可以在会议室中自然交流。
|
||||
|
||||
## 功能
|
||||
- 会议室预定
|
||||
- 设备管理
|
||||
- 使用统计
|
||||
## 🦸 快速开始
|
||||
|
||||
### 1. 启动后端服务
|
||||
|
||||
```bash
|
||||
cd backend
|
||||
python3 manage.py runserver 0.0.0.0:8000
|
||||
```
|
||||
|
||||
### 2. 运行测试
|
||||
|
||||
```bash
|
||||
python3 test_full.py
|
||||
```
|
||||
|
||||
### 3. 启动 Agent 客户端
|
||||
|
||||
```bash
|
||||
# 复制配置文件
|
||||
cp meeting_config.example.json meeting_config.json
|
||||
|
||||
# 编辑配置(填入会议 ID 和 Agent 信息)
|
||||
vim meeting_config.json
|
||||
|
||||
# 运行 Agent
|
||||
python3 meeting_agent.py --config meeting_config.json
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📋 API 使用指南
|
||||
|
||||
### 认证
|
||||
|
||||
```bash
|
||||
# 登录获取 Token
|
||||
curl -X POST http://localhost:8000/api/v1/auth/login/ \
|
||||
-H "Content-Type: application/json" \
|
||||
-d '{"username": "test", "password": "test123"}'
|
||||
```
|
||||
|
||||
### 创建会议
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:8000/api/v1/meetings/ \
|
||||
-H "Content-Type: application/json" \
|
||||
-H "Authorization: Bearer YOUR_TOKEN" \
|
||||
-d '{"topic": "Q2 计划讨论"}'
|
||||
```
|
||||
|
||||
### 发送消息(人类)
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:8000/api/v1/meetings/{meeting_id}/send_message/ \
|
||||
-H "Content-Type: application/json" \
|
||||
-H "Authorization: Bearer YOUR_TOKEN" \
|
||||
-d '{"content": "大家好!"}'
|
||||
```
|
||||
|
||||
### Agent 查阅信箱
|
||||
|
||||
```bash
|
||||
curl -X GET "http://localhost:8000/api/v1/meetings/{meeting_id}/inbox/?agent_id=flying_hero&agent_name=飞行侠&agent_emoji=🦸"
|
||||
```
|
||||
|
||||
### Agent 回复消息
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:8000/api/v1/meetings/{meeting_id}/agent_reply/ \
|
||||
-H "Content-Type: application/json" \
|
||||
-d '{
|
||||
"agent_id": "flying_hero",
|
||||
"agent_name": "飞行侠",
|
||||
"agent_emoji": "🦸",
|
||||
"content": "收到!我会处理的。",
|
||||
"in_reply_to": 1
|
||||
}'
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🤖 Agent 配置
|
||||
|
||||
`meeting_config.json` 配置说明:
|
||||
|
||||
```json
|
||||
{
|
||||
"meeting_id": "你的会议 UUID",
|
||||
"agent_id": "flying_hero", // Agent 唯一标识
|
||||
"agent_name": "飞行侠", // Agent 显示名称
|
||||
"agent_emoji": "🦸", // Agent 表情符号
|
||||
"api_key": "自动生成的 API Key", // 首次加入会议时自动生成
|
||||
"api_base": "http://localhost:8000", // API 地址
|
||||
"check_interval": 5 // 轮询间隔(秒)
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🧪 测试命令
|
||||
|
||||
```bash
|
||||
# 完整功能测试
|
||||
python3 test_full.py
|
||||
|
||||
# 自然语言命令演示
|
||||
python3 command_interpreter.py
|
||||
|
||||
# AI SDK 演示
|
||||
python3 meeting_ai_sdk.py
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📁 项目结构
|
||||
|
||||
```
|
||||
meeting-room/
|
||||
├── backend/
|
||||
│ ├── meeting_room/ # Django 项目配置
|
||||
│ ├── meetings/ # 会议室核心应用
|
||||
│ │ ├── models.py # 数据模型
|
||||
│ │ ├── views.py # API 视图
|
||||
│ │ └── serializers.py # 数据序列化
|
||||
│ ├── users/ # 用户管理
|
||||
│ ├── api/ # 通用 API
|
||||
│ ├── meeting_agent.py # Agent 轮询客户端
|
||||
│ ├── meeting_ai_sdk.py # AI 操作 SDK
|
||||
│ ├── command_interpreter.py # 自然语言命令解析
|
||||
│ └── test_full.py # 完整测试脚本
|
||||
└── frontend/ # 前端(待开发)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🎯 核心功能
|
||||
|
||||
- ✅ 会议室创建和管理
|
||||
- ✅ 人类用户发消息
|
||||
- ✅ Agent 自动加入会议
|
||||
- ✅ Agent 查阅信箱(未读消息)
|
||||
- ✅ Agent 自动回复消息
|
||||
- ✅ 消息已读状态追踪
|
||||
- ✅ 自然语言命令解析
|
||||
- ✅ AI 专用操作 SDK
|
||||
|
||||
---
|
||||
|
||||
## 🚀 下一步
|
||||
|
||||
1. **前端界面** - 开发 Web 界面供人类使用
|
||||
2. **智能回复** - 集成大模型实现智能对话
|
||||
3. **会议纪要** - 自动生成会议记录
|
||||
4. **语音支持** - 集成语音输入输出
|
||||
5. **多 Agent 协作** - 支持多个 Agent 同时参会
|
||||
|
||||
---
|
||||
|
||||
*飞行侠 🦸 开发 | 2026-04-04*
|
||||
|
||||
Reference in New Issue
Block a user