Source-linked AI summary
StableToolBench: Towards Stable Large-Scale Benchmarking on Tool Learning of Large Language Models
Zhicheng Guo, Sijie Cheng, Hao Wang, Shihao Liang, Yujia Qin, Peng Li, Zhiyuan Liu, Maosong Sun, Yang Liu
TL;DR
Tool-learning benchmarks need large scale without sacrificing stability, but online APIs and automatic evaluation can vary over time. StableToolBench combines cached and LLM-simulated APIs with solvability-aware metrics and GPT-4 evaluation. The resulting benchmark provides more stable performance assessments while retaining API realism and diversity, although its GPT-4 dependence increases cost and creates upgrade sensitivity.
Problem
Large-scale online-tool benchmarks improve real-world coverage but suffer from unstable API availability and unreliable automatic evaluation, weakening reproducibility and comparability.
Source: §1 · p. 1Method
StableToolBench combines cached API outputs, LLM-based API simulation, solvability-aware pass and win rates, and GPT-4 automatic evaluation.
Source: §1 · p. 2Results
Takeaways & Limitations
StableToolBench offers a more reproducible large-scale basis for evaluating tool-learning models across changing API conditions.
Source: §1 · p. 2, §6 · p. 9The benchmark depends on GPT-4 for evaluation and API simulation, increasing cost and making performance sensitive to future backbone upgrades.
Source: Limitations · p. 9
Abstract
from arXiv · showhide
Large Language Models (LLMs) have witnessed remarkable advancements in recent years, prompting the exploration of tool learning, which integrates LLMs with external tools to address diverse real-world challenges. Assessing the capability of LLMs to utilise tools necessitates large-scale and stable benchmarks. However, previous works relied on either hand-crafted online tools with limited scale, or large-scale real online APIs suffering from instability of API status. To address this problem, we introduce StableToolBench, a benchmark evolving from ToolBench, proposing a virtual API server and stable evaluation system. The virtual API server contains a caching system and API simulators which are complementary to alleviate the change in API status. Meanwhile, the stable evaluation system designs solvable pass and win rates using GPT-4 as the automatic evaluator to eliminate the randomness during evaluation. Experimental results demonstrate the stability of StableToolBench, and further discuss the effectiveness of API simulators, the caching system, and the evaluator system.
1 Introduction
Large-scale tool-learning benchmarks improve real-world coverage but face unstable APIs and unreliable evaluation, undermining reproducibility. StableToolBench addresses these issues with cached and simulated APIs, a revised evaluator, and stable evaluation metrics.
Motivation
- Large-scale online-tool benchmarks better reflect real-world scenarios but can produce non-reproducible and incomparable results as APIs change over time.ToolBench is cited as an example whose performance discrepancies could not be reproduced months after release.Source: §1 · p. 1
- ToolBench instability arises from changing API availability and evaluators that may misjudge whether complex tool-use tasks are solvable.The paper specifically identifies inconsistent API status and limitations of gpt-3.5 as key sources of variability.Source: §1 · pp. 1–2
StableToolBench
- StableToolBench replaces real APIs with a virtual system that first retrieves cached outputs and otherwise uses LLMs to simulate unavailable API behavior from documentation and examples.The cache covers repeated API-call scenarios, while simulation handles cache misses and unavailable real APIs.Source: §1 · p. 2
- The benchmark redesigns evaluation with solvable pass and win rates and uses GPT-4 instead of prior automatic evaluators to reduce evaluation randomness.The revised virtual API and evaluation systems are intended to provide stable assessments despite API modifications.Source: §1 · p. 2
Empirical findings
- Extensive experiments report more stable model performance under API failures while retaining realism, diversity, and documentation-following reliability comparable to real APIs.The contribution summary characterizes the benchmark as balancing stable simulated APIs with API reality and broader evaluation stability.Source: §1 · p. 2
2 Stability Analysis on ToolBench
ToolBench stability is assessed across performance, evaluation, and API status, revealing substantial variation in all three dimensions.
2.1 Stability of Performance
- ToolBench performance declined over time across all tested methods, raising concerns about benchmark stability.The study reproduces reported settings with ChatGPT and ToolLLaMA using CoT and DFS strategies.Source: §2.1 · pp. 2–3
2.2 Stability of Evaluation
- The original Pass Rate and Win Rate procedures produce inconsistent results because gpt-3.5-turbo-16k struggles to judge tool-learning answers reliably.Across repeated CoT and DFS runs, Pass Rate and Win Rate trends diverge, with DFS’s second Win Rate reaching 48.0.Source: §2.2 · p. 3
2.3 Stability of API Status
- Only 44.4% of scanned ToolBench API calls succeeded, while the remainder were mostly unavailable or unauthorised.The API-status analysis classifies calls as successful, unavailable, or unauthorised and reports varied unavailability errors.Source: §2.3 · p. 3, Figure 3 · p. 3
- Reducing the proportion of successful APIs substantially degraded model performance, demonstrating that API failures materially affect benchmark stability.Experiments tested 0%, 10%, 20%, and 50% sampled API failures on the I1 Instruction set using repeated evaluations.Source: §2.3 · p. 4, Figure 4 · p. 4
3 StableToolBench
StableToolBench improves benchmark stability through a virtual API server and a two-phase evaluation system. The server combines caching with API simulation, while evaluation isolates solvable tasks and uses GPT-4-based metrics.
3 StableToolBench
- StableToolBench combines a virtual API server with a stable evaluation system to improve tool-learning benchmark stability.Source: §3 · p. 4
3.1 Virtual API Server
- The caching system stores validated API-call responses keyed by category, tool, API name, and arguments, while continuously updating with new experiments.Source: §3.1 · p. 4
- The API simulator uses gpt-4-turbo, documentation, and up to five cached real API calls as few-shot examples to mock unavailable APIs.Source: §3.1 · p. 4
- The virtual API server first uses cached responses, then real APIs, and finally simulated APIs, saving returned responses back into the cache.Source: §3.1 · p. 5
3.2 Stable Evaluation System
- The stable evaluator judges solvable tasks with three LLMs, then reports SoPR and SoWR using gpt-4-turbo instead of gpt-3.5-turbo-16k.SoPR assigns scores of 1, 0.5, and 0 to solved, unsure, and unsolved answers; SoWR directly resolves mixed outcomes and otherwise uses GPT-4 comparisons.Source: §3.2 · p. 5
4 Experiment
Experiments evaluate baseline performance, server stability, simulator realism and diversity, cache effectiveness, and evaluator quality. Across these tests, the proposed system remains stable while simulated APIs and GPT-4-based evaluation perform reliably.
4.1 Performance
- GPT-4-series models outperform GPT-3.5 models, while DFS outperforms CoT across the tested LLMs under SoPR and SoWR.Source: §4.1 · p. 6
4.2 Stability of Virtual API Server
- With 50% of APIs unavailable, performance changes remain insignificant within variance when unavailable calls are redirected to simulated APIs.Source: §4.2 · p. 6, Figure 7 · p. 6
- Changing gpt-4-turbo simulator versions and temperatures produces performance changes within evaluation variance, indicating robust API simulators.Source: §4.2 · p. 6, Table 6 · p. 7
4.3 Turing Test of API Simulator
- Human annotators cannot distinguish simulated from real API responses well, and simulated APIs are judged to behave more like real situations.The comparison covers overall realism, format accuracy, and answer relevance across 70 API pairs.Source: §4.3 · p. 7, Figure 8 · p. 7
- 90% of sampled simulated outputs are judged reasonable against their documentation, while 6% are unreasonable and 4% uncertain.Source: §4.3 · p. 7
4.4 Diversity of API Simulator
- Real and simulated API responses occupy similar embedding space, and only 2 of 60 APIs repeat exactly across two of five calls.Source: §4.4 · pp. 7–8, Figure 9 · p. 8
4.5 Effectiveness of Caching System
- The cache achieves very high hit rates for in-domain methods and still mitigates instability substantially for newer out-of-domain methods.Source: §4.5 · p. 8, Table 7 · p. 8
4.6 Human Evaluation of Evaluator
- Claude 2, Gemini, and GPT-4 outperform GPT-3.5 in solvability judgments, while GPT-4 is substantially better for answer evaluation and win-rate comparison.All GPT-3.5 evaluator accuracies are below 70%.Source: §4.6 · p. 8
5 Related Work
Related work covers tool-learning benchmarks, methods for integrating tools with LLMs, and evaluation strategies. The paper positions StableToolBench around the underexplored problem of evaluation stability.
Tool Learning Benchmarks
- Tool-learning research studies LLM access to external tools for real-time knowledge, multimodal functions, and specialized domain skills, but rarely examines benchmark-environment stability.Source: §5 · p. 8
Tool Inference Methods
- Tool inference methods use in-context tool descriptions and demonstrations or explicitly train LLMs on tool-interaction datasets.Source: §5 · pp. 8–9
Evaluation in Tool Learning
- Tool-learning evaluation commonly measures response comparison, tool-call accuracy, solution paths, or multi-turn interaction, while evaluation stability remains a literature gap.Source: §5 · p. 9, Table 8 · p. 9
6 Conclusion
StableToolBench improves the stability of model-performance evaluation while retaining realism in its simulated APIs. Its caching system contributes substantially to the benchmark’s enhanced stability.
6 Conclusion
- StableToolBench increases benchmark stability without declining reality, with simulated APIs offering realism and caching contributing greatly to enhanced stability.Source: §6 · p. 9
Limitations
StableToolBench improves evaluation stability but depends on costly, potentially changing closed-source GPT-4 components and a cache whose future effectiveness is uncertain.
- GPT-4 is used both as the automatic evaluator and backbone server, increasing benchmark usage cost.Source: Limitations · p. 9
- Future upgrades to the GPT-4 backbone may change API-simulation performance, while current open-source models are not yet capable enough for this role.Source: Limitations · p. 9
- Although explored methods achieve high cache hit rates, future methods may reduce the cache’s effectiveness, motivating gradual cache updates.Source: Limitations · p. 9
A Comparison of Reported and Reproduced Performance
The supplementary material documents reproduced-versus-reported performance, API availability changes, and stability tests using virtual API systems across model versions.
A Comparison of Reported and Reproduced Performance
- Table 9 compares reported and reproduced Pass Rate scores for ChatGPT and ToolLLaMA v2 on ToolBench’s I1-Instruction group.Source: Table 9 · p. 12, A Comparison of Reported and… · p. 12
B Statistics of API change information
- Tables 10 and 11 provide statistics on changed APIs and categories of ToolBench API non-availability.Source: Table 10 · p. 12, Table 11 · p. 12, B Statistics of API change information · p. 12
C Stability Test Scores with Virtual API Systems
- Table 12 presents detailed scores from stability tests of various models, including GPT 3.5 Turbo 0613, GPT 4 0613, GPT 3.5 Turbo 1106, and GPT 4 Turbo Preview.Source: C Stability Test Scores with Virtual… · p. 12
D Call Error Identification and Cache Filtering Rule
The cache-filtering procedure identifies API-call errors using response and error-message patterns, then treats remaining calls as successful while excluding “Other Errors” from cache filtering.
- API calls are classified into connection, not-found, parameter-change, parsing, authorization, other-error, and success categories using keyword and response patterns.Source: D Call Error Identification and Cache… · p. 12
- “Other Errors” comprise calls with non-empty error messages, whereas success is assigned to other calls.Source: D Call Error Identification and Cache… · p. 12
- The procedure considers all error types during identification but excludes “Other Errors” when filtering the cache.Source: D Call Error Identification and Cache… · p. 12
E Configurations of API Diversity Analysis
The supplementary configurations specify the embedding and UMAP settings for API diversity analysis, while a separate table provides the prompt used for API simulation.
E Configurations of API Diversity Analysis
- API diversity analysis uses the all-mpnet-base-v2 embedding model and correlation as the UMAP distance metric.Source: E Configurations of API Diversity… · pp. 12–13
F Prompts of API simulation
- Table 13 presents the prompt used to simulate API behaviours.Source: Table 13 · p. 13, F Prompts of API simulation · p. 13
E Configurations of API Diversity Analysis
- The UMAP configuration uses 15 neighbors and a minimum distance of 0.5.Source: E Configurations of API Diversity… · p. 13
G Prompt to Filter Solvable Task
This appendix identifies the prompts used to filter solvable tasks and to construct API calls for scanning available tools, with the prompts presented in Tables 14 and 15.
G Prompt to Filter Solvable Task
- The prompt for filtering solvable tasks is presented in Table 14.Source: G Prompt to Filter Solvable Task · p. 13, Table 14 · p. 14
- The appendix associates the solvable-task filtering prompt with Table 14.Source: G Prompt to Filter Solvable Task · p. 13, Table 14 · p. 14
H Prompt Used to Make API Calls
- The prompt used to construct API calls for scanning available tools is presented in Table 15.Source: H Prompt Used to Make API Calls · p. 13, Table 15 · p. 14
- The appendix associates API-call construction with Table 15.Source: H Prompt Used to Make API Calls · p. 13, Table 15 · p. 14
G Prompt to Filter Solvable Task
- Table 14 is labeled as the prompt used to filter solvable tasks.Source: Table 14 · p. 14
H Prompt Used to Make API Calls
- Table 15 is labeled as the prompt used to write API calls.Source: Table 15 · p. 14
Related papers
This paper cites
- Language Models are Few-Shot Learners2020
- LLaMA: Open and Efficient Foundation Language Models2023
- Gemini: A Family of Highly Capable Multimodal Models2023
- ToolLLM: Facilitating Large Language Models to Master 16000+ Real-world APIs2023
- Gorilla: Large Language Model Connected with Massive APIs2023
- MINT: Evaluating LLMs in Multi-turn Interaction with Tools and Language Feedback2023
Cited by
- Locating and Closing Information Gaps in Multi-Agent Systems2026
- ProbeID: Verifying MCP Tool Identity for LLM Agents under Registry Drift2026
- Separate Field Scoring Protects Unused Tools When Agents Pool Tool-Use Experience2026
- From Single-Actor Environments to Multi-Actor Event Worlds: Can LLMs Be Event World Models?2026
- ToolBottleneckBench: Measuring Tool-Agent Performance under Controlled Pressures and Fixed Harness Budgets2026
- Nudge the Judge: Uncovering Program Decision Hijacking in Real-World Jev Applications2026