Usando o GitHub Copilot para criar ou atualizar problemas

Use o Copilot para gerar rapidamente problemas estruturados e de alta qualidade baseados em imagens ou linguagem natural, sem preencher todos os campos manualmente.

Quem pode usar esse recurso?

Anyone with a Copilot license can use Copilot to create issues or update existing issues.
Try Copilot for free

Neste artigo

Observação

Esse recurso está em versão prévia pública e sujeitos a alterações.

Criar ou atualizar problemas manualmente pode ser repetitivo e demorado. Com o Copilot}, você pode criar ou atualizar problemas mais rapidamente solicitando em linguagem natural ou até carregando uma captura de tela. O Copilot preenche o título, o corpo, os rótulos, os atributos e muito mais, usando os formulários ou modelos de problema do repositório.

Você mantém o controle do processo. Você pode revisar e aperfeiçoar o que o Copilot} sugere antes de enviar o problema novo ou atualizado.

Criando um problema com o Copilot

Você pode criar problemas de Bate-papo do Copiloto} no GitHub}.

  1. Acesse o Bate-papo do Copiloto} (https://github.com/copilot.

  2. Na caixa de prompt, descreva o problema que você deseja criar.

    Se você contribuir com problemas para vários repositórios, use o formato repo-owner/repo-name para especificar o repositório de destino para esse problema. Se você não especificar um repositório, o Copilot inferirá com base no repositório no qual você criou um problema pela última vez.

    Por exemplo:

    • Em OWNER/REPOSITORY, crie uma solicitação de recurso para adicionar correspondência difusa à pesquisa.

    • Registre um bug para um erro 500. Isso acontece consistentemente quando tento fazer logon no site.

    • Crie uma tarefa para alterar o plano de fundo do logotipo do aplicativo para vermelho e adicione o rótulo "precisa de revisão de design".

    • No octo-org/octo-repo, crie um problema e adicione snippets de código relevantes para melhorar o formato de resposta da API.

    Observação

    Você só pode usar o Copilot para criar problemas em repositórios onde já tem permissão para criar problemas. Esse recurso não altera o acesso nem ignora as permissões do repositório.

  3. Como alternativa, você pode usar um dos seguintes métodos para incluir uma imagem em seu prompt:

    • Copie uma imagem e cole-a na caixa de prompt na parte inferior da página.
    • Clique em na caixa de prompt e clique em Image. Navegue até o arquivo de imagem que deseja anexar, selecione-o e clique em Open.
    • Arraste e solte um arquivo de imagem do explorador de arquivos do sistema operacional para a caixa de prompt.

    Depois de colar ou carregar a imagem, você pode adicionar texto ao prompt, por exemplo: Create an issue because this error appears when trying to reset a password.

  4. O Copilot criará um problema que inclui:

    • Um título sugerido.

    • Detalhes das alterações necessárias.

      Se o repositório tiver formulários ou modelos de problema, o Copilot escolherá um formulário ou modelo apropriado com base no prompt. Se não houver formulários ou modelos, o Copilot criará um corpo de problema básico para os detalhes do problema.

      Se o Copilot usar um formulário de problema, ele dividirá as informações em seu prompt nos campos relevantes do formulário sem perder nenhum dado. O Copilot solicitará que você forneça contexto adicional se houver campos que não tenham informações suficientes para preencher.

    Com base no prompt, o Copilot também poderá sugerir metadados, como rótulos, destinatários e tipo de problema.

  5. Revise o rascunho. É possível:

    • Edite qualquer parte do problema manualmente.
    • Escolha um formulário ou modelo de problema diferente sem perder sua entrada. O Copilot reformata o conteúdo de acordo com o formulário ou modelo escolhido.
    • Peça ao Copilot para fazer alterações com um prompt de acompanhamento.

  6. Quando o problema parecer bom, clique em Create.

Criando vários problemas de uma só vez

Se o prompt incluir várias tarefas ou bugs, o Copilot poderá elaborar mais de um problema por vez.

Por exemplo: em PROPRIETÁRIO/REPOSITÓRIO, crie 3 problemas: 1) DETALHES DE UMA TAREFA, 2) DETALHES DE OUTRA TAREFA, 3) DETALHES DE UMA TERCEIRA TAREFA

Cada rascunho é exibido separadamente e você pode revisá-los e editá-los individualmente. Para publicar os problemas, clique em Create em cada que deseja enviar.

Como criar sub-problemas

Você pode usar o Copilot para criar rascunhos de vários sub-problemas.

Por exemplo:

In octo-org/octo-repo, plan a new user dashboard. Break it down into an epic, and create sub-issues for each main feature and task.

O Copilot gera uma árvore de problemas de rascunho, com um problema pai no nível superior e sub-problemas abaixo.

Você pode examinar a árvore de problemas, expandir ou recolher sub-problemas e editar os detalhes de cada problema.

Clique no problema pai para exibir seus detalhes no workbench. O problema pai exibe uma lista de subconjunto. Você pode clicar em cada um deles para exibir e editar seus detalhes no workbench. Em um subconjunto, use a lista suspensa "Pai" para navegar pela árvore de problemas. Você também pode clicar em Examinar e criar na parte superior do workbench para ver a árvore de problemas completa e navegar diretamente para qualquer problema.

O Copilot pode modificar a árvore, desvinculando problemas ou anexando novos rascunhos.

Por exemplo, você pode:

  • Remova um subproblema da árvore de problemas: Remove sub-issue NAME_OF_ISSUE from the issue tree
  • Adicione um subconjunto adicional à árvore de problemas: Add an additional sub-issue with ISSUE_DETAILS to the issue tree

Depois de terminar de editar os rascunhos e estar pronto para publicar os problemas, clique em Examinar e criar e clique em Criar problema.

Atualizando um problema existente

Você pode usar o Copilot} para atualizar os problemas existentes em seu repositório.

Por exemplo:

In octo-org/octo-repo, update issue #123 to add more details about the bug and steps to reproduce it. Also, change the label to "bug" and assign it to @username.

Copilot elabora a tarefa/questão atualizada, que você pode examinar e editar na bancada de trabalho. Para publicar as alterações, clique em Atualizar.

Trabalhando com os tópicos principais e os subtópicos existentes

Você pode usar o Copilot para conectar novos problemas a problemas que já existem em seu repositório.

Por exemplo, você pode:

  • Adicione um subconjunto a um problema pai existente: Create a sub-issue for octo-org/octo-repo issue #456.
  • Adicione um problema pai a um problema existente: Create a parent issue for octo-org/octo-repo issue #456.
  • Adicione um problema pai a vários problemas existentes: Create a parent issue for octo-org/octo-repo issues #456, #457, and #458.

O rascunho é exibido no workbench, no qual você pode revisá-lo e editá-lo. Para publicar o problema, clique em Examinar e criar e clique em Criar problemas.

Atribuindo problemas ao Copilot

Para atribuir um problema ao Copilot, você precisa ter o Agente de codificação do Copilot habilitado. Confira Como gerenciar o acesso ao agente de codificação do GitHub Copilot.

Você pode atribuir o problema durante a criação de uma das duas maneiras:

  •           **Linguagem natural:** solicita a Copilot} algo como `Assign this issue to Copilot.`

  •           **Manualmente:** selecione "Copilot}" na lista de destinatários.

Após o problema ser atribuído e criado, o Copilot começará a trabalhar nele automaticamente. Você verá uma reação com emoji 👀 no problema para indicar que o Copilot está trabalhando nele.

Leitura adicional

  •           [AUTOTITLE](/communities/using-templates-to-encourage-useful-issues-and-pull-requests/configuring-issue-templates-for-your-repository)

  •           [AUTOTITLE](/copilot/tutorials/plan-a-project)