Como escrever boas instruções para um agente de IA

Um agente de IA é como um profissional muito capaz em seu primeiro dia de trabalho: sabe muita coisa, mas não conhece a sua empresa. As instruções são o treinamento que ele recebe.

Explique o contexto

Diga quem é a empresa, quem são os clientes e qual é o objetivo da tarefa. Quanto mais o agente entende o porquê, melhores são as decisões nos casos que você não previu.

Defina o papel

"Você é o assistente de atendimento de uma loja de materiais de construção" orienta mais do que "responda os clientes".

Seja específico sobre o resultado

Descreva como é uma boa resposta: o tom, o tamanho, o formato e o que deve conter. Se quer mensagens curtas e cordiais, diga isso.

Dê exemplos

Dois ou três exemplos de boas respostas valem mais do que parágrafos de explicação. Varie os exemplos para o agente não copiar um único modelo.

Estabeleça limites

Liste o que o agente não deve fazer e, de preferência, explique o motivo:

• Não informar preços que não estejam na tabela.
• Não prometer prazos.
• Não discutir assuntos fora do escopo.

Diga o que fazer na dúvida

Toda instrução deve responder: e se o agente não souber? O comportamento esperado costuma ser admitir e encaminhar para uma pessoa.

Organize o texto

Separe as instruções em seções: contexto, tarefa, regras, exemplos. Estrutura ajuda o modelo e ajuda quem for manter aquilo depois.

Evite exageros

Letras maiúsculas e ameaças não melhoram o resultado. Explicações calmas e claras funcionam melhor com os modelos atuais.

Teste e ajuste

Instrução boa nasce de iteração. Rode casos reais, observe os erros e ajuste o texto. Guarde os casos para testar de novo a cada mudança.

Conclusão

Escrever instruções é uma habilidade de comunicação, mais do que técnica. Na Webparatus, esse trabalho é feito junto com quem conhece o processo no dia a dia.