Was ist das Tool Search Tool? Agent-Tools bei Bedarf laden

Agentische AIProtokolle und IntegrationVeröffentlicht Von Simon Budziak

Tool Search lässt ein AI-Modell Tool-Definitionen bei Bedarf abrufen, statt sie alle vorab zu laden. Das Modell durchsucht einen Katalog, erhält nur die wenigen Tools, die es für die Anfrage braucht, und ruft sie auf, was sein Kontextfenster klein hält, wenn Tool-Bibliotheken wachsen.

Jede Tool-Definition kostet Tokens, und ein großer Katalog schadet doppelt. Laut der Tool-Search-Seite von Anthropic kann ein typisches Setup mit mehreren Servern (GitHub, Slack, Sentry, Grafana und Splunk) etwa 55k Tokens an Definitionen verbrauchen, bevor die Arbeit beginnt, und Claudes Fähigkeit, das richtige Tool zu wählen, lässt ab 30 bis 50 verfügbaren Tools nach (Anthropic, Tool Search Tool, abgerufen am 19. November 2026). Tool Search verwandelt die Tool-Auswahl von einem Problem der Prompt-Größe in ein Nachschlageproblem. Die Seite sagt, dass es diesen Overhead typischerweise um über 85 Prozent senkt und die 3 bis 5 Tools lädt, die eine Anfrage braucht. Es ist ein Fall der Just-in-time-Abruf-Idee im Context Engineering.

Wie funktioniert das Tool Search Tool?

Sie fügen der Liste tools ein Tool Search Tool hinzu, liefern alle anderen Tool-Definitionen mit und setzen defer_loading: true bei denen, die nicht vorab geladen werden sollen. Mindestens ein Tool muss nicht zurückgestellt sein, normalerweise das Suchwerkzeug selbst. Braucht das Modell etwas, sucht es, die API gibt Treffer als tool_reference-Blöcke zurück (standardmäßig bis zu 5), erweitert sie zu vollständigen Definitionen, und das Modell ruft das Tool wie beim normalen Tool Calling auf.

Variante Typ-String Wie das Modell abfragt
Regex tool_search_tool_regex_20251119 Ein Python-Regex-Muster, bis zu 200 Zeichen
BM25 tool_search_tool_bm25_20251119 Eine Anfrage in natürlicher Sprache, bis zu 500 Zeichen
Custom Ihr eigenes Tool, das tool_reference-Blöcke zurückgibt Was immer Sie bauen, etwa Embeddings

Beide Varianten durchsuchen Tool-Namen, Beschreibungen, Argumentnamen und Argumentbeschreibungen. Eine Anfrage kann bis zu 10.000 zurückgestellte Tools tragen (Anthropic, abgerufen am 19. November 2026).

Wie arbeitet Tool Search mit MCP zusammen?

MCP-Tools werden pro Server zurückgestellt, nicht pro Definition. Tools von einem MCP-Server, der über Anthropics MCP-Connector angebunden ist, werden auf Serverebene zurückgestellt, indem defer_loading in der Standardkonfiguration des mcp_toolset-Eintrags gesetzt wird, oder pro Tool, statt an jeder Definition (Anthropic, Tool Search Tool, abgerufen am 19. November 2026). So lassen sich mehrere große Server anbinden, ohne in jeder Runde für jedes Tool zu zahlen.

Wann sollten Sie Tool Search einsetzen?

Setzen Sie Tool Search ein, sobald ein Tool-Katalog groß wird. Anthropics Leitfaden empfiehlt es ab 10 Tools, bei Definitionen über 10k Tokens, nachlassender Auswahlgenauigkeit, mehreren MCP-Servern oder einem Katalog, der weiter wächst, und rät bei unter 10 Tools oder winzigen Definitionen zum normalen Tool Calling (Anthropic, Tool Search Tool, abgerufen am 19. November 2026). Lassen Sie Ihre 3 bis 5 meistgenutzten Tools nicht zurückgestellt, damit sie keine Suche brauchen. Benennen Sie Tools mit einheitlichem Präfix pro Dienst, etwa github_ oder slack_, damit eine Suche die Gruppe findet, und setzen Sie Aufgaben-Stichwörter in die Beschreibungen. Tool Search wird nicht als eigenes Server-Tool abgerechnet, und die Definitionen, die es lädt, zählen als gewöhnliche Input-Tokens. Ein zurückgestelltes Tool kann nicht zugleich cache_control tragen. Zum Aufruf vieler Tools aus Code siehe Programmatic Tool Calling und den Beitrag dazu (auf Englisch).

Dieser Eintrag wurde mit AI-Unterstützung verfasst.

Häufig gestellte Fragen

Sende ich mit Tool Search weiterhin jede Tool-Definition mit?

Ja. Sie senden bei jeder Anfrage alle Definitionen und markieren die meisten mit defer_loading. Die API braucht sie serverseitig, um die Suche auszuführen, und nur die, die Claude findet, gelangen in seinen Kontext.

Wann lohnt sich Tool Search nicht?

Bei weniger als 10 Tools, wenn jedes Tool bei jeder Anfrage genutzt wird oder wenn die Definitionen winzig sind. Anthropics Leitfaden nennt diese Fälle als besser durch normales Tool Calling bedient.

Diese Seite zusammenfassen mit

So läuft es in einem System, das wir gebaut haben