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 estágios 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 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 é uma boa opção 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 é tipicamente 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, então não há um "sandbox" (ambiente isolado) 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, então sua aplicação controla quais arquivos e comandos sã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 comandos permitidos se o agente operar em código não confiável. Consulte Ferramenta de editor de texto e Ferramenta bash para 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 busca apenas esses.

{
  "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 extrai a página completa para que Claude possa citar passagens específicas.



Agente de longa duração: memory + qualquer conjunto de 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 ao restante do seu conjunto de ferramentas. Ela não muda como as outras ferramentas se comportam; ela dá a Claude um lugar para anotar e depois recuperar fatos que, de outra forma, seriam perdidos quando a "context window" (janela de contexto) é reiniciada. Consulte Ferramenta de memória para o modelo de armazenamento.



Tudo em um: computer_use

A ferramenta de uso do 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 operar qualquer aplicação que um humano possa. 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_20250124",
      "name": "computer",
      "display_width_px": 1280,
      "display_height_px": 800
    }
  ]
}

O uso do computador é a opção mais geral e também a mais lenta, porque cada ação requer uma ida e volta de captura de tela. Prefira ferramentas mais específicas quando elas cobrirem seu caso de uso, e recorra ao uso do computador quando nada mais servir. Consulte Ferramenta de uso do computador para a configuração do sandbox.



Próximos passos