Combinações de ferramentas

As ferramentas fornecidas pela Anthropic são projetadas para funcionar em conjunto. Padrões comuns de agentes combinam ferramentas que cobrem etapas complementares de um fluxo de trabalho: uma ferramenta coleta ou descobre, outra processa ou age. As combinações abaixo são pontos de partida, não prescrições. Misture-as para se adequar à sua tarefa.

Cada trecho mostra apenas o array tools. Consulte Lidar com chamadas de ferramentas para ver o formato completo da requisição.

Agente de pesquisa: web_search + code_execution

A busca encontra fontes; a execução de código analisa e sintetiza. Claude busca dados e, em seguida, escreve Python para processá-los, tabulá-los ou visualizá-los. Essa combinação é adequada para perguntas que exigem tanto informações atualizadas quanto computação não trivial sobre essas informações, como "compare os lucros deste trimestre entre os cinco principais provedores de nuvem".

{
  "tools": [
    { "type": "web_search_20260209", "name": "web_search" },
    { "type": "code_execution_20260521", "name": "code_execution" }
  ]
}

O fluxo normalmente é buscar, depois executar e, opcionalmente, buscar novamente se a primeira passagem revelou uma lacuna. A execução de código roda no lado do servidor, portanto não há sandbox no lado do cliente para gerenciar.

Agente de codificação: text_editor + bash

O editor de texto lê e modifica arquivos; o bash executa testes e comandos de build. Este é o ciclo canônico de desenvolvimento de software: inspecionar o código, fazer uma edição, executar os testes, repetir. Ambas as ferramentas são executadas no cliente, portanto sua aplicação controla quais arquivos e comandos estão acessíveis.

{
  "tools": [
    { "type": "text_editor_20250728", "name": "str_replace_based_edit_tool" },
    { "type": "bash_20250124", "name": "bash" }
  ]
}

Combine isso com um diretório de trabalho restrito e uma lista de permissões de comandos se o agente operar sobre código não confiável. Consulte Ferramenta de editor de texto e Ferramenta bash para ver os contratos de execução.

Citar e depois buscar: web_search + web_fetch

A busca revela URLs candidatas; o fetch recupera o conteúdo completo da página para as relevantes. Isso evita buscar tudo antecipadamente. Claude executa uma busca, inspeciona os trechos, escolhe os dois ou três resultados que realmente parecem relevantes e faz o fetch apenas desses.

{
  "tools": [
    { "type": "web_search_20260209", "name": "web_search" },
    { "type": "web_fetch_20260209", "name": "web_fetch" }
  ]
}

Essa combinação é útil quando a resposta está em conteúdo de formato longo (páginas de documentação, artigos, especificações) que um trecho de busca não consegue capturar completamente. O fetch obtém a página completa para que Claude possa citar passagens específicas.

Agente de longa duração: memory + quaisquer outras ferramentas

A memória persiste o estado entre conversas; as outras ferramentas fazem o trabalho. Adicione memória a qualquer agente que precise lembrar de sessões anteriores, como um agente de suporte que recorda os problemas anteriores de um cliente ou um assistente de projeto que acompanha decisões tomadas na semana passada.

{
  "tools": [{ "type": "memory_20250818", "name": "memory" }]
}

Adicione suas outras ferramentas junto com memory no mesmo array.

A memória é ortogonal às suas outras ferramentas. Ela não muda como elas se comportam; ela dá ao Claude um lugar para anotar e posteriormente recuperar fatos que, de outra forma, seriam perdidos quando a "context window" (janela de contexto) é reiniciada. Consulte Ferramenta de memória para ver o modelo de armazenamento.

Tudo em um: computer_use

A ferramenta de uso de computador engloba a maioria das outras ao operar um desktop completo. Claude vê capturas de tela e emite ações de mouse e teclado, o que significa que pode controlar qualquer aplicação que um humano consiga. Use isso quando a tarefa exigir interação arbitrária com GUI que ferramentas mais específicas não conseguem alcançar: software legado sem uma API, etapas de verificação visual ou fluxos de trabalho que abrangem vários aplicativos de desktop.

{
  "tools": [{ "type": "computer_toolset_20260801" }]
}

A entrada do conjunto de ferramentas não recebe name nem dimensões de exibição: as coordenadas são expressas no espaço de pixels das capturas de tela que você retorna, e você pode desativar ações individuais por meio do campo configs da entrada.

O uso de computador é a opção mais geral e também a mais lenta, porque Claude normalmente precisa de uma nova captura de tela após cada lote de ações. Prefira ferramentas mais específicas quando elas cobrirem seu caso de uso e recorra ao uso de computador quando nada mais servir. Se a tarefa permanecer dentro de um navegador web, use o padrão de agente de navegador na próxima seção. Consulte Ferramenta de uso de computador para ver a configuração do sandbox.

Agente de navegador: browser_use

Quando toda a tarefa acontece dentro de páginas web (preencher formulários, ler conteúdo de páginas, trabalhar entre abas), a ferramenta de uso de navegador é mais adequada do que o uso de computador. Sua aplicação controla um navegador que ela gerencia e retorna capturas de tela ou o estado da página; Claude chama ferramentas-membro com conhecimento da página, como read_page, find, form_input e get_page_text, além de cliques e digitação, de modo que pode agir sobre referências de elementos além de coordenadas de pixels.

{
  "tools": [{ "type": "browser_toolset_20260801" }]
}

Assim como o conjunto de ferramentas de uso de computador, a entrada não recebe name, e você desativa ferramentas-membro individuais por meio do seu campo configs. Consulte Ferramenta de uso de navegador para ver o contrato de execução.

Próximos passos