Escolha uma primeira tarefa útil com IA
ConcluídoEscolha uma tarefa pequena com entradas claras, resultados visíveis e consequências limitadas.
Publicado por TaigaComo 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
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 candidata | Verificação | Consequências |
|---|---|---|
| Explicar um parser de datas | Comparar a explicação com o código e os exemplos | Nenhuma alteração no repositório |
| Adicionar um teste de regressão para um defeito conhecido de data | O teste falha com o defeito e passa após a correção | Uma pequena alteração em uma branch |
| Reescrever a arquitetura de relatórios | Muitos requisitos e integrações precisam de revisão | Uma 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)Desmarcar esta opção exclui todo o progresso salvo neste navegador.
O progresso fica neste navegador. Sem conta e sem rastreamento.