Combinações de ferramentas

As ferramentas fornecidas pela Anthropic são projetadas para funcionar juntas. Padrões comuns de agentes emparelham 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. Combine-as para se adequar à sua tarefa.

Cada trecho mostra apenas o array tools. Veja Lidar com chamadas de ferramentas para a forma completa da solicitaçã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 depois escreve Python para processá-los, tabulá-los ou visualizá-los. Este emparelhamento é adequado para perguntas que exigem informações atualizadas e computação não trivial sobre essas informações, como "comparar os ganhos deste trimestre entre os cinco principais provedores de nuvem."

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

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

Agente de codificação: text_editor + bash

O editor de texto lê e modifica arquivos; bash executa testes e comandos de compilação. Este é o loop 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" }
  ]
}

Emparelhe isso com um diretório de trabalho restrito e uma lista de permissão de comandos se o agente operar em código não confiável. Veja Ferramenta de editor de texto e Ferramenta Bash para os contratos de execução.

Citar-depois-buscar: web_search + web_fetch

A busca expõe URLs candidatas; a busca 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 aqueles.

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

Este emparelhamento é ú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 pode capturar completamente. A busca puxa 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 se lembra dos problemas anteriores de um cliente ou um assistente de projeto que rastreia decisões tomadas na semana passada.

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

Adicione suas outras ferramentas ao lado de memory no mesmo array.

A memória é ortogonal ao resto do seu conjunto de ferramentas. Ela não muda como outras ferramentas se comportam; ela dá a Claude um lugar para anotar e depois recuperar fatos que de outra forma seriam perdidos quando a janela de contexto é redefinida. Veja Ferramenta de memória para o modelo de armazenamento.

Tudo em um: computer_use

A ferramenta de uso de computador subsume a maioria das outras operando um desktop completo. Claude vê capturas de tela e emite ações de mouse e teclado, o que significa que pode conduzir 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 API, etapas de verificação visual ou fluxos de trabalho que abrangem múltiplos aplicativos de desktop.

{
  "tools": [
    {
      "type": "computer_20250124",
      "name": "computer",
      "display_width_px": 1280,
      "display_height_px": 800
    }
  ]
}

O uso de computador é a opção mais geral e também a mais lenta, pois cada ação requer uma viagem de captura de tela. Prefira ferramentas mais estreitas quando elas cobrem seu caso de uso e recorra ao uso de computador quando nada mais se adequar. Veja Ferramenta de uso de computador para a configuração da sandbox.

Próximas etapas