---
term: "Tool Call Failure"
slug: "tool-call-failure"
glossar_id: "G353"
variants: []
category: "fehlverhalten-zuverlaessigkeit-und-menschliche-wahrnehmung"
marker: ""
short: "Expliziter Fehler eines Werkzeugaufrufs, etwa Timeout oder ungültige Eingabe."
sources:
  - label: "Anthropic: Handle tool calls"
    url: "https://platform.claude.com/docs/en/agents-and-tools/tool-use/handle-tool-calls"
  - label: "Model Context Protocol: Tools"
    url: "https://modelcontextprotocol.io/specification/2025-06-18/server/tools"
status: "entwurf"
updated: "2026-09-21"
---

Ein Tool Call Failure ist ein Werkzeugaufruf, der mit einem Fehler endet: Zeitüberschreitung, ungültige Eingabe, fehlende Berechtigung, nicht erreichbarer Dienst. Anders als bei der falschen Werkzeugwahl gibt es hier eine Meldung, mit der sich arbeiten lässt.

## Der Fehler gehört zurück in das Gespräch

Der übliche Umgang ist, die Fehlermeldung als Ergebnis zurückzugeben und sie als Fehler zu kennzeichnen. Das Modell kann dann einen anderen Weg versuchen oder dem Nutzer erklären, was nicht ging. Empfohlen werden Meldungen, die den nächsten Schritt nahelegen, etwa ein Hinweis auf ein Limit mit Wartezeit statt eines schlichten „failed". [Anthropic: Handle tool calls](https://platform.claude.com/docs/en/agents-and-tools/tool-use/handle-tool-calls)

Auch Protokolle für angebundene Werkzeuge trennen zwei Ebenen: Fehler des Protokolls, etwa ein unbekanntes Werkzeug, und Fehler bei der Ausführung, die im Ergebnis als Fehler markiert werden. [Model Context Protocol: Tools](https://modelcontextprotocol.io/specification/2025-06-18/server/tools)

## So kannst du dir das vorstellen

Ein Anruf, bei dem besetzt ist. Man weiß, dass es nicht geklappt hat, und kann es später erneut versuchen oder einen anderen Weg nehmen. Unangenehm ist nicht das Besetztzeichen, sondern eine Leitung, die stumm bleibt. Das Bild erklärt den Wert einer klaren Rückmeldung.

## Was es in der Praxis bedeutet

Zwei Dinge verhindern die meisten Folgeprobleme. Erstens aussagekräftige Fehlermeldungen: Der Agent kann nur darauf reagieren, was er liest. Zweitens eine Grenze für Wiederholungen, denn sonst versucht er es beharrlich weiter und verbraucht Budget.

Für den Betrieb lohnt es sich, Fehlerquoten je Werkzeug zu zählen. Ein Werkzeug, das regelmäßig in Zeitüberschreitungen läuft, macht den Agenten unzuverlässig, und das sieht man in der Endantwort nicht.

## Wo es verwechselt wird

Ein fehlgeschlagener Aufruf ist kein Modellfehler: Meist liegt es am angebundenen System. Und die Fehlermeldung ist kein Abbruch, sondern ein Ergebnis, mit dem die Schleife weiterläuft.

## Verwandte Begriffe

**Tool Misuse**, **Tool Result**, **Agent Loop**, **Behavioral Failure**, **Termination Condition**.