intellagent

环境要求

• Python >= 3.9
• 已安装 git，且配置好 GitHub SSH key（README 使用 SSH 地址克隆）
• 使用 pip 或 Conda 安装依赖
• 运行模拟器需可用的 LLM 服务（如 Azure OpenAI）

安装与启动步骤

1. 1克隆仓库

   用 README 提供的 SSH 地址克隆 intellagent 仓库到本地。若未配置 SSH key，需先在 GitHub 添加公钥。

   git clone git@github.com:plurai-ai/intellagent.git

   复制

2. 2进入目录

   切换到克隆下来的 intellagent 项目根目录，后续命令都在此目录执行。

   cd intellagent

   复制

3. 3安装依赖

   README 提供 pip 方式安装 requirements.txt 中的全部依赖，Conda 方式可参考官方文档。

   pip install -r requirements.txt

   复制

4. 4运行简单模拟

   不带数据库的快速环境，输出到 results/education，使用 education 配置文件。

   python run.py --output_path results/education --config_path ./config/config_education.yml

   复制

5. 5运行复杂模拟

   带数据库的复杂环境，速度较慢，输出到 results/airline，使用 airline 配置。

   python run.py --output_path results/airline --config_path ./config/config_airline.yml

   复制

关键配置

如何确认成功

命令执行后在 output_path 指定的目录（如 results/education）下生成模拟与评估结果文件，且终端无报错退出。

常见问题

注意事项

• README 节选缺少 Step 2（LLM 密钥/环境配置）内容，运行前请先查阅官方安装文档 https://intellagent-doc.plurai.ai/quick_start/installation/ 完成配置。
• 克隆使用的是 SSH 地址，若未配置 GitHub SSH key，请改用官方文档给出的 HTTPS 方式或先配置密钥。
• 示例命令使用仓库自带的 config_education.yml 与 config_airline.yml，路径为相对路径，必须在项目根目录执行。
• README 建议通过官方 Customization 文档为自己的业务环境定制模拟配置。