ReCode: 统一计划与行动，实现通用粒度控制

如果您在使用或复现代码时遇到任何困难，请通过 zhaoyangyu713@gmail.com 与我联系。

ReCode 引入了用于 LLM Agent 的递归代码生成机制，将“计划”和“行动”统一为单一的表示形式。通过将高层级计划视为递归分解为可执行原语的占位符函数，它实现了通用的粒度控制，并能够从战略思考动态适配到具体行动。本仓库包含了论文中使用的参考实现，以及环境封装和实验工具。

核心理念

ReCode 采用分治策略，将复杂任务分解为可执行的代码片段：

树状结构代码：将程序片段组织成一棵树，其中每个节点捕获一个子任务并记录其执行轨迹。
递归扩展：利用 LLM 将占位符函数通过环境特定的 Prompt 和 Few-shot 扩展为更具体的调用或更小的子程序。
动态执行循环：每个节点立即执行；根据最新的观察结果决定是进一步扩展、重试还是结束任务。
共享执行器状态：受限的 Python 执行器负责维护环境变量、验证代码块，并向 Agent 暴露可用的工具集。

仓库布局

run.py – CLI 入口点，用于实例化 Agent/环境、管理并发并记录运行摘要。
agents/recode/ – ReCode Agent 的实现、Prompt 模板及实用辅助工具。
envs/ – 用于 alfworld、webshop 和 sciworld 的环境封装及资源。
configs/ – LLM 配置文件模板及异步客户端使用的（预期）定价元数据。
utils/ – 共享组件：异步 OpenAI 封装、受限执行器、日志记录辅助工具、错误类型定义。
figures/ – 本 README 中使用的论文图片。

实验

为了评估 ReCode 的有效性，我们将实验分为推理部分和训练部分。

推理结果：我们将 ReCode 与几种主流范式（ReAct、CodeAct）以及一些专注于改进基于 LLM 的 Agent 规划的工作（AdaPlanner 和 ADaPT）进行了比较。ReCode 在所有三个环境中都取得了显著的性能提升，平均得分为 60.8，超过了最佳基准方法 10.5 分（相对提升 20.9%）。经我们测试，ReCode 在使用 claude-4-sonnet 时可在 ALFWorld 中获得 100 分的满分。
训练结果：我们使用 Qwen2.5-7B-Instruct 对 ReCode、ReAct 和 CodeAct 进行了监督微调（SFT）。ReCode+SFT 在所有环境中的平均表现达到了 70.4%，优于 ReAct+SFT（67.6%）和 CodeAct+SFT（55.8%），凸显了其卓越的数据效率。

快速上手

运行 ReCode 需要一个 conda 环境，Python 版本应为 3.10 或更高。

此外，需要分别为三个环境配置依赖（目前尚未确认在同一环境中是否会产生冲突），建议在三个独立的虚拟环境中进行配置。

conda create -n recode-envname python=3.10 # 将 "envname" 替换为您想要的环境名称。
conda activate recode-envname

ALFWorld

请遵循 ALFWorld 指令。
将 ALFWORLD_DATA 设置为数据集根目录，或编辑 envs/alfworld/base_config.yaml 指向您的本地路径：
```
export ALFWORLD_DATA=/path/to/alfworld
```

ScienceWorld

请遵循 ScienceWorld 仓库中的说明。

WebShop

感谢 ETO 提供方便的脚本来配置 WebShop 环境。

cd envs/webshop
pip install -e .
conda install -y -c conda-forge openjdk=11
pip install "en_core_web_lg @ https://github.com/explosion/spacy-models/releases/download/en_core_web_lg-3.6.0/en_core_web_lg-3.6.0-py3-none-any.whl"

运行提供的辅助脚本来获取目标集合和预构建的搜索索引：

# 当前路径为 "envs/webshop"
bash setup.sh

安装其他依赖项：

pip install -r requirements.txt # 此处可能不完整，如果您遇到任何问题请及时与我联系

确保 configs/profiles.yaml 指向有效的 API 凭证（如果需要模板，请复制 configs/profiles_example.yaml），然后在任意已启用的环境中进行简单的预运行测试：

python run.py -a recode -e alfworld -n 1 --split test --profile default

一旦环境资源准备就绪，可将 alfworld 替换为 webshop 或 sciworld。日志将写入 logs//，控制台会打印简要摘要以便快速诊断。

配置 LLM 访问

configs/profiles.yaml 中需包含您的 API Key 等配置信息。

FoundationAgents/ReCode