WEB-SHEPHERD Logo

Web-Shepherd: Advancing Process Reward Models for Web Agents

[![PDF](https://img.shields.io/badge/PDF-Preprint-red?logo=arxiv)](assets/WebShepherd.pdf) [![Model](https://img.shields.io/badge/Model-HuggingFace-informational?logo=huggingface)](https://huggingface.co/collections/LangAGI-Lab/web-shepherd-advancing-prms-for-reinforcing-web-agents-682b4f4ad607fc27c4dc49e8) [![Dataset](https://img.shields.io/badge/Dataset-HuggingFace-informational?logo=huggingface)](https://huggingface.co/datasets/LangAGI-Lab/WebPRMCollection_preference_pair) [![Hugging Face Demo](https://img.shields.io/badge/Demo-Huggingface-blue.svg?logo=data:image/svg%2bxml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZlcnNpb249IjEiIHdpZHRoPSI2MDAiIGhlaWdodD0iNjAwIj48cGF0aCBkPSJNMTI5IDExMWMtNTUgNC05MyA2Ni05MyA3OEwwIDM5OGMtMiA3MCAzNiA5MiA2OSA5MWgxYzc5IDAgODctNTcgMTMwLTEyOGgyMDFjNDMgNzEgNTAgMTI4IDEyOSAxMjhoMWMzMyAxIDcxLTIxIDY5LTkxbC0zNi0yMDljMC0xMi00MC03OC05OC03OGgtMTBjLTYzIDAtOTIgMzUtOTIgNDJIMjM2YzAtNy0yOS00Mi05Mi00MmgtMTV6IiBmaWxsPSIjZmZmIi8+PC9zdmc+)](https://demo.web-shepherd.io/) Web-Shepherd is the **first process reward model (PRM)** designed specifically for web agents. It evaluates trajectories at the step level to provide interpretable and cost-efficient feedback for both learning and inference-time decision making in web navigation tasks. --- ## ๐Ÿš€ Overview Recent multimodal language models (MLLMs) have made progress in web automation but struggle with long-horizon planning and cost efficiency. To tackle this, Web-Shepherd introduces: - **WebPRM Collection**: A dataset with 40K+ step-level preference annotations and structured checklists. - **WebRewardBench**: A benchmark to test PRM effectiveness across diverse web tasks. - **Web-Shepherd**: A PRM trained to provide step-wise feedback and reward using structured subgoal checklists. --- ## ๐Ÿง  Key Features - โœ… Step-level trajectory evaluation for web agents - ๐Ÿงพ Checklist-guided reward modeling for interpretability and progress awareness - ๐Ÿ’ฐ 100ร— cost reduction compared to prompting GPT-4o - ๐Ÿ“ˆ Outperforms GPT-4o-mini by **10.9 points** on WebArena-lite - ๐Ÿ”„ Various use cases, including RL, Trajectory Search, and Reflexion

WebPRM Collection Overview

--- ## ๐Ÿ’Ž Assets | Resource | Description | Size | Link | |----------|-------------|------|------| | WebPRM Collection | Step-level preference annotations with structured checklists | 40K+ annotations | [๐Ÿค— huggingface](https://huggingface.co/datasets/LangAGI-Lab/WebPRMCollection_preference_pair) | | WebRewardBench | Comprehensive benchmark for evaluating PRM effectiveness | 1000+ test cases | [๐Ÿค— huggingface](https://huggingface.co/datasets/LangAGI-Lab/WebRewardBench) | | Web-Shepherd (3B, text-only) | Trained process reward model for web navigation | 3B parameters | [๐Ÿค— huggingface](https://huggingface.co/WebShepherd/web-shepherd-base) | | Web-Shepherd (3B, ๐Ÿ–ผ๏ธ multimodal) | Trained process reward model for web navigation | 3B parameters | [Coming Soon!]() | | Web-Shepherd (8B, text-only) | Large version of Web-Shepherd | 8B parameters | [๐Ÿค— huggingface](https://huggingface.co/WebShepherd/web-shepherd-large) | ## WebPRM Collection

WebPRM Collection Overview

The WebPRM Collection contains over 40K step-level preference annotations across diverse web tasks. Each annotation includes: - **Structured Checklists**: Task-specific criteria for evaluating step quality - **Step-level Preferences**: Human annotations comparing trajectory steps - **Rich Metadata**: Task context, action types, and rationales The dataset enables training process reward models that can provide interpretable feedback for web navigation. ## Web-Shepherd

Web-Shepherd Architecture

Web-Shepherd is a process reward model trained on the WebPRM Collection to provide step-level feedback for web navigation tasks. Key components include: - **Checklist Generation**: Processes text and visual inputs from web pages - **Reward Prediction with Checklist**: Incorporates structured evaluation criteria The model achieves strong performance while being significantly more cost-efficient than alternatives like GPT-4o. ## ๐Ÿ“‚ Project Structure ```bash . โ”œโ”€โ”€ webshepherd/ # Source code for the model โ”‚ โ”œโ”€โ”€ models/ # Model architecture & training โ”‚ โ”œโ”€โ”€ data/ # Dataset loading and processing โ”‚ โ””โ”€โ”€ inference/ # Inference utilities (e.g., Best-of-n, feedback) โ”œโ”€โ”€ scripts/ # Training & evaluation scripts โ”œโ”€โ”€ configs/ # Model configs and experiment settings โ”œโ”€โ”€ data/ # Downloaded or generated datasets โ”‚ โ”œโ”€โ”€ webprm_collection/ # Annotated instructions, checklists, and actions โ”‚ โ””โ”€โ”€ webrewardbench/ # Meta-evaluation benchmark โ”œโ”€โ”€ demo/ # Hugging Face Space setup (optional) โ”œโ”€โ”€ results/ # Logs and evaluation outputs โ””โ”€โ”€ README.md ```