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ção sobre como implementar uso de ferramentas em sua aplicação, consulte Definir ferramentas.



Ferramentas fornecidas pela Anthropic

A Anthropic fornece dois tipos de ferramentas: ferramentas de servidor (server tools) que executam na infraestrutura da Anthropic, e ferramentas de cliente (client tools) onde a Anthropic define o esquema, 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 esquema 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 múltiplas 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 posteriores e text_editor_20250124 é para modelos anteriores. A versão que você usa depende do modelo que você está utilizando.
• 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 é feito no cabeçalho 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 se compõem: você pode definir defer_loading e 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 do 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 um 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 quebra de cache_control, consulte a orientação de cache de prompt da ferramenta de busca de ferramentas.