Warum gibt es Tool Search?
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).