A Python framework for building cross-environment benchmarks that evaluate multimodal LLM agents across in-memory, Docker, VM, and physical-machine environments.
sierra-research/tau2-bench
A simulation benchmark for evaluating customer-service AI agents that use tools and talk with simulated users in text and voice.
- Stars
- 2,411
- Forks
- 629
- Open issues
- 306
- Last commit
- 2 days ago
What is it?
τ-Bench (tau2-bench) is a simulation framework for testing how well LLM agents handle customer-service work. Each domain defines a policy the agent must follow, a set of tools it can call, and tasks used to score its performance. The project ships with airline, retail, telecom, banking knowledge retrieval, and entity-capture (intake) domains, plus a mock domain for testing.
The framework covers two modes: turn-based text chat and full-duplex voice conversations using realtime audio APIs from providers such as OpenAI, Gemini and xAI. Language packs localize tasks and data into English, Spanish, Portuguese, Hindi, Chinese and Korean. Runs are launched from the `tau2` command-line tool, and results can be browsed with `tau2 view` and scored with post-run judges.
Key features
- 01Simulates customer-service domains with defined policies, tools and tasks.
- 02Supports text turn-based evaluation and full-duplex voice evaluation.
- 03Includes airline, retail, telecom, banking knowledge and intake domains.
- 04Provides language packs for six languages across text and voice.
- 05Runs through a `tau2` CLI with dry-run planning and result viewing.
Use cases
- Comparing LLM models or agent designs on realistic customer-service tasks.
- Testing whether an agent follows business policies and calls tools correctly.
- Evaluating voice agents for multilingual customer-service calls.
- Building custom agents and domains for reinforcement learning or research experiments.
Quick start
- 1
Clone the repository
git clone https://github.com/sierra-research/tau2-bench - 2
Enter the project folder and install dependencies with uv
cd tau2-bench && uv sync - 3
Create the .env file and add your API keys
cp .env.example .env - 4
Run a small evaluation on the airline domain
tau2 run --domain airline --agent-llm gpt-4.1 --user-llm gpt-4.1 --num-trials 1 --num-tasks 5
Things to know
- Running evaluations requires API keys from paid LLM providers.
- Python 3.12 or newer, below 3.14, is required.
- Voice features need extra system dependencies and voice IDs you must create yourself.
Topics
FAQ
- What is tau2-bench?
- A simulation benchmark for evaluating customer-service AI agents that use tools and talk with simulated users in text and voice. τ-Bench (tau2-bench) is a simulation framework for testing how well LLM agents handle customer-service work. Each domain defines a policy the agent must follow, a set of tools it can call, and tasks used to score its performance. The project ships with airline, retail, telecom, banking knowledge retrieval, and entity-capture (intake) domains, plus a mock domain for testing.
- Is tau2-bench free to use? What license does it have?
- tau2-bench is open source under the MIT license. Check the license terms before using it in commercial products.
- Is tau2-bench still maintained?
- Actively maintained. The last commit to tau2-bench was on Nov 5, 2026.
- What can I use tau2-bench for?
- Comparing LLM models or agent designs on realistic customer-service tasks. Testing whether an agent follows business policies and calls tools correctly. Evaluating voice agents for multilingual customer-service calls. Building custom agents and domains for reinforcement learning or research experiments.
- How do I install tau2-bench?
- Clone the repository: git clone https://github.com/sierra-research/tau2-bench Enter the project folder and install dependencies with uv: cd tau2-bench && uv sync Create the .env file and add your API keys: cp .env.example .env Run a small evaluation on the airline domain: tau2 run --domain airline --agent-llm gpt-4.1 --user-llm gpt-4.1 --num-trials 1 --num-tasks 5
- Where can I get tau2-bench?
- The source code and installation instructions are on GitHub: https://github.com/sierra-research/tau2-bench
Summary generated by AI from the project's README. GitHub stats refresh daily.
Related projects
A Python framework for evaluator-driven agent self-improvement, recording lineage for every candidate agent generation.
Gorilla is an open-source project for training and evaluating LLMs to make accurate function calls and invoke APIs from natural language requests.
An open-source one-stop platform for evaluating large language models across 100+ datasets and many model providers and inference backends.
A benchmark and evaluation harness that tests whether language models can resolve real GitHub issues by generating patches verified in Docker.
An open-source toolkit for running one-command evaluations of large vision-language models across many multimodal benchmarks.