As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
Criando um problema no CodeCatalyst
As equipes de desenvolvimento criam problemas para ajudar a monitorar e gerenciar seu trabalho. Você pode criar problemas em um projeto com base nas suas necessidades. Por exemplo, você pode criar um problema para rastrear a atualização de uma variável no seu código. Você pode atribuir problemas a outros usuários no projeto, usar rótulos para ajudá-lo a monitorar seu trabalho e muito mais.
Siga estas instruções para criar um problema no CodeCatalyst.
Para criar um problema
Abra o CodeCatalyst console em https://codecatalyst.aws/
. -
Navegue até o projeto em que você deseja criar um problema.
-
Na página inicial do projeto, escolha Criar problema. Como alternativa, no painel de navegação, escolha Problemas.
-
Escolha Criar problema.
nota
Você também pode adicionar problemas em linha ao usar uma visualização em grade.
-
Insira um título para a edição.
-
(Opcional) Insira uma descrição. Você pode usar o Markdown para adicionar formatação.
-
(Opcional) Escolha um status, prioridade e estimativa para o problema.
nota
Se a configuração de estimativa do projeto estiver definida como Ocultar estimativas, não haverá um campo Estimativa.
-
(Opcional) Adicione tarefas ao problema. As tarefas podem ser usadas para dividir o trabalho de um problema em objetivos menores. Para adicionar uma tarefa, escolha + Adicionar tarefas. Em seguida, insira o nome da tarefa no campo de texto e pressione enter. Depois de adicionar tarefas, você pode marcá-las como concluídas escolhendo a caixa de seleção ou reordená-las escolhendo e arrastando a tarefa do lado esquerdo da caixa de seleção.
-
(Opcional) Adicione uma etiqueta existente ou crie uma nova etiqueta e adicione-a escolhendo + Adicionar etiqueta.
-
Para adicionar uma etiqueta existente, escolha a etiqueta na lista. Você pode inserir um termo de pesquisa no campo para pesquisar todos os rótulos que contêm esse termo no projeto.
-
Para criar um novo rótulo e adicioná-lo, digite o nome do rótulo que você deseja criar no campo de pesquisa e pressione enter.
-
-
(Opcional) Adicione um destinatário escolhendo + Adicionar um destinatário. Você pode se adicionar rapidamente como destinatário escolhendo + Me adicionar.
dica
Você pode escolher atribuir um problema ao Amazon Q para que o Amazon Q tente resolver o problema. Para obter mais informações, consulte Tutorial: Usando recursos CodeCatalyst generativos de IA para acelerar seu trabalho de desenvolvimento. Esse recurso está disponível somente na região Oeste dos EUA (Oregon).
Essa funcionalidade exige que recursos generativos de IA estejam habilitados para o espaço. Para obter mais informações, consulte Gerenciamento de recursos generativos de IA.
-
(Opcional) Adicione um campo personalizado existente ou crie um novo campo personalizado. Os problemas podem ter vários campos personalizados.
-
Para adicionar um campo personalizado existente, escolha o campo personalizado na lista. Você pode inserir um termo de pesquisa no campo para pesquisar todos os campos personalizados que contêm esse termo no projeto.
-
Para criar um novo campo personalizado e adicioná-lo, digite o nome do campo personalizado que você deseja criar no campo de pesquisa e pressione enter. Em seguida, escolha o tipo de campo personalizado que você deseja criar e defina um valor.
-
-
Escolha Criar problema. Uma notificação aparece no canto inferior direito: se o problema foi criado com sucesso, uma mensagem de confirmação será exibida informando que o problema foi criado com sucesso. Se o problema não tiver sido criado com êxito, uma mensagem de erro com o motivo da falha será exibida. Em seguida, você pode escolher Tentar novamente para editar e tentar criar o problema novamente ou escolher Descartar para descartar o problema. Ambas as opções ignorarão a notificação.
nota
Você não pode vincular uma pull request a um problema ao criá-la. No entanto, você pode editá-lo depois de criá-lo para adicionar links às pull requests.
Melhores práticas ao criar e trabalhar com problemas atribuídos ao Amazon Q
Quando você cria problemas, às vezes alguns deles persistem. As causas para isso podem ser complexas e variáveis. Às vezes, é porque não está claro quem deve trabalhar nisso. Outras vezes, o problema exige pesquisa ou experiência em uma parte específica da base de código e os melhores candidatos para o trabalho estão ocupados com outros problemas. Freqüentemente, há outros trabalhos urgentes que devem ser realizados primeiro. Qualquer uma ou todas essas causas podem resultar em problemas que não foram resolvidos. CodeCatalyst inclui integração com um assistente generativo de IA chamado Amazon Q, que pode analisar um problema com base no título e na descrição. Se você atribuir o problema à Amazon Q, ela tentará criar um rascunho de solução para você avaliar. Isso pode ajudar você e sua equipe a se concentrarem e otimizarem o trabalho em questões que exigem sua atenção, enquanto o Amazon Q trabalha em uma solução para problemas que você não tem recursos para resolver imediatamente.
nota
nota
Desenvolvido pelo Amazon Bedrock: AWS implementa a detecção automática de abusos. Como os recursos Escrever descrição para mim, Criar resumo de conteúdo, Recomendar tarefas, Usar o Amazon Q para criar ou adicionar recursos a um projeto e Atribuir problemas ao Amazon Q com o Amazon Q Developer Agent para recursos de desenvolvimento de software são criados no Amazon Bedrock, os usuários podem aproveitar ao máximo os controles implementados no Amazon Bedrock para reforçar a segurança e o uso responsável da inteligência artificial (IA).
O Amazon Q tem melhor desempenho em questões simples e problemas simples. Para obter melhores resultados, use uma linguagem simples para explicar claramente o que você quer que seja feito. A seguir estão algumas das melhores práticas para ajudar você a criar problemas otimizados para o Amazon Q trabalhar.
Importante
Os recursos generativos de IA estão disponíveis somente na região Oeste dos EUA (Oregon).
-
Mantenha as coisas simples. O Amazon Q se sai melhor com alterações e correções simples de código que podem ser explicadas no título e na descrição do problema. Não atribua problemas com títulos vagos ou descrições excessivamente exageradas ou contraditórias.
-
Seja específico. Quanto mais informações você puder fornecer sobre as alterações exatas necessárias para resolver o problema, maior a probabilidade de o Amazon Q criar uma solução que resolva o problema. Se possível, inclua detalhes específicos, como o nome APIs que você deseja alterar, os métodos que deseja atualizar, os testes que precisam de alterações e quaisquer outros detalhes que você possa imaginar.
-
Certifique-se de ter todos os detalhes incluídos no título e na descrição do problema antes de atribuí-lo ao Amazon Q. Você não pode alterar o título ou a descrição de uma edição depois de atribuí-la à Amazon Q, portanto, certifique-se de ter todas as informações necessárias em uma edição antes de atribuí-la à Amazon Q.
-
Atribua somente problemas que exijam alterações de código em um único repositório de origem. O Amazon Q só pode trabalhar com código em um único repositório de origem em CodeCatalyst. Não há suporte para repositórios vinculados. Certifique-se de que o problema exija apenas alterações em um único repositório de origem antes de atribuí-lo ao Amazon Q.
-
Use o padrão sugerido pela Amazon Q para aprovar cada etapa. Por padrão, o Amazon Q exigirá sua aprovação para cada etapa realizada. Isso permite que você interaja com o Amazon Q em comentários não apenas sobre o problema, mas também sobre qualquer pull request criado por ele. Isso proporciona uma experiência mais interativa com o Amazon Q, que ajuda você a ajustar sua abordagem e refinar o código que ele cria para resolver o problema.
nota
O Amazon Q não responde a comentários individuais sobre problemas ou pull requests, mas os revisará quando solicitado a reconsiderar sua abordagem ou criar uma revisão.
-
Sempre analise cuidadosamente a abordagem sugerida pela Amazon Q. Depois de aprovar sua abordagem, a Amazon Q começará a trabalhar na geração de código com base nessa abordagem. Certifique-se de que a abordagem pareça correta e inclua todos os detalhes que você espera antes de pedir à Amazon Q que continue.
-
Certifique-se de permitir que o Amazon Q trabalhe em fluxos de trabalho somente se você não tiver fluxos de trabalho existentes que possam implantá-los antes de serem revisados. Seu projeto pode ter fluxos de trabalho configurados para iniciar execuções em eventos de pull request. Nesse caso, qualquer pull request criada pela Amazon Q que inclua a criação ou atualização do fluxo de trabalho YAML pode iniciar uma execução desses fluxos de trabalho incluídos na pull request. Como prática recomendada, não escolha permitir que o Amazon Q trabalhe em arquivos de fluxo de trabalho, a menos que tenha certeza de que não há fluxos de trabalho em seu projeto que executem automaticamente esses fluxos de trabalho antes de você revisar e aprovar a pull request criada por ele.
Para obter mais informações, consulte Tutorial: Usando recursos CodeCatalyst generativos de IA para acelerar seu trabalho de desenvolvimento Gerenciando recursos generativos de IA.
