Como escrever uma tarefa para um agente de IA para o resultado sair certo

A tarefa “Migrar as configurações para o novo formulário” parece clara. O agente migra todas as abas e os testes passam. De quebra, ele muda a ordem dos campos da aba “Conta”, porque assim faz mais sentido, e remove a dica antiga abaixo da senha.

Não há erro aqui. O agente fez um trabalho razoável, só que não o trabalho esperado. A expectativa era que nada mudasse para o usuário, mas isso existia apenas na cabeça de quem criou a tarefa.

Três coisas que o agente não adivinha

O agente é bom em deduzir como fazer. É pior em saber o que exatamente deve ficar pronto e onde parar. Por isso, vale responder a três perguntas na tarefa:

  • o que deve ficar pronto: como vai ser ou funcionar quando estiver concluído;
  • o que não mexer: o que o agente pode tomar por melhoria, mas que agora está fora do escopo;
  • como verificar: o que mostra que está tudo certo.

A mesma tarefa com as expectativas:

Migrar as configurações para o novo formulário. Para o usuário nada muda: os mesmos campos, na mesma ordem, com as mesmas dicas. Remover os manipuladores antigos do formulário. Verificar: cada aba salva, e os erros aparecem abaixo do campo.

São quatro frases em vez de uma. Escrevê-las leva alguns minutos. Descobrir depois quais das mudanças eram necessárias costuma levar mais tempo.

Onde ficam as expectativas no Tascue

Parte das expectativas é igual em quase toda tarefa: “o mínimo de código novo”, “deixe as mudanças na cópia de trabalho”, “no fim, escreva em poucas palavras o que foi feito e o que não foi”. Não é preciso escrever isso toda vez. São os trechos (includes): escritos uma vez, entram sozinhos no fim do prompt.

Para dizer onde procurar, existem os campos. “Tela: Configurações” e o agente começa pelo lugar certo, em vez de vasculhar o projeto inteiro.

No texto da tarefa fica só o que pertence a ela: o resultado, os limites e a verificação. Antes de entregar a tarefa, dá para abrir “Pré-visualização” e ler o prompt inteiro do jeito que o agente vai vê-lo.

Quando o resultado ainda não é o esperado

Às vezes as expectativas não batem nem com uma tarefa detalhada. Nesse caso, é mais prático acrescentar a correção na própria tarefa, e não só no chat com o agente. A tarefa volta para “Em andamento”, e na próxima vez o agente a lê por inteiro, com a correção.

Assim as expectativas ficam junto da tarefa. Um mês depois, ela mostra não só o que foi feito, mas também o que se esperava.

Siga o Tascue no LinkedIn