Trilha 01Lição 4 / 6

Escolha uma primeira tarefa útil com IA

Escolha uma tarefa pequena com entradas claras, resultados visíveis e consequências limitadas.

Fundamentos8 minRevisado

Publicado por Como escrevemos

Confira seu entendimentoQual tarefa é o melhor primeiro exercício para uma equipe que está começando a usar agentes de programação?Faça o exercício
Qual tarefa é o melhor primeiro exercício para uma equipe que está começando a usar agentes de programação?

O que você vai aprender

  • Avaliar a clareza, a verificabilidade e a reversibilidade de uma tarefa.
  • Definir o que significa sucesso antes de começar.
  • Manter dados sensíveis e ações em produção fora de um exercício inicial.

Escolha uma tarefa que possa verificar

A primeira tarefa útil deve ensinar como a ferramenta funciona no seu ambiente. Também deve produzir um resultado que você possa inspecionar. Uma pequena correção de um defeito conhecido costuma atender às duas condições.

Não escolha a tarefa apenas porque a demonstração parecerá impressionante. Uma reformulação ampla pode gerar muitas alterações visíveis e ocultar premissas incorretas. Uma tarefa pequena pode mostrar se o agente lê instruções, respeita o escopo e informa com precisão as verificações que falharam.

Não é necessário escolher a tarefa mais fácil possível. Escolha uma em que a equipe consiga reconhecer um resultado correto e explicar por que ele está correto.

Compare as tarefas candidatas

Considere três pedidos fictícios em uma aplicação de relatórios.

Tarefa candidataVerificaçãoConsequências
Explicar um parser de datasComparar a explicação com o código e os exemplosNenhuma alteração no repositório
Adicionar um teste de regressão para um defeito conhecido de dataO teste falha com o defeito e passa após a correçãoUma pequena alteração em uma branch
Reescrever a arquitetura de relatóriosMuitos requisitos e integrações precisam de revisãoUma alteração ampla com efeitos incertos

A tarefa de explicação ajuda a inspecionar o raciocínio e as evidências. O teste de regressão acrescenta uma ação controlada. A tarefa de arquitetura pode ser útil depois, mas exige uma descrição e um processo de revisão muito mais sólidos.

Para o primeiro exercício, escolha o teste de regressão. Use datas inventadas e uma branch local. Deixe explícito que acesso à produção, atualizações de dependências e refatorações sem relação com a tarefa estão fora do escopo.

Escreva a condição de conclusão

“Melhorar o tratamento de datas” deixa espaço demais para interpretação. Use uma condição específica: “Quando a entrada contiver uma data de calendário inválida, retorne um erro de validação. Preserve a saída documentada para datas válidas.”

Acrescente exemplos de entradas válidas e inválidas. Identifique o comando de teste existente. Peça ao agente que inspecione o comportamento atual antes de alterar arquivos. Exija uma explicação breve do defeito e das evidências após a alteração.

Separe o resultado de uma tarefa da atividade realizada. “O agente escreveu um teste” descreve uma atividade. “O teste rejeita o defeito conhecido” descreve uma evidência. Um teste que passa tanto no código correto quanto no incorreto não comprova a proteção pretendida.

Observe o processo de trabalho

Durante o exercício, registre onde o agente precisa de mais contexto. Verifique se ele lê as instruções relevantes do repositório. Observe se altera arquivos fora do escopo ou repete uma abordagem malsucedida sem novas evidências.

Não corrija imediatamente toda escolha de pouca importância. Deixe o agente concluir o trabalho autorizado e reversível para poder avaliar o resultado. Intervenha quando a próxima ação ultrapassar um limite ou quando a continuação depender de um requisito não resolvido.

Ao concluir, revise o diff e execute as verificações relevantes. Registre o tempo do agente e o seu tempo de preparação e revisão. Essas observações ajudam a escolher a próxima tarefa e a melhorar as instruções de trabalho.

Amplie um limite de cada vez

Se o exercício der certo, aumente uma dimensão da complexidade. Você pode passar de uma função para dois módulos relacionados. Pode acrescentar uma integração documentada. Mantenha explícitas as permissões e as exigências de verificação.

Se o exercício falhar, identifique a causa antes de ampliar o escopo. Falta de contexto, requisito pouco claro, ambiente de teste indisponível e limitação do modelo exigem correções diferentes. Mais autonomia não resolve os quatro problemas.

Se um protótipo continuar em uso, atribua um responsável pela manutenção. Novas informações sobre vulnerabilidades podem exigir uma ação mesmo sem alteração no código. Consulte a lição sobre gestão contínua de vulnerabilidades.

Faça o exercício

Escreva três tarefas candidatas. Para cada uma, indique o resultado, o método de verificação, os dados permitidos e a ação de recuperação. Escolha a tarefa com as evidências mais claras. Se nenhuma tiver uma verificação confiável, melhore a descrição antes de usar um agente.

Baixar planilha de exercício (Markdown)
Confira seu entendimento ↑

Continuar aprendendo

Fontes e leituras adicionais

Leituras relacionadas da Taiga

← Lição anterior: Assistentes, agentes e permissões