Papéis e especialização

Uma única instrução generalista tentando lidar com muitas preocupações dilui a atenção e mistura instruções. Dividir uma tarefa em agentes especializados — cada um com uma atribuição restrita, contexto focado e ferramentas adequadas — torna o comportamento mais preciso e isola as falhas.

• Escopo restrito -> mais confiável e mais fácil de orientar.
• Isolamento -> um erro em uma função não corrompe as demais.

A especialização é dividir para conquistar aplicado à elaboração de instruções.

Uma persona eficaz de agente é mais do que um nome. Ela declara: uma atribuição (o que lhe cabe), limites (o que não deve fazer), entradas/saídas (seu contrato) e critérios de sucesso. Personas vagas ('você é um especialista prestativo') restringem pouco o comportamento.

Dê a cada agente um único motivo para mudar seu comportamento. Um agente de 'pesquisa, resumo e verificação de fatos' combina três objetivos que puxam em direções diferentes. Separe-os para que cada um possa ser ajustado, avaliado e depurado de forma independente.

O teste: se você não consegue descrever o trabalho de um agente em uma frase sem usar 'e', ele está fazendo coisas demais.

A especialização inclui isolamento de contexto. Um agente programador precisa do código e da especificação, não do resumo de marketing. Restringir o contexto de cada agente reduz a distração, o custo e a probabilidade de ele agir com base em material irrelevante.

• Forneça somente as entradas exigidas pela atribuição.
• Conceda somente as ferramentas que a função realmente utiliza.

O princípio do menor contexto e da menor quantidade de ferramentas é o equivalente multiagente do princípio do menor privilégio.

As funções devem dividir o trabalho sem sobreposições nem lacunas. A sobreposição desperdiça capacidade de processamento e cria saídas conflitantes; as lacunas deixam partes da tarefa sem responsável. Projete o conjunto de funções como uma divisão clara, na qual cada subtarefa tenha exatamente um responsável.

Desenhe primeiro o mapa de responsabilidades e depois escreva as personas para preencher cada célula.

Alguns dos especialistas mais valiosos são adversariais: um Crítico que encontra falhas, uma equipe de Red Team que ataca o plano, um Verificador que exige evidências. A atribuição deles é explicitamente discordar, o que contrabalança a adulação e o excesso de confiança de um agente isolado.

Associe cada gerador a um cético cujo sucesso seja medido pelos problemas encontrados.

Ao longo de uma sessão prolongada, um agente pode sair do personagem, absorvendo o tom ou os objetivos de outras personas que lê. Reforce a identidade: repita a atribuição a cada invocação e mantenha a instrução de cada agente autocontida, para que ele não herde silenciosamente as instruções de outro.

Trate a persona como algo reafirmado a cada rodada, não como algo definido uma vez e depois esquecido.

Os especialistas devem fazer a transferência de forma clara. Defina um contrato tipado para a saída de cada função, que será consumida pela função seguinte. Transferências em prosa vaga causam interpretações equivocadas; contratos estruturados tornam o fluxo de processamento combinável e verificável.

O Pesquisador emite afirmações com citações; o Redator consome exatamente esse formato; o Crítico faz a verificação com base nele.

Mais agentes significam mais chamadas. A especialização troca a eficiência de uma única chamada por confiabilidade e paralelismo. Justifique cada função: se a divisão não melhorar a qualidade de forma mensurável nem permitir trabalho paralelo, reúna-a novamente em um agente generalista.

• Especialistas que podem ser paralelizados podem usar run simultaneamente -> ganho de latência.
• Especialistas estritamente sequenciais acrescentam latência -> certifique-se de que o ganho de qualidade compensa.

Poucas funções resultam em um generalista confuso; funções demais fazem você se afogar no custo de coordenação. Escolha a divisão mais ampla que ainda dê a cada agente uma responsabilidade única e avaliável. Comece de forma ampla e divida somente quando uma função demonstrar estar sobrecarregada na avaliação.

A granularidade é ajustada empiricamente, orientada pelos pontos em que os erros realmente se concentram.

Para cada agente, confirme: uma atribuição de uma frase, limites explícitos, escopo com o menor contexto e a menor quantidade de ferramentas, um contrato de saída tipado, compatibilidade complementar sem sobreposições ou lacunas, reforço da identidade a cada rodada e uma justificativa de que a divisão melhora a qualidade ou o paralelismo. Críticos adversariais merecem seu lugar por encontrar falhas reais.

Você percebe que um agente que pesquisa, redige e verifica fatos está produzindo resultados inconsistentes e difíceis de depurar.

Use decompose para dividir tarefas em agentes com responsabilidade única, cada um com uma atribuição clara, limites explícitos, escopo com o menor contexto e a menor quantidade de ferramentas e um contrato de saída tipado. Divida o trabalho de forma clara, sem sobreposições nem lacunas, associe geradores a críticos adversariais, reforce a identidade da persona a cada rodada e escolha a granularidade mais ampla que mantenha todas as funções avaliáveis. A especialização oferece confiabilidade e paralelismo ao custo de mais chamadas — use-a onde ela ajudar de forma mensurável.