Instruções para AI Agent: do genérico ao especialista

Um AI Agent sem instrução personalizada age como um colaborador novo sem briefing: faz alguma coisa, mas raramente do jeito certo para o seu processo. Ele interpreta, supõe e entrega resultados inconsistentes. O problema não é a IA, é a ausência de critério.

Configurar instruções não é escrever um prompt criativo. É codificar a política operacional do seu processo: o que o agente faz, como responde, em que formato entrega e quando escala para um humano. Ao final deste artigo, você vai saber como escrever instruções que tornam o agente previsível, auditável e útil de verdade.

📖  O que você vai aprender aqui:

Do agente genérico ao especialista

A diferença entre um agente genérico e um especialista está na instrução. Um agente sem instrução personalizada usa apenas o contexto do card para decidir o que fazer. Um agente com instrução bem definida age dentro de um escopo claro, com critérios específicos e comportamento padronizado.

Pense na instrução como o escopo de um colaborador. Quando você contrata alguém para triagem de chamados, você não diz apenas "resolva os chamados". Você explica o que é urgente, qual linguagem usar com o cliente, quando escalar para o nível 2 e como registrar a resolução. A instrução do agente é exatamente isso: o conjunto de critérios que define o trabalho dele.

Anatomia de uma boa instrução

Uma instrução eficaz tem quatro componentes. Não precisam aparecer nessa ordem, mas todos precisam estar presentes quando o processo exige precisão.

Contexto

O que é este processo e qual é o papel do agente dentro dele. Sem contexto, o agente infere. Com contexto, ele age dentro do escopo correto.

Exemplo: "Você atua no processo de triagem de chamados de TI. Seu papel é classificar a urgência de cada chamado recebido e encaminhar para a fila correta."

Critério de decisão

As regras que o agente deve aplicar para tomar decisões. Quanto mais específico, mais previsível o resultado.

Exemplo: "Classifique como urgente quando o chamado mencionar perda de acesso a sistemas críticos, falha em produção ou impacto em mais de 5 usuários. Classifique como normal nos demais casos."

Formato de output

Como o agente deve preencher os campos do card. Especifique os valores exatos quando o campo for de seleção.

Exemplo: "Preencha o campo @Urgência com os valores 'Alta', 'Média' ou 'Baixa'. Preencha o campo @Resumo com uma frase de até 20 palavras descrevendo o problema."

Limite de atuação

O que o agente não deve fazer. Explícito é melhor que implícito.

Exemplo: "Não responda ao solicitante diretamente. Não mova o card para a fase de resolução. Apenas classifique e preencha os campos."

Definindo o que o agente pode e não pode fazer

Cada comportamento do agente pode executar até 3 ações por gatilho: atualizar campos, criar um card, mover o card para outra fase, criar um registro ou criar um card conectado. Se o processo exige mais de 3 ações para um mesmo gatilho, divida em um segundo comportamento ou combine com uma automação complementar.

O limite de atuação deve estar explícito na instrução. Agentes sem limite tendem a extrapolar o escopo quando o contexto é ambíguo. Uma instrução que diz "analise o documento e preencha os campos" pode resultar em o agente também mover o card, se isso não estiver explicitamente proibido.

A instrução também é o lugar correto para definir o comportamento em casos de ambiguidade. Se o agente não consegue determinar a urgência de um chamado com as informações disponíveis, o que ele deve fazer? Preencher com "Indefinido"? Escalar para um humano? Deixar o campo em branco? Se a instrução não diz, o agente decide sozinho.

Testando e refinando

Após salvar o agente, teste com cards reais antes de ativar em volume. O Pipefy registra a atividade do agente em dois lugares: na aba Atividades do card, para ver o resultado de cada execução, e nos Logs de automação, para investigar falhas e comportamentos inesperados.

O ciclo de refinamento é: executar, verificar o resultado, ajustar a instrução, executar novamente. Os dois erros mais comuns são:

• Campo preenchido com valor incorreto: a instrução não especificou os valores aceitos pelo campo. Adicione os valores exatos que o campo aceita, especialmente em campos de seleção.
• Agente executou uma ação além do escopo: a instrução não tinha limite explícito. Adicione uma frase do tipo "execute apenas estas ações e nenhuma outra".

Exemplos de instrução por caso de uso

• Triagem de chamados de TI

• Análise de currículo para recrutamento

• Categorização de solicitações de compra

Antes de avançar, confirme que você entende:

☐ Os quatro componentes de uma instrução eficaz

☐ A diferença entre limite de atuação e critério de decisão

☐ Quantas ações e comportamentos um agente pode ter

☐ Como verificar os resultados do agente nos logs

☐ Como refinar a instrução quando o agente comete erros