README.md

May 27, 2026 ยท View on GitHub

ICML 2026 Spotlight ย |ย  Now Open Source

Agentic RL Arena Framework
Figure 1: Overview of the T2PO framework ย ๏ฝœย  ICML 2026 Spotlight

Problem: Hesitation is defeat! Multi-turn RL for LLM agents is powerful, but critically limited by poor exploration.

Key idea: Training fails mostly when agents repeat low-value actions or ignore task-level uncertainty.

Our method: T2PO directly controls exploration at both the token and turn level using uncertainty signals, greatly improving stability and sample efficiency.


๐Ÿ› ๏ธ T2PO Framework Design

๐Ÿ”น Token-level: T2PO tracks marginal uncertainty and triggers interventions when it dips below a threshold.
๐Ÿ”ธ Turn-level: T2PO resamples turns with negligible exploration progress, preventing wasted updates.
๐Ÿ“Š Benchmarks: Substantial gains on WebShop, ALFWorld, SearchQA and moreโ€”significantly better stability and learning efficiency.

๐Ÿ”ฅ Key Features

  • โœ… Support Training Multi-turn Embody Agents
  • โœ… Support Training Multi-turn Search Agents
  • โœ… Support Training Multi-turn Multi-modal Game Agents
  • โœ… Support Training Multi-turn Web Agents
  • โœ… Support Evaluating Commerical LLMs as Agents

๐Ÿ’ก Getting Started

Our work is based on the following main dependencies:

Python=3.11, VeRL=0.4.0, PyTorch=2.6.0, and vLLM=0.8.5
๐Ÿ‘‰ Click to expand installation guide (optional)
# (Optional) Install conda
bash set_conda.sh

# Install main dependencies
bash setup_env.sh

# Install extra requirements for specific tasks
conda activate verl
pip install -r requirements_xxx.txt

๐Ÿš€ Existing Support

๐Ÿค– Embodied Agents
# 1. Build the environments
bash prepare_all_embody.sh

# 2. Run the demo code
conda activate agentrl_embody
bash examples/world_agent_trainer/train_xxx.sh
๐Ÿ›’ Web Agents
# 1. Build the webshop environments
bash prepare_all_web.sh

# 2. Run the demo code
conda activate agentrl_web
bash examples/shop_agent_trainer/train_xxxx.sh
๐Ÿ•ธ๏ธ Search Agents
# 1. Build the RAG server environments
bash prepare_all_search.sh

# 2. Run the demo code
conda activate agentrl_search
bash examples/search_agent_trainer/train_xxx.sh
๐ŸŽฎ Multi-modal Game Agents
# 1. Install the requirements
bash prepare_all_game.sh

# 2. Run the demo code
bash examples/game_agent_trainer/train_xxx.sh

๐ŸŒŠ Easy Extension

โœจ Extensible by Design:

  • All task recipes live in recipe. Wrap the VERL worker to plug in your own method. [usage]
  • Add new environments under agent_system.
  • Extra dependencies go into requirements_xxx.txt.
  • Third-party tools? Place them in AgentRL/sandbox.

๐Ÿ“Š Further Analysis

๐Ÿ“ˆ Expand for MLFlow analysis setup
# Install requirements
pip install mlflow

# Start server
mlflow server \
  --host 0.0.0.0 --port 5000 \
  --backend-store-uri sqlite:////tmp/mlruns.db \
  --default-artifact-root /tmp/mlruns

export MLFLOW_TRACKING_URI=http://127.0.0.1:5000

# Trainer config
actor_rollout_ref.rollout.trace.backend: mlflow  # or weave
actor_rollout_ref.rollout.trace.token2text: True
trainer.logger: ['console', 'mlflow']

โœ๏ธ Citation

@article{wang2026t,
  title={T $^2$ PO: Uncertainty-Guided Exploration Control for Stable Multi-Turn Agentic Reinforcement Learning},
  author={Wang, Haixin and Cui, Hejie and Zhang, Chenwei and Liu, Xin and Jin, Shuowei and Geng, Shijie and Zhang, Xinyang and Zalmout, Nasser and Shi, Zhenyu and Sun, Yizhou},
  journal={arXiv preprint arXiv:2605.02178},
  year={2026}
}