Escolha uma primeira tarefa útil para IA
ConcluídoEscolha uma tarefa pequena, com dados de entrada claros, resultados visíveis e consequências limitadas.
Publicado por TaigaComo escrevemos
Verifique a sua compreensãoQual é o melhor primeiro exercício para uma equipa que está a começar a usar agentes de programação?Faça o exercício
O que vai aprender
- Avaliar a clareza, a verificabilidade e a reversibilidade de uma tarefa.
- Definir o sucesso antes de começar.
- Excluir dados sensíveis e ações em produção de um primeiro exercício.
Escolha uma tarefa que consiga verificar
A primeira tarefa útil deve mostrar como a ferramenta funciona no seu ambiente. Deve também produzir um resultado que possa inspecionar. Uma pequena correção de um defeito conhecido satisfaz muitas vezes ambas as condições.
Não escolha a tarefa apenas pelo impacto visual da demonstração. Uma reformulação ampla pode produzir muitas alterações visíveis e esconder pressupostos incorretos. Uma tarefa pequena pode mostrar se o agente lê as instruções, respeita o âmbito e comunica com rigor as verificações que falharam.
Não precisa de escolher a tarefa mais fácil. Escolha uma em que a equipa consiga reconhecer um resultado correto e explicar por que razão está correto.
Compare as tarefas possíveis
Considere três pedidos fictícios para uma aplicação de relatórios.
| Tarefa possível | Verificação | Consequências |
|---|---|---|
| Explicar um parser de datas | Comparar a explicação com o código e os exemplos | Sem alterações ao repositório |
| Acrescentar um teste de regressão para um defeito conhecido de datas | O teste falha com o defeito e passa após a correção | Uma pequena alteração num branch |
| Reescrever a arquitetura dos relatórios | É preciso rever muitos requisitos e integrações | Uma alteração ampla com efeitos incertos |
A tarefa de explicação ajuda a inspecionar o raciocínio e as provas. O teste de regressão acrescenta uma ação controlada. A tarefa de arquitetura pode ter valor mais tarde, mas exige um enunciado 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 um branch local. Indique que o acesso à produção, as atualizações de dependências e a refatorização sem relação com o problema ficam fora do âmbito.
Escreva a condição de conclusão
«Melhorar o tratamento de datas» deixa demasiado espaço para interpretação. Use uma condição específica: «Se os dados de entrada contiverem uma data de calendário inválida, devolver um erro de validação. Preservar o resultado documentado para as datas válidas.»
Acrescente exemplos de dados válidos e inválidos. Identifique o comando de teste existente. Peça ao agente que inspecione o comportamento atual antes de alterar ficheiros. Exija uma explicação breve do defeito e as provas obtidas após a alteração.
Separe o resultado da tarefa da atividade. «O agente escreveu um teste» descreve uma atividade. «O teste rejeita o defeito conhecido» descreve uma prova. Um teste que passa tanto no código correto como no incorreto não demonstra a proteção pretendida.
Observe o processo de trabalho
Durante o exercício, registe onde o agente precisa de mais contexto. Verifique se lê as instruções relevantes do repositório. Repare se altera ficheiros fora do âmbito ou repete uma abordagem que falhou sem novas provas.
Não corrija imediatamente cada decisão menor. Deixe o agente concluir o trabalho autorizado e reversível para poder avaliar o resultado. Intervenha quando a ação seguinte ultrapassar um limite ou quando o trabalho depender de um requisito por esclarecer.
No fim, reveja o diff e execute as verificações relevantes. Registe o tempo do agente e o seu tempo de preparação e revisão. Estas observações ajudam a escolher a tarefa seguinte e a melhorar as instruções de trabalho.
Alargue um limite de cada vez
Se o exercício resultar, aumente uma dimensão da complexidade. 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 alargar o âmbito. Falta de contexto, um requisito pouco claro, um ambiente de teste indisponível e uma limitação do modelo exigem correções diferentes. Mais autonomia não resolve os quatro problemas.
Se um protótipo continuar a ser usado, nomeie um responsável pela manutenção. Novas informações sobre vulnerabilidades podem exigir ação sem qualquer alteração de código. Consulte a gestão contínua de vulnerabilidades.
Faça o exercício
Escreva três tarefas possíveis. 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 provas mais claras. Se nenhuma tiver uma verificação fiável, melhore o enunciado antes de usar um agente.
Descarregar ficha (Markdown)Desmarcar esta opção elimina todo o progresso guardado neste browser.
O progresso fica neste browser. Sem conta nem rastreamento.