Referência de ferramentas
Diretório de ferramentas de servidor, ferramentas de cliente e conjuntos de ferramentas de cliente fornecidos pela Anthropic, além de referência para propriedades opcionais de definição 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 “tool use” (uso de ferramentas), consulte Uso de ferramentas com Claude. Para orientação sobre como implementar o uso de ferramentas na 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 cuida da execução. Ambos os tipos aparecem no array tools da sua requisição junto com quaisquer ferramentas definidas pelo usuário.
| Ferramenta | type | Execução | Cabeçalho beta |
|---|---|---|---|
| Ferramenta de pesquisa na web | web_search_20260318web_search_20260209web_search_20250305 | Servidor | Nenhum |
| Ferramenta web fetch | web_fetch_20260318web_fetch_20260309web_fetch_20260209web_fetch_20250910 | Servidor | Nenhum |
| Ferramenta de execução de código | code_execution_20260521code_execution_20260120code_execution_20250825 | Servidor | Nenhum |
| Ferramenta advisor | advisor_20260301 | Servidor | advisor-tool-2026-03-01 |
| Ferramenta de busca de ferramentas | tool_search_tool_regex_20251119tool_search_tool_bm25_20251119 | Servidor | Nenhum |
| Conector MCP | mcp_toolset | Servidor | mcp-client-2025-11-20 |
| Ferramenta de memória | memory_20250818 | Cliente | Nenhum |
| Ferramenta bash | bash_20250124 | Cliente | Nenhum |
| Ferramenta de editor de texto | text_editor_20250728text_editor_20250124 | Cliente | Nenhum |
| Ferramenta de uso de computador | computer_toolset_20260801computer_20251124computer_20250124 | Cliente | Nenhumcomputer-use-2025-11-24computer-use-2025-01-24 |
| Ferramenta de uso de navegador | browser_toolset_20260801 | Cliente | Nenhum |
Para compatibilidade de modelos, consulte a página de cada ferramenta. Os modelos suportados variam por ferramenta e por versão da ferramenta. Para verificar a partir do seu código se um modelo aceita pesquisa na web ou execução de código, consulte Usando a Models API.
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:
- Por capacidade:
web_search_20260209eweb_fetch_20260209adicionam filtragem dinâmica de conteúdo em relação às suas predecessoras;web_fetch_20260309adiciona uma opção para ignorar o cache;web_search_20260318eweb_fetch_20260318adicionam controle de inclusão na resposta.code_execution_20260120adiciona chamada programática de ferramentas de dentro do sandbox;code_execution_20260521informa 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. - Por modelo:
text_editor_20250728é para modelos Claude 4 e posteriores, etext_editor_20250124é para modelos anteriores. A versão que você usa depende do modelo que você tem como alvo. - Variante, não versão:
tool_search_tool_regex_20251119etool_search_tool_bm25_20251119são dois algoritmos de busca lançados juntos. Nenhum substitui o outro. - Legado:
code_execution_20250522suporta apenas Python.code_execution_20250825adiciona Bash e operações de arquivo. - Sucessora:
computer_toolset_20260801é a sucessora estável das versões betacomputer_20251124ecomputer_20250124, que estão disponíveis nos modelos listados para elas em Versões anteriores da ferramenta.browser_toolset_20260801é a primeira versão da ferramenta de uso de navegador. Ambas são conjuntos de ferramentas de cliente.
O tipo mcp_toolset não é versionado por data; o versionamento é carregado no cabeçalho anthropic-beta.
Conjuntos de ferramentas de cliente
A ferramenta de uso do computador e a ferramenta de uso do navegador são conjuntos de ferramentas de cliente definidos pela Anthropic: uma entrada em tools declara um conjunto fixo de ferramentas membro cujos nomes, descrições e schemas de entrada são definidos pela Anthropic, e sua aplicação executa todas as chamadas. A entrada não recebe name, porque o type datado fixa os nomes dos membros. configs, cache_control e allowed_callers (que aceita apenas ["direct"]) são opcionais.
Conjuntos de ferramentas de cliente são ferramentas da Messages API. Atualmente, eles não estão disponíveis como ferramentas de agente no Claude Managed Agents, que fornece seu próprio conjunto de ferramentas de agente integrado, conjuntos de ferramentas MCP e ferramentas personalizadas.
{
"type": "browser_toolset_20260801",
"configs": {
"javascript_exec": { "enabled": true }
},
"cache_control": { "type": "ephemeral" }
}configs ajusta membros individuais:
- As chaves são nomes de membros, e cada valor aceita apenas
enablededefer_loading. - Um membro que você omite mantém seus padrões. Um valor ausente,
{}e um padrão reafirmado são equivalentes. - Um nome de membro desconhecido ou qualquer outro campo no valor de um membro é rejeitado, assim como um
configsque desabilita todos os membros (omita a entrada em vez disso). - Um membro desativado é removido das ferramentas que Claude recebe. Se Claude ainda assim o nomear, retorne um
tool_resultde erro.
Defina defer_loading para cada membro, nunca na entrada, e dê a todos os membros ativados o mesmo valor: na busca de ferramentas, o conjunto de ferramentas é carregado e expandido como uma única definição. Quando todos os membros ativados são adiados, apenas uma ferramenta de busca de ferramentas que não seja ela própria adiada pode revelar o conjunto de ferramentas, portanto declare uma na mesma requisição. Não coloque cache_control em uma entrada de conjunto de ferramentas cujos membros são adiados; defina o breakpoint em uma ferramenta não adiada, porque definições adiadas não fazem parte do prefixo em cache.
cache_control vai apenas na entrada; para saber onde o ponto de interrupção é posicionado, incluindo marcadores dentro de uma ação em lote, consulte Uso de ferramentas com cache de prompt.
Lide com chamadas de ferramentas membro. Claude chama um membro com um bloco tool_use cujo name é o nome do membro e cujo toolset_name é computer ou browser; input contém os parâmetros desse membro e nenhum campo action. Faça o despacho com base no par toolset_name e name, porque uma ferramenta personalizada pode compartilhar o nome de um membro e os dois conjuntos de ferramentas compartilham nomes como screenshot. Apenas os resultados de membros repetem toolset_name. Várias chamadas de membros em um único turno formam uma ação em lote que você executa em ordem (uso do computador, uso do navegador). Novos membros chegam apenas com um novo type datado.
Não suportado em entradas de conjunto de ferramentas. A API rejeita cada um destes com um invalid_request_error:
strict: trueouinput_examples.defer_loadingna entrada, ou membros ativados cujos valores dedefer_loadingdiferem (defina-o para cada membro emconfigs, todos com o mesmo valor).- Um chamador de execução de código em
allowed_callers(sem chamada programática de ferramentas). - O cabeçalho beta
fine-grained-tool-streaming-2025-05-14. Quando você usa streaming, oinputde cada membro chega como um únicoinput_json_deltacompleto. - Um
tool_choicedo tipotoolque nomeia o conjunto de ferramentas ou um membro (useauto,anyounone). - Duas entradas do mesmo conjunto de ferramentas, ou outra ferramenta que carregue o nome daquele conjunto de ferramentas: uma ferramenta chamada
computerjunto comcomputer_toolset_20260801, ou uma ferramenta chamadabrowserjunto combrowser_toolset_20260801. Os dois conjuntos de ferramentas podem ser declarados juntos.
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. Você pode combinar essas propriedades, com duas exceções: uma ferramenta com defer_loading: true não pode também ter cache_control, e uma ferramenta definida pelo usuário com strict: true não pode listar um chamador de execução de código em allowed_callers.
| Propriedade | Finalidade | Disponível em | Guia detalhado |
|---|---|---|---|
cache_control | Define um breakpoint de cache de prompt nesta definição de ferramenta | Todas as ferramentas (em computer_toolset_20260801 e browser_toolset_20260801, defina-o na própria entrada do conjunto de ferramentas, não dentro dos configs dos membros) | Cache de prompt |
strict | Garante a validação de schema em nomes e entradas de ferramentas | Todas as ferramentas, exceto mcp_toolset, computer_toolset_20260801 e browser_toolset_20260801 | Uso estrito de ferramentas |
defer_loading | Exclui a ferramenta do prompt do sistema inicial; carrega-a sob demanda quando a busca de ferramentas retorna um tool_reference para ela | Todas as ferramentas (para mcp_toolset, consulte configuração do conjunto de ferramentas MCP). Nos conjuntos de ferramentas de uso do computador e de uso do navegador, defina-o por membro dentro de configs; consulte Conjuntos de ferramentas de cliente. | Ferramenta de busca de ferramentas |
allowed_callers | Restringe quais chamadores podem chamar a ferramenta | Todas as ferramentas, exceto mcp_toolset (em computer_toolset_20260801 e browser_toolset_20260801, apenas ["direct"] é aceito; consulte Conjuntos de ferramentas de cliente) | Chamada programática de ferramentas |
input_examples | Fornece objetos de entrada de exemplo para mostrar a Claude como chamar a ferramenta | Ferramentas definidas pelo usuário e ferramentas de cliente com schema da Anthropic, exceto computer_toolset_20260801 e browser_toolset_20260801. Não disponível em ferramentas de servidor. | Definir ferramentas |
eager_input_streaming | Ativa o streaming de entrada refinado (true) ou mantém o streaming padrão com buffer (false) para esta ferramenta | Apenas ferramentas definidas pelo usuário | Streaming refinado de ferramentas |
Valores de allowed_callers
allowed_callers é um array que aceita qualquer combinação de:
| Valor | Significado |
|---|---|
"direct" | O modelo pode chamar esta ferramenta diretamente em um bloco tool_use. Este é o padrão se allowed_callers for omitido. |
"code_execution_20260120" | Código executado dentro de um sandbox code_execution_20260120 ou posterior pode chamar esta ferramenta. |
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
defer_loading: true preserva seu cache de prompt: a busca de ferramentas pode carregar uma ferramenta adiada durante uma conversa sem invalidar uma entrada de cache existente. Coloque pontos de interrupção de cache_control em ferramentas não adiadas. Para saber como as ferramentas adiadas mantêm o cache válido, consulte defer_loading e preservação do cache.
Esta página foi útil?