Percurso 01Lição 4 / 6

Escolha uma primeira tarefa útil para IA

Escolha uma tarefa pequena, com dados de entrada claros, resultados visíveis e consequências limitadas.

Fundamentos8 minRevisto

Publicado por Como 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
Qual é o melhor primeiro exercício para uma equipa que está a começar a usar agentes de programação?

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ívelVerificaçãoConsequências
Explicar um parser de datasComparar a explicação com o código e os exemplosSem alterações ao repositório
Acrescentar um teste de regressão para um defeito conhecido de datasO teste falha com o defeito e passa após a correçãoUma pequena alteração num branch
Reescrever a arquitetura dos relatóriosÉ preciso rever muitos requisitos e integraçõesUma 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)
Verifique a sua compreensão ↑

Continuar a aprender

Fontes e leituras adicionais

Leituras relacionadas da Taiga

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