Como o Amazon Q Developer Agent for code transformation funciona

Para transformar seu código, o Amazon Q Developer Agent for code transformation gera um plano de transformação que ele usa para atualizar a versão da linguagem de código do seu projeto. Depois de transformar seu código, ele fornece um resumo da transformação e uma comparação de arquivos para você revisar as alterações antes de aceitá-las. As seções a seguir fornecem mais detalhes sobre como o Amazon Q realiza a transformação.

Construindo seu código e criando um plano de transformação

Para começar a transformar seu código, o Amazon Q cria seu projeto localmente e gera um artefato de construção que contém seu código-fonte, dependências do projeto e registros de construção.

Depois de gerar o artefato de construção, o Amazon Q cria seu código em um ambiente de compilação seguro e cria um plano de transformação, que é personalizado para o projeto ou módulo que você está atualizando. O plano de transformação descreve as mudanças específicas que o Amazon Q tentará fazer, incluindo novas versões de dependência, grandes alterações no código e sugestões de substituições para o código obsoleto. Essas alterações são baseadas na compilação preliminar do seu código e podem mudar durante a transformação.

Transformando seu código

Para transformar seu código, o Amazon Q tenta atualizar seu código com base nas mudanças propostas no plano de transformação. À medida que faz alterações, ele reconstrói e executa testes de unidade existentes em seu código-fonte para corrigir iterativamente quaisquer erros encontrados.

O Amazon Q tenta fazer as seguintes alterações ao atualizar seu código:

Revisando o resumo da transformação e aceitando as alterações

Depois que a transformação for concluída, o Amazon Q fornece um resumo da transformação com detalhes sobre as alterações feitas, incluindo o status da versão final, que indica se todo o seu projeto foi atualizado. Você também pode ver um resumo do registro de compilação para entender quaisquer problemas que impediram o Amazon Q de criar seu código na versão atualizada.

Além disso, o resumo da transformação inclui as diferenças entre as mudanças propostas no plano de transformação e as alterações que a Amazon Q fez para atualizar seu código e quaisquer alterações adicionais que não estavam no plano original.

Depois de revisar o resumo da transformação, você pode visualizar as alterações que o Amazon Q está propondo em uma visualização de comparação de arquivos. Qualquer alteração de código sugerida pela Amazon Q não afetará seus arquivos de projeto atuais até que você aceite as alterações. O código transformado está disponível até 24 horas após a conclusão da transformação.

Concluindo transformações parcialmente bem-sucedidas

Dependendo da complexidade e das especificidades da sua base de código, pode haver casos em que a transformação seja parcialmente bem-sucedida. Isso significa que o Amazon Q conseguiu transformar somente determinados arquivos ou áreas de código em seu projeto. Nesse caso, você precisa atualizar manualmente o código restante para que seu projeto possa ser compilado na versão atualizada do idioma.

Para ajudar a transformar o resto do seu código, você pode usar o Amazon Q chat noIDE. Você pode pedir à Amazon Q que revise os arquivos parcialmente atualizados e forneça um novo código para resolver problemas, como erros de compilação. Você também pode usar recursos como /deve @workspacepara incluir mais do seu projeto como contexto e obter sugestões para vários arquivos ao mesmo tempo.