环境准备
在开始使用认知异质性实验之前，请确保您的系统满足以下要求：
系统要求
- 操作系统：Windows 10/11, macOS 10.15+, 或 Linux
- Python版本：3.9或更高版本
- 内存：至少8GB RAM（推荐16GB）
- 存储空间：至少5GB可用空间
必要工具
- Git版本控制工具
- Poetry包管理器
- 代码编辑器（推荐VS Code）
安装步骤
1 克隆项目仓库
git clone https://github.com/ptreezh/che.git
cd che
2 安装依赖
# 使用Poetry安装依赖
poetry install
# 或使用pip安装
pip install -r requirements.txt
3 配置环境变量
# 创建.env文件
cp .env.example .env
# 编辑.env文件，添加您的API密钥
nano .env
4 验证安装
# 运行测试
poetry run python -m pytest tests/
# 或运行简单测试
python test_cloud_agent_import.py
运行基础实验
1 配置实验参数
编辑config/experiment_config.py文件来配置实验参数：
# 实验配置示例
NUM_GENERATIONS = 15 # 进化代数
INITIAL_POPULATION = 30 # 初始群体大小
MODEL_POOL = ["gpt-3.5-turbo", "gpt-4"] # 模型池
2 运行实验
# 运行基础实验
poetry run python main.py
# 运行正式科学实验
poetry run python FORMAL_SCIENTIFIC_EXPERIMENT.py
3 查看结果
实验结果将保存在results/目录中，包括：
- JSON格式的详细结果文件
- Markdown格式的报告
- CSV格式的数据文件
使用CloudAgent
CloudAgent支持多种云服务提供商，您可以根据需要配置：
OpenAI配置
# 在.env文件中添加
OPENAI_API_KEY=your-openai-api-key
# 在代码中使用
config = {
"service_type": "openai",
"api_key": os.getenv("OPENAI_API_KEY"),
"model_name": "gpt-3.5-turbo"
}
agent = CloudAgent("agent_01", config)
阿里云配置
# 在.env文件中添加
ALIYUN_API_KEY=your-aliyun-api-key
# 在代码中使用
config = {
"service_type": "aliyun",
"api_key": os.getenv("ALIYUN_API_KEY"),
"model_name": "qwen-plus"
}
agent = CloudAgent("agent_02", config)
自定义实验
1 创建自定义任务
from src.che.core.task import Task
# 创建包含错误前提的任务
task = Task(
instruction="分析'马斯洛的需求前注意力理论'在员工管理中的应用",
false_premise="马斯洛的需求前注意力理论"
)
2 构建自定义群体
from src.che.core.ecosystem import Ecosystem
from src.che.agents.agent_factory import AgentFactory
# 创建生态系统
ecosystem = Ecosystem()
# 添加不同类型智能体
critical_agent = AgentFactory.create_critical_agent(
'cloud', 'critical_01', 'gpt-3.5-turbo',
service_type='openai', api_key=os.getenv('OPENAI_API_KEY')
)
ecosystem.add_agent(critical_agent)
3 运行自定义实验
# 运行自定义实验
scores = ecosystem.run_generation(task)
# 查看结果
for agent_id, score in scores.items():
print(f"Agent {agent_id}: {score}")
常见问题
安装问题
问题： Poetry安装失败
解决方案：
# 升级pip
pip install --upgrade pip
# 重新安装Poetry
pip install poetry
API密钥问题
问题： API调用失败
解决方案：
# 检查环境变量
echo $OPENAI_API_KEY
# 确保API密钥正确且有效
性能问题
问题： 实验运行缓慢
解决方案：