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

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

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

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

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

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

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

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

• Возможность-ключ: web_search_20260209 и web_fetch_20260209 добавляют динамическую фильтрацию контента по сравнению с их предшественниками. code_execution_20260120 добавляет программное вызывание инструментов из песочницы. В каждом случае обе новая и старая версии являются текущими; какую из них вы используете, зависит от того, нужна ли вам новая возможность.
• Модель-ключ: 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 — это массив, который принимает любую комбинацию:

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

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

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

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

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