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 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 onde a Anthropic define o esquema, mas sua aplicação lida com a execução. Ambos os tipos aparecem no array tools da sua solicitação junto com qualquer ferramenta definida 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, esquema ou suporte de modelo da ferramenta muda. Versões mais antigas permanecem disponíveis para que as integrações existentes continuem funcionando.

Quando uma ferramenta tem múltiplas versões ativas, o relacionamento entre elas varia:

• Baseado em capacidade: web_search_20260209 e web_fetch_20260209 adicionam filtragem de conteúdo dinâmico sobre seus predecessores. code_execution_20260120 adiciona chamada de ferramenta programática de dentro da sandbox. Em cada caso, tanto a versão nova quanto a antiga são atuais; qual você usa depende se você precisa da nova capacidade.
• Baseado 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á direcionando.
• 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 cabeçalho anthropic-beta em vez disso.

Propriedades de definição de ferramenta

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:

Omitir "direct" do array (por exemplo, "allowed_callers": ["code_execution_20260120"]) significa que a ferramenta é chamável 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 de ferramenta programática para o tratamento completo, incluindo a forma de resposta caller e comportamento de erro.

defer_loading e cache de prompt

Ferramentas com defer_loading: true são removidas da seção de ferramentas renderizadas antes da chave de cache ser computada. Elas não aparecem no prefixo do prompt do sistema. 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 no 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 solicitação sem invalidar uma entrada de cache existente, e o cache permanece válido através da volta onde a ferramenta é descoberta e a volta onde é chamada.

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