001/README.md

# 多智能体协同系统 C++ 工程

这是一个基于 C++17 和 CMake 的多智能体协同系统骨架工程，实现了核心的调度引擎和智能体管理功能。

## 项目结构

```
├── CMakeLists.txt          # CMake 构建配置文件
├── README.md               # 项目说明文档
├── include/                # 头文件目录
│   └── app.hpp            # 应用程序主要头文件
├── src/                    # 源文件目录
│   ├── main.cpp           # 程序入口点
│   └── app.cpp            # 应用程序实现
└── tests/                  # 测试文件目录
    └── basic_test.cpp     # 基础测试
```

## 核心功能模块

### 1. 智能体管理
- Agent 类的定义和管理
- 智能体注册、注销和发现
- 智能体元数据管理

### 2. 执行流引擎
- 执行流节点定义
- DAG（有向无环图）解析和执行
- 串行和并行执行支持

### 3. 上下文管理
- 全局上下文和节点局部上下文
- 上下文数据传递和持久化

### 4. 任务调度
- 任务队列管理
- 任务状态跟踪
- 异常重试机制

## 编译与运行

### 编译项目
```bash
mkdir build
cd build
cmake ..
cmake --build .
```

### 运行主程序
```bash
./bin/multi_agent_system
```

### 运行测试
```bash
./bin/basic_test
# 或使用 CMake 测试
ctest
```

## 依赖项

- C++17 或更高版本
- CMake 3.15 或更高版本
- 标准 C++ 库

## 后续扩展方向

1. 添加 HTTP 客户端支持智能体通信
2. 实现 JSON Schema 验证
3. 添加数据库连接支持（MySQL、MongoDB）
4. 实现 JWT 认证和 RBAC 权限控制
5. 添加 SSE（Server-Sent Events）流式输出支持
6. 容器化部署配置

## 注意事项

- 当前为骨架实现，包含核心数据结构和基础功能
- 实际生产环境需要添加网络通信、数据库持久化等模块
- 建议结合前端图形化编排器使用