Delegação de Subagentes — Os Clones da IA

Imagine que você é um gerente de projetos equilibrando três prazos. Você não faria todo o trabalho sozinho—você daria instruções a três assistentes, os enviaria e coletaria seus relatórios. É exatamente isso que o delegate_task faz pela sua IA.

O Que É a Delegação de Subagentes?

Em termos simples, ela permite que sua IA principal crie vários “mini AIs” (subagentes), cada um trabalhando em seu próprio ambiente isolado. Eles não compartilham anotações, não se interrompem e só devolvem um único resumo quando terminam. Pense nisso como dar à sua IA o poder de se clonar.

O Problema: Subagentes Têm Amnésia

Aqui está a coisa mais importante para lembrar: seu subagente não sabe nada sobre o histórico da sua conversa. Ele é um novo contratado no primeiro dia. Tudo o que você discutiu, todos os comandos que você executou—tudo se foi. Seu único “treinamento” vem de dois campos que você fornece:

• goal: O que você quer que ele realize
• context: As informações de contexto que ele precisa para fazer o trabalho

Então, você deve colocar todos os detalhes necessários nessa chamada. Caso contrário, seu subagente vai vagar por aí como uma galinha sem cabeça.

Uma Tarefa? Envie um Assistente

Para um trabalho único, a sintaxe é direta:

delegate_task(
    goal="Debug why tests fail",
    context="Error: assertion in test_foo.py line 42"
)

Aqui, você está dizendo ao subagente: “Investigue a falha no teste—o erro está na linha 42.”

Várias Tarefas? Envie uma Equipe

Precisa de várias coisas feitas ao mesmo tempo? Dispare vários subagentes em paralelo. Por padrão, até 3 podem trabalhar simultaneamente (você pode ajustar isso—não há um limite rígido):

delegate_task(tasks=[
    {"goal": "Research topic A", "context": "Focus on recent primary sources"},
    {"goal": "Research topic B", "context": "Compare the leading explanations"},
    {"goal": "Fix the build", "context": "Project root: /home/user/project"}
])

Cada tarefa se torna seu próprio subagente independente. Eles trabalham em paralelo, nunca esperando uns pelos outros.

Modo de Segundo Plano: A IA Principal Continua Ocupada

Aqui está um truque legal: chamadas de nível superior são executadas automaticamente em segundo plano. A IA principal dispara as instruções e continua trabalhando em outras coisas. Quando um subagente termina, seus resultados voltam como uma nova mensagem. Se sua IA principal está atuando como “coordenadora”, ela espera todos os subagentes terminarem e então sintetiza tudo em um único relatório final.

Resumo e Conselhos Práticos

O delegate_task é como dar à sua IA uma máquina de clonagem. Ela lida com várias tarefas independentes simultaneamente, aumentando drasticamente a eficiência.

Dica de profissional: Como os subagentes têm amnésia, escreva seu context como se estivesse enviando um e-mail para um colega novato que não sabe nada sobre seu projeto. Inclua detalhes de contexto, caminhos de arquivos, mensagens de erro, links de referência—tudo. Na dúvida, compartilhe demais. Esse é o segredo para fazer essa ferramenta brilhar.

---