Subagentes e habilidades: como organizar um agente de IA

Agentes pequenos costumam funcionar bem com um único conjunto de instruções. À medida que o projeto cresce e ganha novas responsabilidades, esse texto único vira um emaranhado: regras que se contradizem, exceções por toda parte e medo de mexer em algo e quebrar outra coisa. A solução é dividir o comportamento em partes menores e especializadas, chamadas de subagentes ou habilidades (skills). Neste artigo, você entenderá como organizar um agente dessa forma. --- ## 1. A ideia da divisão Em vez de um bloco gigante de instruções, o agente principal define o tom geral e a identidade, e cada habilidade cuida de uma responsabilidade específica. Cada uma tem suas próprias instruções, pode usar conhecimento e ferramentas próprios e roda no momento adequado da conversa. --- ## 2. Tipos comuns de habilidade - **Onboarding ou qualificação inicial:** conduz as primeiras perguntas e coleta os dados básicos do cliente antes do restante do atendimento. - **Habilidades de capacidade:** explicar dúvidas, montar um plano, consultar uma agenda ou buscar um conteúdo. - **Regras de segurança (guardrails):** revisam o comportamento e protegem temas sensíveis. - **Passagem para humano:** define quando e como transferir a conversa. --- ## 3. Quando rodam Habilidades podem atuar antes da resposta, preparando informações, ou depois, revisando o que será enviado. A ordem importa: uma habilidade que depende do resultado de outra deve rodar depois dela. --- ## 4. Benefícios da organização - **Clareza:** cada texto tem um propósito. - **Manutenção segura:** ajustar uma habilidade afeta menos o resto. - **Reuso de conhecimento e ferramentas** apenas onde fazem sentido. - **Testes mais simples,** porque dá para verificar cada comportamento separadamente. --- ## 5. Cuidados - Evite duplicar a mesma regra em várias habilidades. - Dê nomes e descrições claros. - Limite a quantidade de habilidades ao que realmente é necessário, porque cada uma adiciona complexidade. **Dica prática:** ao criar uma nova habilidade, escreva primeiro uma frase dizendo qual problema ela resolve e em que momento da conversa deve atuar. Se não conseguir resumir assim, provavelmente a responsabilidade está misturada e vale dividir em duas. Habilidades com propósito claro são mais fáceis de testar e de manter. --- ## Conclusão Dividir um agente em habilidades é uma questão de arquitetura. Com responsabilidades bem separadas, o agente se torna mais previsível, fácil de evoluir e de testar, o que sustenta um atendimento consistente ao longo do tempo.