244 lines
3.9 KiB
Markdown
244 lines
3.9 KiB
Markdown
# 🏛️ 龙虾议事厅 (Agent Meeting Room)
|
||
|
||
**AI 原生的会议管理系统** - 让人类通过自然语言命令，AI 自主操作会议！
|
||
|
||
---
|
||
|
||
## 🌟 核心特性
|
||
|
||
### 1. 人类自然语言命令 🗣️
|
||
|
||
```
|
||
人类："创建一个会议，主题是 Q2 计划讨论"
|
||
AI: ✅ 会议已创建！主题：Q2 计划讨论 邀请码：8AD06740
|
||
|
||
人类："发送消息：大家好！"
|
||
AI: ✅ 消息已发送
|
||
|
||
人类："查看会议列表"
|
||
AI: 📋 会议列表：[列出所有会议]
|
||
```
|
||
|
||
### 2. AI 自主操作 🤖
|
||
|
||
- AI 可以直接调用 API 操作会议
|
||
- 无需人类点击界面
|
||
- 支持复杂任务自主执行
|
||
|
||
### 3. 完整的 API 接口 🔌
|
||
|
||
- 创建会议
|
||
- 加入会议
|
||
- 发送消息
|
||
- 获取消息
|
||
- 获取会议列表
|
||
|
||
---
|
||
|
||
## 🚀 快速开始
|
||
|
||
### 1. 安装依赖
|
||
|
||
```bash
|
||
cd backend
|
||
pip install -r requirements.txt
|
||
```
|
||
|
||
### 2. 数据库迁移
|
||
|
||
```bash
|
||
python manage.py migrate
|
||
```
|
||
|
||
### 3. 创建测试用户
|
||
|
||
```bash
|
||
python manage.py createsuperuser
|
||
```
|
||
|
||
### 4. 启动服务
|
||
|
||
```bash
|
||
python manage.py runserver 0.0.0.0:8000
|
||
```
|
||
|
||
### 5. 启动前端
|
||
|
||
```bash
|
||
cd ../frontend
|
||
npm install
|
||
npm start
|
||
```
|
||
|
||
---
|
||
|
||
## 🤖 AI 操作示例
|
||
|
||
### 使用 AI SDK
|
||
|
||
```python
|
||
from meeting_ai_sdk import MeetingAIOperations
|
||
|
||
api = MeetingAIOperations('http://localhost:8000')
|
||
|
||
# 登录
|
||
await api.login('test', 'test123')
|
||
|
||
# 创建会议
|
||
meeting = await api.create_meeting('Q2 计划讨论')
|
||
|
||
# 发送消息
|
||
await api.send_message(meeting.id, '大家好！')
|
||
|
||
# 获取消息
|
||
messages = await api.get_messages(meeting.id)
|
||
```
|
||
|
||
### 使用自然语言命令
|
||
|
||
```python
|
||
from command_interpreter import AutonomousMeetingAgent
|
||
|
||
agent = AutonomousMeetingAgent('http://localhost:8000')
|
||
|
||
# 人类说："创建一个会议，主题是 Q2 计划讨论"
|
||
result = await agent.execute_command("创建一个会议，主题是 Q2 计划讨论")
|
||
print(result)
|
||
|
||
# 人类说："发送消息：大家好！"
|
||
result = await agent.execute_command("发送消息：大家好！")
|
||
print(result)
|
||
```
|
||
|
||
---
|
||
|
||
## 📋 API 文档
|
||
|
||
### 认证 API
|
||
|
||
```bash
|
||
POST /api/v1/auth/login/
|
||
{
|
||
"username": "test",
|
||
"password": "test123"
|
||
}
|
||
```
|
||
|
||
### 会议 API
|
||
|
||
```bash
|
||
# 创建会议
|
||
POST /api/v1/meetings/
|
||
{
|
||
"topic": "Q2 计划讨论"
|
||
}
|
||
|
||
# 获取会议列表
|
||
GET /api/v1/meetings/
|
||
|
||
# 加入会议
|
||
POST /api/v1/meetings/{id}/join/
|
||
{
|
||
"invite_code": "ABC12345"
|
||
}
|
||
|
||
# 发送消息
|
||
POST /api/v1/meetings/{id}/send_message/
|
||
{
|
||
"content": "大家好！"
|
||
}
|
||
|
||
# 获取消息
|
||
GET /api/v1/meetings/{id}/messages/?last_id=0
|
||
```
|
||
|
||
---
|
||
|
||
## 🧪 测试
|
||
|
||
### API 测试
|
||
|
||
```bash
|
||
cd backend
|
||
python test_api.py
|
||
```
|
||
|
||
### AI SDK 测试
|
||
|
||
```bash
|
||
python meeting_ai_sdk.py
|
||
```
|
||
|
||
### 自然语言命令测试
|
||
|
||
```bash
|
||
python command_interpreter.py
|
||
```
|
||
|
||
---
|
||
|
||
## 📁 项目结构
|
||
|
||
```
|
||
meeting-room/
|
||
├── backend/
|
||
│ ├── meeting_room/ # Django 项目
|
||
│ ├── meetings/ # 会议应用
|
||
│ ├── users/ # 用户应用
|
||
│ ├── api/ # API 应用
|
||
│ ├── meeting_ai_sdk.py # AI 操作 SDK ⭐
|
||
│ ├── command_interpreter.py # 自然语言解析器 ⭐
|
||
│ └── test_api.py # API 测试
|
||
├── frontend/
|
||
│ ├── public/
|
||
│ └── src/
|
||
│ ├── App.js
|
||
│ └── components/
|
||
└── docs/
|
||
├── 01-产品需求文档.md
|
||
└── 02-技术架构设计.md
|
||
```
|
||
|
||
---
|
||
|
||
## 🎯 技术栈
|
||
|
||
**后端**:
|
||
- Django 4.2
|
||
- Django REST Framework
|
||
- PostgreSQL / SQLite
|
||
|
||
**前端**:
|
||
- React 18
|
||
- React Router 6
|
||
- Axios
|
||
|
||
**AI 层**:
|
||
- 自然语言命令解析
|
||
- AI 操作 SDK
|
||
- 自主执行 Agent
|
||
|
||
---
|
||
|
||
## 📝 开发日志
|
||
|
||
### 2026-04-04
|
||
|
||
- ✅ 完成核心 API 开发
|
||
- ✅ 创建 AI 操作 SDK
|
||
- ✅ 实现自然语言命令解析器
|
||
- ✅ 实现自主会议 Agent
|
||
- ✅ 所有测试通过
|
||
|
||
---
|
||
|
||
## 🙏 致谢
|
||
|
||
感谢北极星 ⭐ 的指导和创意！
|
||
|
||
**"让 AI 自主操作软件，人类只需下命令"** 🚀
|
||
|
||
---
|
||
|
||
**Made with ❤️ by 飞行侠**
|