TemporalBench: A Temporal Reasoning Benchmark
- TemporalBench is a diagnostic multi-domain benchmark that evaluates LLM-based temporal reasoning and forecasting across structured time series tasks.
- It decomposes evaluation into four task tiers (T1–T4), focusing on structural understanding, context-free forecasting, contextual reasoning, and event-conditioned prediction.
- The benchmark leverages real-world datasets from retail, healthcare, energy, and physical systems, providing detailed metrics to expose challenges in temporal and event-aware modeling.
TemporalBench is a diagnostic multi-domain benchmark designed to assess reasoning and forecasting behavior of LLM-based agents in time series tasks under varying degrees of contextual and event-driven complexity. By decomposing temporal prediction and understanding into distinct, progressively information-rich categories, it provides fine-grained evaluation of not only numerical forecasting accuracy but also the agent's qualitative and contextual interpretive abilities (Weng et al., 5 Feb 2026).
1. Formal Definition and Core Objectives
TemporalBench models the evaluation of temporal reasoning in LLM-based agents via a structured, four-tier taxonomy, using notation as follows. For a time series , possibly with associated textual context and event description , an event time is chosen to split the series into historical segment and future segment of horizon . Tasks are defined as:
- ("Historical Structure Interpretation"): Given , output discrete labels for temporal structure—trend, volatility, seasonality, anomaly type.
- 0 ("Context-Free Forecasting"): Given 1, predict 2 (numerical forecast) and qualitative MCQ labels 3 about changes.
- 4 ("Contextual Temporal Reasoning"): Given 5, answer MCQ 6 probing six capabilities: alignment, slicing, difference, lag, structure, interaction.
- 7 ("Event-Conditioned Prediction"): Given 8, predict 9 and MCQ 0 about outcomes under event 1.
This framework allows the formulation: 2
The benchmark's main diagnostic goal is to test whether accurate forecasting (low MAE/sMAPE in 3) necessarily reflects genuine temporal "understanding" in 4, or if systematic weaknesses manifest under contextual/eventually altered regimes.
2. Dataset Construction and Design
TemporalBench comprises four real-world domains:
- Retail (FreshRetailNet-50K): Univariate daily censored sales, sparse promotional events; covariates include discount, holidays, weather, time-of-day.
- Healthcare (MIMIC-IV): Multivariate ICU vitals (heart rate, temperature, SpO5), with physiological and time-of-day covariates.
- Energy (PSML): Dense half-hourly power loads, meteorological covariates.
- Physical Systems (Causal Chambers): System pressures, flows, and currents under mechanical interventions.
Each domain's time series instances are split at 6, selected either by algorithmic event detection (e.g., clinical event logs, change-point detection) or artificial event injection within allowable range. For every instance, all four task families (7–8) are instantiated, yielding:
- 191 series,
- 2,775 MCQ tasks,
- 382 numerical forecasting tasks.
Task counts and average context tokenization are calibrated domain-wise (see data for detailed figures).
3. Task Taxonomy and Evaluation Protocols
Input–Output Specifications:
| Task | Input | Output | Focus |
|---|---|---|---|
| T₁ | 9 | 0: structure class (MCQ) | Structural understanding |
| T₂ | 1 | 2 (numeric), 3 (qualitative MCQ) | Extrapolation |
| T₃ | 4, 5 | 6 (MCQ: C₁–C₆) | Contextual reasoning |
| T₄ | 7, 8, 9 | 0, 1 (event-conditioned MCQ) | Event-driven forecast |
Evaluation Metrics:
- MCQ (T₁, T₃, T₂/T₄ qualitative): Accuracy
2
- Forecasting (T₂, T₄): MAE and sMAPE
3
- MIMIC-IV uses overall weighted versions (OW_sMAPE, OW_RMSSE) to control scale.
4. Global Metrics and Leaderboard
TemporalBench computes both per-domain and global aggregated scores:
- Domain-averaged: 4
- Leaderboard global score: average over normalized scores for each domain and task: normalized accuracy for qualitative, min-max or rank-based normalization for forecasting errors.
All scores and baselines are hosted on a public leaderboard for standardized comparison: TemporalBench Leaderboard.
5. Baseline Agent Results and Error Profiles
Agents evaluated (primarily GPT-4o backbones) include direct single-LLM prompting, TimeSeriesScientist (domain specialist), AgentScope, MetaGPT, and CAMEL (general scaffolding):
| Task | Single LLM | AgentScope/CAMEL | TimeSeriesScientist |
|---|---|---|---|
| T₁ Structural ACC | 63.6% | ~62.5% | 33.5% |
| T₂ Qual. Forecast ACC | 52.3% | 12.1% | 56.8% |
| T₃ Contextual ACC | 2.9–13.6% | 2.9–13.6% | – |
| T₄ Event MCQs ACC | ≤35% | ≤35% | – |
- Forecasting (MAE/sMAPE): Single LLM and AgentScope both achieve 5 MAE and 6 sMAPE on FreshRetailNet, but AgentScope produces highly unstable sMAPE due to extreme errors.
- More than 40% of general agent errors arise from forecast-length violations.
- Numeric predictions can be valid in form yet have very high error (numerical anomalies).
- Agent scaffolding helps reduce format/horizon mistakes but does not remedy deeper contextual failures.
6. Diagnostic Insights Revealed by TemporalBench
- Achieving 7 structural understanding (T₁) is possible, but does not translate to contextual or event-aware reasoning (T₃, T₄), with T₃ rarely exceeding 8 accuracy.
- Numerical forecasting accuracy is often decoupled from interpretation; agents may achieve low MAE yet remain near-random on qualitative MCQs for the same instances.
- Event descriptions 9 provide little gain in qualitative accuracy (improvement 0), indicating deficient integration of exogenous event semantics.
- Input history length has a non-monotonic effect; excessive history can degrade performance.
- Augmenting inputs with classical feature sets (e.g., catch22, simple plots) sometimes helps in structured domains, but offers inconsistent benefit otherwise.
- Pseudo-equation: If 1 but 2 random, then forecasting accuracy does not imply temporal understanding.
7. Data Resources and Reproducibility
Comprehensive resources including datasets (across all domains, events, prompts, and labels), public leaderboard, evaluation scripts, prompt templates, event-injection and label-generation code (with fixed seeds for replicability), are hosted at https://huggingface.co/datasets/Melady/TemporalBench and https://huggingface.co/spaces/Melady/TemporalBench_Leaderboard. Default preprocessing parameters (e.g., event injection probability 3, robust statistics such as median/MAD/IQR) and code versions are provided to ensure transparent, end-to-end reproduction of results across backbones.
TemporalBench thus systematizes the evaluation of temporal reasoning in LLM-based agents, showing that robust forecasting does not equate to genuine temporal or event-conditioned understanding, and highlighting major open challenges concealed by prior forecasting-only assessment paradigms (Weng et al., 5 Feb 2026).