AppAgent

⚠ 该项目 README 未提供完整安装说明，以下步骤为通用流程，请以官方文档为准。

环境要求

• Python 环境（项目为纯 Python 实现）
• 一台可用的 Android 设备或模拟器，用于运行待操作的目标 App
• 可调用的多模态大模型：gpt-4-vision-preview 或 qwen-vl-max（README 明确提到这两者）
• 已完成探索（Exploration）阶段的文档库，或在无文档库情况下运行（成功率不保证）

安装与启动步骤

1. 1获取项目代码

   从官方 GitHub 仓库克隆 AppAgent 源码到本地，随后进入项目根目录操作。

   git clone https://github.com/TencentQQGYLab/AppAgent.git
   cd AppAgent

   复制

2. 2安装项目依赖

   README 节选未给出依赖安装命令，请自行查看仓库中的依赖清单文件后安装 Python 依赖。

3. 3配置多模态模型

   README 明确需使用 gpt-4-vision-preview 或 qwen-vl-max 作为智能体模型，请提前准备好对应模型的可调用凭证。

4. 4完成探索阶段

   README 提到需先完成 Exploration 阶段以生成文档库；节选未给出该阶段的具体命令，请查阅仓库完整说明。

5. 5运行部署阶段

   在项目根目录执行 run.py，按提示依次输入 App 名称、选择要使用的文档库并填写任务描述。

   python run.py

   复制

6. 6确认无文档库时的选择

   若智能体未检测到该 App 已有的文档库，可选择不使用任何文档直接运行，但 README 提示成功率不保证。

如何确认成功

执行 python run.py 并按提示输入 App 名称与任务描述后，智能体自动开始识别屏幕并执行点击、滑动等操作即为启动成功。

常见问题

注意事项

• 本教程仅依据 README 节选，节选只包含 Step 4 部署阶段，安装与探索阶段的完整命令请以官方仓库为准。
• 运行前请确保 Android 设备已连接且屏幕可被正常截图识别。
• 无文档库运行虽有兜底方案，但成功率不保证，建议先完成探索阶段生成文档库。