Dlaczego istnieje tool search?
Każda definicja narzędzia kosztuje tokeny, a duży katalog szkodzi dwa razy. Strona Anthropic o tool search podaje, że typowa konfiguracja z wieloma serwerami (GitHub, Slack, Sentry, Grafana i Splunk) może zużyć około 55 tys. tokenów na definicje, zanim zacznie się jakakolwiek praca, a zdolność Claude do wyboru właściwego narzędzia słabnie powyżej 30 do 50 dostępnych narzędzi (Anthropic, tool search tool, dostęp 19 listopada 2026). Tool search zamienia wybór narzędzia z problemu rozmiaru promptu w problem wyszukiwania. Strona podaje, że zwykle zmniejsza ten narzut o ponad 85 procent, ładując 3 do 5 narzędzi, których żądanie potrzebuje. To jeden z przypadków idei wyszukiwania just-in-time w inżynierii kontekstu.
Jak działa tool search tool?
Dodajesz tool search tool do listy tools, podajesz wszystkie pozostałe definicje narzędzi i ustawiasz defer_loading: true na tych, które nie powinny ładować się z góry. Przynajmniej jedno narzędzie musi pozostać niewstrzymane, zwykle samo narzędzie wyszukiwania. Gdy model czegoś potrzebuje, wyszukuje, API zwraca dopasowania jako bloki tool_reference (domyślnie do 5), rozwija je do pełnych definicji, a model wywołuje narzędzie jak w zwykłym wywoływaniu narzędzi.
| Wariant | Ciąg typu | Jak model zadaje zapytanie |
|---|---|---|
| Regex | tool_search_tool_regex_20251119 |
Wzorzec regex Pythona, do 200 znaków |
| BM25 | tool_search_tool_bm25_20251119 |
Zapytanie w języku naturalnym, do 500 znaków |
| Własny | Twoje narzędzie zwracające bloki tool_reference |
Cokolwiek zbudujesz, na przykład embeddingi |
Oba warianty przeszukują nazwy narzędzi, opisy, nazwy argumentów i opisy argumentów. Żądanie może zawierać do 10 000 narzędzi z odroczonym ładowaniem (Anthropic, dostęp 19 listopada 2026).
Jak tool search działa z MCP?
Narzędzia MCP odracza się na serwer, a nie na definicję. Narzędzia z serwera MCP podłączonego przez łącznik MCP Anthropic odracza się na poziomie serwera, ustawiając defer_loading w domyślnej konfiguracji wpisu mcp_toolset, albo osobno dla narzędzia, zamiast przy każdej definicji (Anthropic, tool search tool, dostęp 19 listopada 2026). Dzięki temu da się podłączyć kilka dużych serwerów bez płacenia za każde narzędzie w każdej turze.
Kiedy używać tool search?
Używaj tool search, gdy katalog narzędzi robi się duży. Wytyczne Anthropic zalecają go przy 10 lub więcej narzędziach, definicjach powyżej 10 tys. tokenów, spadającej trafności wyboru, kilku serwerach MCP lub rosnącym katalogu, a standardowe wywoływanie narzędzi przy mniej niż 10 narzędziach lub malutkich definicjach (Anthropic, tool search tool, dostęp 19 listopada 2026). Trzymaj 3 do 5 najczęściej używanych narzędzi bez odroczenia, by nie wymagały wyszukiwania. Nazywaj narzędzia ze spójnym prefiksem usługi, takim jak github_ lub slack_, żeby jedno wyszukiwanie znajdowało całą grupę, a w opisach umieszczaj słowa kluczowe zadań. Tool search nie jest rozliczany jako osobne narzędzie serwerowe, a ładowane przez niego definicje liczą się jak zwykłe tokeny wejściowe. Odroczone narzędzie nie może jednocześnie mieć cache_control. O wywoływaniu wielu narzędzi z kodu piszemy w haśle programmatic tool calling i w osobnym wpisie (po angielsku).