PC-Agent项目教程

PC-Agent项目教程

1. 项目目录结构及介绍

PC-Agent项目的目录结构如下：

PC-Agent/
├── agent/             # 包含多智能体系统的参考实现
│   ├── main.py        # 主程序文件，用于启动智能体系统
│   └── server/        # 包含模型部署的参考脚本
├── assets/            # 存储项目所需的资源文件
├── environment.yml    # Conda环境配置文件
├── LICENSE            # 项目许可证文件
├── postprocess/       # 数据后处理模块
│   ├── completion.py  # 认知完成处理脚本
│   └── refinement.py  # 数据精炼处理脚本
├── README.md          # 项目说明文件
├── tracker/           # 数据收集模块
│   ├── package.ps1    # Windows下打包可执行文件的脚本
│   └── tasks.json     # 数据收集任务配置文件
└── data/              # 存储原始交互数据及示例数据

• agent/ 目录包含了多智能体系统的实现代码，其中 main.py 是启动智能体系统的主要脚本，server/ 目录包含了模型部署的参考脚本。
• assets/ 目录用于存放项目所需的资源文件，如图片、视频等。
• environment.yml 是Conda环境配置文件，用于创建项目所需的环境。
• LICENSE 文件包含了项目的许可协议。
• postprocess/ 目录包含了数据后处理的脚本，用于将原始交互数据转换为认知轨迹。
• README.md 是项目的说明文档，包含了项目的概述、安装和使用说明。
• tracker/ 目录包含了数据收集模块的代码，用于收集人机交互数据。
• data/ 目录用于存放原始交互数据以及示例数据。

2. 项目的启动文件介绍

项目的启动文件为 agent/main.py。该文件负责初始化和启动多智能体系统。主要执行以下步骤：

• 加载配置文件和模型参数。
• 初始化规划智能体和视觉定位智能体。
• 启动智能体，执行任务。

运行 main.py 文件前，确保已经正确配置了环境，并且安装了所有必要的依赖项。

3. 项目的配置文件介绍

项目的配置文件为 tracker/tasks.json。这个文件用于定义数据收集任务的具体参数，包括但不限于以下内容：

• tasks: 一个任务数组，每个任务包含以下字段：
  • name: 任务名称。
  • description: 任务描述。
  • steps: 一个步骤数组，定义了完成任务所需的步骤。
    • action: 步骤的动作描述。
    • value: 动作对应的值或参数。

在开始数据收集前，需要根据具体的收集需求修改 tasks.json 文件中的内容。每个任务的步骤应详细描述用户需要执行的动作和提供的相关信息，以确保收集到的数据符合研究要求。