Programação e agentes de IA

[Claude Code #13] /deep-research, pesquisa multiagente

Claude Code /deep-research é um workflow integrado que pesquisa uma pergunta por vários ângulos, cruza os resultados e gera um relatório com citações. Também resumimos a visão de progresso de /workflows, a extensão ultracode e a noção de custos.

4 min de leitura
Imagem de capa de [Claude Code #13] /deep-research, pesquisa multiagente

Ao pesquisar um tópico técnico, é fácil acabar com dezenas de abas do navegador abertas. Como cada fonte apresenta as informações de um jeito um pouco diferente, conferir o que está correto pode consumir todo o seu tempo.

O /deep-research do Claude Code assume todo esse processo. Você fornece uma pergunta, e vários agentes pesquisam por caminhos diferentes, verificam os resultados uns dos outros e retornam com um único relatório com fontes.

/deep-research Node.js Como o modelo de permissões mudou entre v20e v22 ??

Se oClaude Code — Parte 12do/loopera sobre como dividir o tempo, desta vez é sobre como dividir os agentes.

O que muda: validação cruzada

Documentação oficial de workflows explica o funcionamento assim: distribui a pergunta em buscas na web por vários ângulos, cruza as fontes encontradas e submete cada afirmação a uma votação.

Por isso o resultado é diferente. Afirmações que não sobrevivem à validação cruzada são filtradas, e apenas um relatório com fontes de apoio chega até você.

Afirmações que um agente de validação não conseguiu confirmar por causa de um limite de requisições (rate limit) ou erro de API não são consideradas falsas; elas são marcadas separadamente como “não verificadas”.

O que acontece ao executar

No modo de permissões padrão, primeiro ele pergunta se você permite o workflow. Depois que você revisa e aprova a lista de etapas planejadas, a execução começa.

A execução acontece em segundo plano. Sua sessão continua livre, e, quando termina, apenas o relatório chega à conversa.

Para consultar o progresso intermediário, digite /workflows. Você verá o número de agentes por etapa, o uso de tokens e o tempo decorrido; ao entrar em uma etapa, também poderá ver o que cada agente encontrou.

Diagrama do fluxo de pesquisa distribuída e validação cruzada do Claude Code /deep-research
Apenas as afirmações que sobrevivem à validação entram no relatório

Na prática, é um workflow

/deep-research é um workflow dinâmico integrado ao Claude Code.

O workflow é um script JavaScript que orquestra dezenas de subagentes. Repetições, ramificações e resultados intermediários ficam todos dentro do script, deixando apenas a resposta final no contexto da conversa.

Você pode usar a mesma estrutura nas suas tarefas. Escreva “faça como workflow” no prompt ou inclua a palavra-chave ultracode, e o Claude escreverá e executará um script de workflow para esse trabalho.

ultracode: src/routes/ Audite a ausência de autenticação em todos os endpoints abaixo

Salve um workflow de que gostou pressionando s na visão /workflows e reutilize-o com o comando /이름.

Noção de custos

Como os workflows iniciam muitos agentes, também consomem muitos tokens. Eles podem ser significativamente mais caros do que resolver o problema por conversa.

Por isso, antes de executar uma tarefa grande, o ideal é testá-la primeiro em uma parte pequena. Use um diretório em vez do repositório inteiro e uma pergunta específica em vez de uma ampla.

Quando há mais de 25 agentes ou os tokens estimados passam de 1,5 milhão, aparece um aviso de Large workflow. É um aviso informativo e não bloqueia a execução. Você pode interromper a qualquer momento com /workflows, e os resultados dos agentes concluídos geralmente são preservados.

Requisitos

  • Claude Code v2.1.154 ou posterior, plano pago
  • No plano Pro, é preciso ativar na seção Dynamic workflows de /config
  • /deep-research exige um ambiente em que a ferramenta WebSearch esteja disponível
Ilustração comparando um tubo de ensaio pequeno e um balão grande, com a frase START SMALL e uma tabela de preços
Antes do balão grande, comece pelo tubo de ensaio. Essa é a noção de custos de workflow

Resumo

/deep-research é um workflow integrado que executa “pesquisa → validação cruzada → relatório com citações” usando multiagentes em segundo plano.

Ele é especialmente útil para perguntas com fontes divergentes, como mudanças entre versões, comparações de bibliotecas e investigação da causa de falhas. Confira o progresso com /workflows. Experimente ampliar a mesma estrutura para suas próprias tarefas como workflow.

Na próxima edição, veremos o modo headless claude -p, que insere o Claude em um pipeline de terminal.

Fontes e critérios de verificação

Continue lendo

Série Claude Code

Tópicos relacionados