Papéis e especializações dos agentes
Atribua a cada agente um papel restrito (planejador, programador, crítico, executor) e eles terão um desempenho melhor do que um agente generalista.
Papéis e especializações dos agentes é uma aula grátis de AI Agents no CoddyKit. Esta é a aula 3 de 4. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de AI Agents, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de AI Agents inclui 4 aulas no total.
Partes desta aula ainda não foram traduzidas e aparecem em inglês.
Por que a especialização ajuda
Um agente focado, com um prompt preciso e um conjunto pequeno de ferramentas, supera um generalista com tudo à disposição. Motivos:
- Os prompts podem ser mais longos e específicos para cada função
- Descrições de ferramentas mais claras (menos opções para confundir o modelo)
- Mais fácil depurar e avaliar
- Cada agente pode usar um tamanho diferente de modelo
Funções comuns
- Planejador — divide as tarefas em etapas
- Pesquisador — reúne informações
- Programador — escreve código
- Revisor / Crítico — encontra falhas
- Editor — aprimora a saída
- Executor — executa comandos e ferramentas
Define a Role Clearly
RESEARCHER_PROMPT = '''
You are Researcher. Your job is to gather facts.
Never write code. Never make final decisions.
Return 3-5 sourced findings with URLs.
When finished, end your message with: HANDOFF: planner
'''
print(RESEARCHER_PROMPT.strip())
Ferramentas por função
Lista rigorosa de ferramentas permitidas por função:
researcher_tools = ['web_search', 'fetch_url']
coder_tools = ['read_file', 'write_file', 'run_python']
reviewer_tools = [] # critique-only, no tools
print("Researcher tools:", researcher_tools)
print("Coder tools:", coder_tools)
print("Reviewer tools:", reviewer_tools)
Modelos por função
Use modelos baratos para funções simples e modelos grandes para funções difíceis:
ROLE_MODELS = {
'planner': 'gpt-4o', # critical role
'researcher': 'gpt-4o-mini', # routine
'coder': 'gpt-4o', # hard
'reviewer': 'claude-sonnet-4-5' # second opinion
}
for role, model in ROLE_MODELS.items():
print(f"{role}: {model}")
Crítica entre modelos
Para obter maior qualidade, use uma família de modelos diferente para a crítica. Isso reduz erros decorrentes de vieses compartilhados:
- Programador: GPT-4
- Revisor: Claude
- Se ambos concordarem, coloque em produção; caso contrário, escale
Protocolo de Transferência
Os agentes precisam de uma forma clara de passar o trabalho adiante. Uma convenção simples:
# Each message ends with one of:
HANDOFF: <role_name>
FINAL: <answer>
ABORT: <reason>Especialização por Tipo de Tarefa
Algumas equipes adicionam especialistas de domínio:
- Revisor-Jurídico para conformidade
- Revisor de Segurança para a segurança do código
- Especialista de Domínio para conhecimento do setor
Limites por Função
Limites por função evitam que o processamento saia de controle:
MAX_ROLE_INVOCATIONS = {
'planner': 3,
'researcher': 5,
'coder': 10,
'reviewer': 3
}
for role, cap in MAX_ROLE_INVOCATIONS.items():
print(f"{role}: max {cap} invocations")
Não Especialize Demais
Passar de 3 funções para 30 causa problemas: a seleção pelo supervisor se torna pouco confiável, a latência dispara e a maioria dos "especialistas" duplica o trabalho.
Adicione funções somente quando medir um benefício real.
Avaliação por Função
Teste cada função de forma independente:
- Avaliação do pesquisador: ele retorna fatos com fontes?
- Avaliação do programador: o código compila e passa nos testes?
- Avaliação do revisor: ele identifica erros conhecidos?
Componibilidade
As funções podem ser reutilizadas em vários sistemas de agentes. Um pesquisador bem ajustado funciona tanto para um fluxo de trabalho de redator de documentação quanto para um verificador de fatos.
Por que Funções?
Qual é o principal benefício de atribuir uma função clara a cada agente?
Recapitulação
Planejar -> Pesquisar -> Programar -> Revisar é um excelente fluxo de processamento padrão. Instruções precisas, ferramentas restritas, modelos por função e protocolo de transferência. Adicione funções somente quando existir um benefício comprovado.
Perguntas Frequentes
A aula “Papéis e especializações dos agentes” é grátis?
Sim — o texto completo de “Papéis e especializações dos agentes” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de AI Agents, atualize para CoddyKit PRO. O curso de AI Agents inclui 4 aulas no total.
O que vou aprender em “Papéis e especializações dos agentes”?
Atribua a cada agente um papel restrito (planejador, programador, crítico, executor) e eles terão um desempenho melhor do que um agente generalista. Você pratica AI Agents com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.
Preciso ter experiência prévia para começar AI Agents?
Nenhuma experiência prévia é necessária. AI Agents no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 3 de 4.
Quanto tempo leva a aula “Papéis e especializações dos agentes”?
A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.
Posso escrever e executar código nesta aula de AI Agents?
Sim. Cada aula de AI Agents inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.
Todas as aulas deste curso
- Multiagentes baseados em conversa (AutoGen)
- Supervisores hierárquicos (orquestrador + trabalhadores)
- Papéis e especializações dos agentes
- Protocolos de comunicação (barramentos de mensagens)