Escrever a missão de um agente IA: o método em cinco pontos
Um agente funciona tão bem quanto sua missão é clara. Este curso oferece um método em cinco pontos para escrevê-la: o objetivo, as entradas, as saídas, os limites e o tom. Você verá missões fracassadas reescritas e saberá por que um bom agente deve questioná-lo antes de agir.
- Uma missão clara diz o objetivo, as entradas, as saídas, os limites e o tom.
- Os limites contam tanto quanto o objetivo: escreva o que o agente nunca deve fazer.
- Uma saída bem descrita se verifica num relance.
- Um bom agente o questiona antes de agir, e isso é um bom sinal.
Quando um agente decepciona, o reflexo é culpar a IA. Na maioria das vezes, é a missão que era vaga. Um novo funcionário a quem se diz "cuide dos clientes" também faria qualquer coisa. Este curso não fala sobre fórmulas mágicas. Ele propõe uma grade simples para dizer o que você espera, como faria com um aprendiz sério.
IMissão ou prompt: qual é a diferença?
A descrição escrita do que um agente deve fazer, a partir de quê, para produzir quê, e dentro de quais limites.
Um prompt é uma instrução pontual dada a um assistente como ChatGPT, para uma resposta imediata. Uma missão serve a cada passagem do agente, durante semanas. Deve, portanto, funcionar sem que você esteja lá para esclarecer.
É a diferença essencial. Em uma conversa, você corrige conforme avança. Um agente que trabalha cada segunda-feira tem apenas sua missão e seus documentos. Tudo o que você não escreveu, ele terá que adivinhar, e um agente que adivinha acaba se enganando.
IIOs cinco pontos de uma boa missão
- 1O objetivo
Uma frase com um verbo de ação e um resultado esperado. « Preparar cada sexta-feira o cronograma de entregas da semana seguinte », não « me ajudar com as entregas ».
- 2As entradas
O que o agente lê para trabalhar: quais documentos, quais e-mails, qual lista. Diga também qual versão é a oficial se dois arquivos se contradizem.
- 3As saídas
O que ele produz, em qual forma, para quem. Um e-mail de dez linhas, um orçamento no formato habitual, uma tabela resumida. Quanto mais preciso, mais verificável.
- 4Os limites
O que ele nunca faz e os casos em que ele para para avisá-lo. Os montantes, os assuntos, os clientes, os dias a evitar.
- 5O tom
Formalidade ou informalidade, comprimento, fórmulas a evitar, assinatura. Anexe um ou dois textos que você escreveu e que o representam.
O ponto mais negligenciado é o dos limitesPensamos no que o agente deve fazer, raramente no que não deve fazer. Mas é lá que se alojam os erros incômodos: um desconto concedido, um cliente relançado durante uma disputa, uma mensagem enviada numa noite de domingo.
IIITrês missões fracassadas, reescritas
Aqui estão três missões típicas, como são frequentemente escritas em pequenas empresas, depois sua versão corrigida. Observe que a boa versão não é muito mais longa: é simplesmente mais precisa.
IVDescrever a saída para poder verificá-la
Uma saída bem descrita economiza seu tempo na validação. Se você sabe como deve parecer o resultado, vê logo o que está errado. Especifique o comprimento, a estrutura, os elementos obrigatórios. Para um e-mail de relance, por exemplo: número da fatura, montante, data de vencimento, forma de pagamento, fórmula de cortesia. Se um elemento faltar, você o detecta em cinco segundos em vez de reler o texto três vezes.
Marque o que é verdadeiro para você: a lista se lembra de suas respostas neste dispositivo.
VPor que um agente deve solicitar o que lhe falta
Mesmo uma boa missão deixa lacunas. Você escreve « relançar as faturas vencidas », mas o que fazer com um cliente que pagou a metade? Um agente que supõe vai escolher no seu lugar. Um agente que pergunta o obriga a decidir uma vez por todas. Uma imobiliária que confia a resposta aos pedidos de visita pensará nos horários e nos imóveis disponíveis. O agente, por sua vez, perguntará o responder a alguém que quer visitar um imóvel já sob compromisso. Este caso acontece, e ninguém havia escrito. É por isso que um agente ABYS exige tudo o que precisa antes de trabalhar: suas perguntas não são um incômodo, são os casos que você não havia previsto.
VIFazer evoluir a missão sem quebrar tudo
Uma missão não é gravada em pedra. Mude uma coisa por vez, depois observe o próximo passo. Se você modificar ao mesmo tempo o tom, os prazos e a lista de clientes, não saberá mais o que produziu a mudança. Em ABYS, um teste em branco permite verificar o efeito de uma modificação sem que nada saia. Recomendo anotar, em uma linha, cada mudança e sua data: é sua memória quando um resultado o surpreende.
Um mecânico escreve: "Cada segunda-feira, a partir da lista anexada, prepare um e-mail de dez linhas por fatura vencida, com formalidade." Qual ponto do método falta?
?As perguntas que nos fazem
Como escrever um bom prompt para uma IA?
Diga o objetivo em uma frase, forneça o contexto e os documentos úteis, descreva o resultado esperado, especifique o que não deve fazer e o tom desejado. Dê um exemplo do que você gosta. Para um agente que trabalha sozinho durante semanas, esses cinco pontos se tornam indispensáveis.
Qual deve ser o comprimento da missão de um agente IA?
Bastante longa para cobrir o objetivo, as entradas, as saídas, os limites e o tom, frequentemente uma dezena a uma vintena de linhas. Uma missão muito curta deixa o agente adivinhar. Uma missão muito longa mistura o essencial e o acessório: os detalhes de referência têm seu lugar nos documentos anexados.
É necessário escrever a missão em inglês para que funcione melhor?
Não. Os agentes atuais entendem muito bem o francês. Escreva na língua de seus clientes e de seus documentos: você relê a missão mais facilmente, e o tom das mensagens produzidas será mais natural.
Por que meu agente IA não faz o que quero?
Na maioria das vezes, a missão deixa uma margem de interpretação: um objetivo vago, um documento faltando, um limite não escrito. Releia-a com os cinco pontos, compare com o resultado obtido, depois corrija um único elemento por vez e lance um novo teste em branco.
Você tem sua missão em cinco pontos? Descreva-a com suas palavras: o agente lhe fará as perguntas que faltam antes de propor seu plano.
Criar meu agentePara ler em seguida
Criar seu primeiro agente IA em dez minutos, sem instalar nada
Ao final deste tutorial, você saberá criar um agente IA que assume uma tarefa precisa da sua semana. Você saberá o que lu…
Ler a liçãoQuais documentos fornecer a um agente de IA e quais manter
Um agente de IA trabalha a partir do que você lhe fornece. Este guia lhe diz quais documentos realmente o ajudam, em qual formato...
Ler a liçãoOs oito erros que fazem um agente de IA falhar, e seus remédios
Quando um agente IA decepciona, a causa raramente é técnica. É quase sempre uma instrução vaga, um documento esquecido ou um…
Ler a lição