Справочник по инструментам

Эта страница представляет собой справочник по инструментам, которые предоставляет Anthropic, и по необязательным свойствам, которые вы можете задать для любого определения инструмента. Концептуальное введение в использование инструментов см. в разделе Использование инструментов с Claude. Руководство по реализации использования инструментов в вашем приложении см. в разделе Определение инструментов.



Инструменты, предоставляемые Anthropic

Anthropic предоставляет два вида инструментов: серверные инструменты, которые выполняются на инфраструктуре Anthropic, и клиентские инструменты, для которых Anthropic определяет схему, но выполнение обрабатывает ваше приложение. Оба вида указываются в массиве tools вашего запроса наряду с любыми пользовательскими инструментами.

Совместимость с моделями см. на странице каждого инструмента. Поддерживаемые модели различаются в зависимости от инструмента и его версии.



Версионирование инструментов

Большинство инструментов, предоставляемых Anthropic, содержат суффикс _YYYYMMDD в строке type. Новая версия выпускается, когда изменяется поведение инструмента, его схема или поддержка моделей. Старые версии остаются доступными, чтобы существующие интеграции продолжали работать.

Когда у инструмента есть несколько активных версий, отношения между ними могут быть разными:

• По возможностям: web_search_20260209 и web_fetch_20260209 добавляют динамическую фильтрацию контента по сравнению с предшественниками; web_fetch_20260309 добавляет опцию обхода кэша; web_search_20260318 и web_fetch_20260318 добавляют управление включением ответа. code_execution_20260120 добавляет программный вызов инструментов изнутри песочницы; code_execution_20260521 раскрывает лимит времени на ячейку в описании инструмента. В каждом случае и новая, и старая версии актуальны; какую из них использовать, зависит от того, нужна ли вам новая возможность.
• По модели: text_editor_20250728 предназначен для моделей Claude 4, а text_editor_20250124 — для более ранних моделей. Используемая версия зависит от целевой модели.
• Вариант, а не версия: tool_search_tool_regex_20251119 и tool_search_tool_bm25_20251119 — это два алгоритма поиска, выпущенные вместе. Ни один из них не заменяет другой.
• Устаревшая: code_execution_20250522 поддерживает только Python. code_execution_20250825 добавляет Bash и операции с файлами.

Тип mcp_toolset не версионируется по дате; версионирование передаётся через заголовок anthropic-beta.



Свойства определения инструмента

Каждый инструмент в массиве tools, включая пользовательские инструменты, принимает необязательные свойства, которые управляют тем, как инструмент загружается, кто может его вызывать и как проверяются его входные данные. Эти свойства комбинируются: вы можете задать defer_loading, cache_control и strict для одного и того же инструмента.



Значения allowed_callers

allowed_callers — это массив, который принимает любую комбинацию из следующих значений:

И "code_execution_20260120", и "code_execution_20260521" принимаются в allowed_callers и взаимозаменяемы: запрос, использующий любую из версий инструмента выполнения кода, удовлетворяет инструментам, в которых указана любая из этих вызывающих сторон. Блоки ответа всегда помечают вызывающую сторону как code_execution_20260120 независимо от того, какая версия была объявлена в запросе.

Исключение "direct" из массива (например, "allowed_callers": ["code_execution_20260120"]) направляет Claude вызывать инструмент только изнутри выполнения кода. Блок tool_use в ответе включает поле caller, которое идентифицирует, какая вызывающая сторона вызвала инструмент. Полное описание, включая структуру ответа caller и поведение при ошибках, см. в разделе Программный вызов инструментов.



defer_loading и кэширование подсказок

Инструменты с defer_loading: true удаляются из отрендеренного раздела инструментов до вычисления ключа кэша. Они вообще не появляются в префиксе системной подсказки. Когда поиск инструментов обнаруживает отложенный инструмент и возвращает для него tool_reference, полное определение инструмента разворачивается непосредственно в этой точке тела разговора, а не в префиксе.

Это означает, что defer_loading: true сохраняет ваш кэш подсказок. Вы можете добавлять отложенные инструменты в запрос, не делая недействительной существующую запись кэша, и кэш остаётся действительным как на ходе, где инструмент обнаружен, так и на ходе, где он вызывается.

О том, как сочетать defer_loading с точками разрыва cache_control, см. в руководстве по кэшированию подсказок для инструмента поиска инструментов.