Tool search tool: ładowanie narzędzi agenta na żądanie

Agentowa AIProtokoły i integracjeOpublikowano Autor: Simon Budziak

Tool search pozwala modelowi AI pobierać definicje narzędzi na żądanie, zamiast ładować wszystkie z góry. Model przeszukuje katalog, dostaje tylko kilka narzędzi potrzebnych do żądania i je wywołuje, dzięki czemu jego okno kontekstu pozostaje małe, gdy biblioteki narzędzi rosną.

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.

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).

To hasło przygotowano z pomocą AI.

Najczęściej zadawane pytania

Czy z tool search nadal wysyłam każdą definicję narzędzia?

Tak. Wysyłasz wszystkie definicje w każdym żądaniu, oznaczając większość flagą defer_loading. API potrzebuje ich po stronie serwera, by przeprowadzić wyszukiwanie, a do kontekstu Claude trafiają tylko te, które odkryje.

Kiedy tool search się nie opłaca?

Przy mniej niż 10 narzędziach, gdy każde narzędzie jest używane w każdym żądaniu albo gdy definicje są malutkie. Wytyczne Anthropic wskazują te przypadki jako lepiej obsłużone standardowym wywoływaniem narzędzi.

Podsumuj tę stronę w

Zobacz, jak to działa w systemie, który zbudowaliśmy