常见问题 - 认知异质性实验

安装与配置

Q: 系统要求是什么？

A: 认知异质性实验项目的系统要求如下：

操作系统：Windows 10/11, macOS 10.15+, 或 Linux
Python版本：3.9或更高版本
内存：至少8GB RAM（推荐16GB）
存储空间：至少5GB可用空间

Q: 如何安装依赖？

A: 我们推荐使用Poetry进行依赖管理：

# 安装Poetry（如果尚未安装）
curl -sSL https://install.python-poetry.org | python3 -

# 安装项目依赖
poetry install

# 激活虚拟环境
poetry shell
                        

或者使用pip：

# 创建虚拟环境
python -m venv che-env

# 激活虚拟环境
# Windows:
che-env\Scripts\activate
# macOS/Linux:
source che-env/bin/activate

# 安装依赖
pip install -r requirements.txt
                        

Q: 如何配置云服务API密钥？

A: 创建并编辑.env文件：

# 复制示例配置文件
cp .env.example .env

# 编辑配置文件
nano .env  # 或使用您喜欢的编辑器
                        

在.env文件中添加您的API密钥：

# OpenAI API密钥
OPENAI_API_KEY=your-openai-api-key

# Azure OpenAI服务
AZURE_API_KEY=your-azure-api-key
AZURE_ENDPOINT=your-azure-endpoint

# 阿里云DashScope
ALIYUN_API_KEY=your-aliyun-api-key
                        

实验运行

Q: 如何运行基础实验？

A: 运行基础实验：

# 使用Poetry运行
poetry run python main.py

# 或直接运行
python main.py
                        

运行正式科学实验：

poetry run python FORMAL_SCIENTIFIC_EXPERIMENT.py

Q: 如何自定义实验参数？

A: 编辑config/experiment_config.py文件：

# 实验配置示例
NUM_GENERATIONS = 15  # 进化代数
INITIAL_POPULATION = 30  # 初始群体大小
CRITICAL_AGENT_RATIO = 0.2  # 批判型智能体比例
AWAKENED_AGENT_RATIO = 0.1  # 觉醒型智能体比例
MODEL_POOL = ["gpt-3.5-turbo", "gpt-4"]  # 模型池
                        

Q: 实验结果保存在哪里？

A: 实验结果默认保存在以下目录：

results/ - 主要实验结果
complete_paper_results/ - 完整论文实验结果
paper_results/ - 论文实验结果
optimized_paper_results/ - 优化实验结果
checkpoints/ - 实验检查点文件

结果文件格式包括JSON、Markdown和CSV。

CloudAgent使用

Q: CloudAgent支持哪些云服务？

A: CloudAgent支持以下云服务提供商：

OpenAI：兼容OpenAI API的模型
Azure：Azure OpenAI服务
阿里云：阿里云DashScope
腾讯云：腾讯云HunYuan
百度云：百度云文心一言

Q: 如何创建不同类型的智能体？

A: 使用AgentFactory创建不同类型的智能体：

from src.che.agents.agent_factory import AgentFactory

# 创建批判型智能体
critical_agent = AgentFactory.create_critical_agent(
    'cloud', 'critical_01', 'gpt-3.5-turbo',
    service_type='openai', api_key=os.getenv('OPENAI_API_KEY')
)

# 创建觉醒型智能体
awakened_agent = AgentFactory.create_awakened_agent(
    'cloud', 'awakened_01', 'gpt-4',
    service_type='openai', api_key=os.getenv('OPENAI_API_KEY')
)

# 创建标准型智能体
standard_agent = AgentFactory.create_standard_agent(
    'cloud', 'standard_01', 'gpt-3.5-turbo',
    service_type='openai', api_key=os.getenv('OPENAI_API_KEY')
)
                        

Q: 如何处理API调用错误？

A: CloudAgent包含错误处理机制：

try:
    response = agent.execute(task)
except Exception as e:
    print(f"API调用错误: {e}")
    # 实现重试逻辑或降级策略
                        

建议实现重试机制：

import time
from functools import wraps

def retry(max_attempts=3, delay=1):
    def decorator(func):
        @wraps(func)
        def wrapper(*args, **kwargs):
            for attempt in range(max_attempts):
                try:
                    return func(*args, **kwargs)
                except Exception as e:
                    if attempt == max_attempts - 1:
                        raise e
                    time.sleep(delay * (2 ** attempt))  # 指数退避
            return None
        return wrapper
    return decorator
                        

故障排除

Q: 安装失败怎么办？

A: 常见安装问题解决方案：

Poetry安装失败：
# 升级pip pip install --upgrade pip # 重新安装Poetry pip install poetry
依赖冲突：
# 清理缓存 poetry cache clear pypi --all # 重新安装 poetry install
Python版本问题：
确保使用Python 3.9或更高版本：

python --version

Q: 实验运行缓慢怎么办？

A: 优化实验性能的方法：

减少群体大小：降低INITIAL_POPULATION值
减少代数：降低NUM_GENERATIONS值
使用更快模型：选择响应速度更快的模型
优化网络连接：确保稳定的网络环境
并行处理：利用多线程执行多个实验

Q: 如何获取技术支持？

A: 获取技术支持的途径：

GitHub Issues：在项目仓库提交问题
社区论坛：参与讨论和交流
电子邮件：发送邮件至support@agentpsy.com
即时通讯：加入QQ群876543210或Telegram群组

提交问题时请包含以下信息：

错误信息和堆栈跟踪
系统环境信息（操作系统、Python版本等）
复现步骤
相关配置文件内容