Referência de ferramentas

Esta página é uma referência para as ferramentas que a Anthropic fornece e as propriedades opcionais que você pode definir em qualquer definição de ferramenta. Para uma introdução conceitual ao uso de ferramentas, consulte Uso de ferramentas com Claude. Para orientações sobre como implementar o uso de ferramentas em sua aplicação, consulte Definir ferramentas.



Ferramentas fornecidas pela Anthropic

A Anthropic fornece dois tipos de ferramentas: ferramentas de servidor que são executadas na infraestrutura da Anthropic, e ferramentas de cliente em que a Anthropic define o schema, mas sua aplicação lida com a execução. Ambos os tipos aparecem no array tools da sua requisição junto com quaisquer ferramentas definidas pelo usuário.

Para compatibilidade de modelos, consulte a página de cada ferramenta. Os modelos suportados variam por ferramenta e por versão da ferramenta.



Versionamento de ferramentas

A maioria das ferramentas fornecidas pela Anthropic carrega um sufixo _YYYYMMDD na string type. Uma nova versão é lançada quando o comportamento, o schema ou o suporte a modelos da ferramenta muda. Versões mais antigas permanecem disponíveis para que integrações existentes continuem funcionando.

Quando uma ferramenta tem várias versões ativas, a relação entre elas varia:

• Baseada em capacidade: web_search_20260209 e web_fetch_20260209 adicionam filtragem dinâmica de conteúdo em relação às suas predecessoras; web_fetch_20260309 adiciona uma opção de bypass de cache; web_search_20260318 e web_fetch_20260318 adicionam controle de inclusão de resposta. code_execution_20260120 adiciona chamada programática de ferramentas de dentro do sandbox; code_execution_20260521 divulga o limite de tempo por célula na descrição da ferramenta. Em cada caso, tanto a versão nova quanto a antiga são atuais; qual delas você usa depende de você precisar ou não da nova capacidade.
• Baseada em modelo: text_editor_20250728 é para modelos Claude 4 e text_editor_20250124 é para modelos anteriores. A versão que você usa depende do modelo que você está usando como alvo.
• Variante, não versão: tool_search_tool_regex_20251119 e tool_search_tool_bm25_20251119 são dois algoritmos de busca lançados juntos. Nenhum substitui o outro.
• Legado: code_execution_20250522 suporta apenas Python. code_execution_20250825 adiciona Bash e operações de arquivo.

O tipo mcp_toolset não é versionado por data; o versionamento é carregado no header anthropic-beta.



Propriedades de definição de ferramentas

Toda ferramenta no array tools, incluindo ferramentas definidas pelo usuário, aceita propriedades opcionais que controlam como a ferramenta é carregada, quem pode chamá-la e como suas entradas são validadas. Essas propriedades são combináveis: você pode definir defer_loading, cache_control e strict na mesma ferramenta.



Valores de allowed_callers

allowed_callers é um array que aceita qualquer combinação de:

Tanto "code_execution_20260120" quanto "code_execution_20260521" são aceitos em allowed_callers e são intercambiáveis: uma requisição usando qualquer uma das versões da ferramenta de execução de código satisfaz ferramentas que listam qualquer um dos chamadores. Os blocos de resposta sempre marcam o chamador como code_execution_20260120, independentemente de qual versão a requisição declarou.

Omitir "direct" do array (por exemplo, "allowed_callers": ["code_execution_20260120"]) orienta Claude a chamar a ferramenta apenas de dentro da execução de código. O bloco tool_use da resposta inclui um campo caller que identifica qual chamador chamou a ferramenta. Consulte Chamada programática de ferramentas para o tratamento completo, incluindo o formato de resposta de caller e o comportamento de erro.



defer_loading e cache de prompt

Ferramentas com defer_loading: true são removidas da seção de ferramentas renderizada antes que a chave de cache seja computada. Elas não aparecem no prefixo do prompt do sistema de forma alguma. Quando a busca de ferramentas descobre uma ferramenta adiada e retorna uma tool_reference para ela, a definição completa da ferramenta é expandida inline naquele ponto do corpo da conversa, não no prefixo.

Isso significa que defer_loading: true preserva seu cache de prompt. Você pode adicionar ferramentas adiadas a uma requisição sem invalidar uma entrada de cache existente, e o cache permanece válido ao longo do turno em que a ferramenta é descoberta e do turno em que ela é chamada.

Para saber como combinar defer_loading com pontos de interrupção de cache_control, consulte a orientação de cache de prompt da ferramenta de busca de ferramentas.