Pesquisar, planejar e iterar em relação a alterações de código com o agente na nuvem Copilot

Execute uma pesquisa profunda em um repositório, crie um plano de implementação e faça alterações de código iterativas em um branch e crie uma solicitação de pull quando estiver pronto.

Quem pode usar esse recurso?

O Agente de nuvem Copilot está disponível com os planos GitHub Copilot Pro, GitHub Copilot Pro+, GitHub Copilot Business e GitHub Copilot Enterprise. O agente está disponível em todos os repositórios armazenados no GitHub, exceto os repositórios pertencentes ao contas de usuário gerenciadas e em locais em que foi explicitamente desabilitado.
Sign up for Copilot

Neste artigo

Introdução

Você pode usar Assistente de nuvem Copilot (anteriormente conhecido como assistente de codificação Copilot) para:

  • Realize uma pesquisa profunda em um repositório fazendo Copilot perguntas.
  •         **Planeje** e refine uma abordagem antes Copilot de fazer alterações.

  •         **Iterar** em alterações de código em um branch, examinar uma diferença e criar Copilot apenas **uma solicitação de pull quando estiver pronto**.

        Agente de nuvem Copilot
        *não abrirá* automaticamente uma solicitação pull como parte da sessão. Se *você quiser*Copilot abrir uma solicitação de pull para sua tarefa imediatamente, poderá solicitar explicitamente uma no prompt. Por exemplo, informando **"Criar uma solicitação de pull para ..."**.

Observação

Pesquisa profunda, planejamento e iteração na preparação de alterações de código antes de submeter uma solicitação de pull só estão disponíveis com Agente de nuvem Copilot no GitHub.com. Agente de nuvem integrações (como Azure Boards, JIRA, Linear, Slack ou Teams) só dão suporte à criação de uma solicitação de pull diretamente.

Realizando pesquisas profundas

Você pode fazer Agente de nuvem Copilot perguntas sobre um repositório para entender como ele funciona, identificar onde fazer uma alteração ou confirmar suposições antes do planejamento e da implementação. Copilot inicia uma sessão de pesquisa aprofundada para examinar o repositório e retornar uma resposta fundamentada.

  1. Abra o painel ou a guia de agentes:

    • No repositório, abra a aba Agentes.
    •           **Navegue até a página de agentes**: acesse [github.com/copilot/agents](https://github.com/copilot/agents?ref_product=copilot&ref_type=engagement&ref_style=text). Você também pode chegar aqui abrindo o painel de agentes e clicando em **Exibir tudo**.

    •      **Abra o painel de agentes**: clique em <svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-agent" aria-label="The Agents icon" role="img"><path d="M14.5 8.9v-.052A2.956 2.956 0 0 0 11.542 5.9a.815.815 0 0 1-.751-.501l-.145-.348A3.496 3.496 0 0 0 7.421 2.9h-.206a3.754 3.754 0 0 0-3.736 4.118l.011.121a.822.822 0 0 1-.619.879A1.81 1.81 0 0 0 1.5 9.773v.14c0 1.097.89 1.987 1.987 1.987H4.5a.75.75 0 0 1 0 1.5H3.487A3.487 3.487 0 0 1 0 9.913v-.14C0 8.449.785 7.274 1.963 6.75A5.253 5.253 0 0 1 7.215 1.4h.206a4.992 4.992 0 0 1 4.586 3.024A4.455 4.455 0 0 1 16 8.848V8.9a.75.75 0 0 1-1.5 0Z"></path><path d="m8.38 7.67 2.25 2.25a.749.749 0 0 1 0 1.061L8.38 13.23a.749.749 0 1 1-1.06-1.06l1.719-1.72L7.32 8.731A.75.75 0 0 1 8.38 7.67ZM15 13.45h-3a.75.75 0 0 1 0-1.5h3a.75.75 0 0 1 0 1.5Z"></path></svg> na barra de navegação no canto superior direito de GitHub.

  2. Faça uma pergunta sobre o repositório.

    Por exemplo: Investigate performance issues in this app and suggest improvements.

    Dica

    Como alternativa, abra Chat Copilot e anexe o repositório relevante como contexto e peça Chat Copilot para fazer pesquisas. Você será solicitado a aprovar uma sessão de pesquisa profunda.

  3. Opcionalmente, envie prompts adicionais enquanto Copilot estiver trabalhando para orientar a sessão.

  4. Examine a resposta e faça perguntas de acompanhamento.

Criando um plano

Você pode solicitar que Agente de nuvem Copilot proponha um plano antes de fazer alterações, bastando instruir o agente.

  1. Peça ao agente para criar um plano.

    Por exemplo: Create a plan to implement the most impactful performance improvements for this app.

  2. Revise o plano e iterar com Copilot até que ele corresponda ao que você deseja.

Iterando em alterações de código

Após a pesquisa e o planejamento, você pode fazer alterações em uma ramificação, examinar o diff e decidir se deseja iterar mais ou criar um pull request.

  1. Peça ao agente para implementar alterações descrevendo o que você deseja Copilot fazer em seu prompt.

    Por exemplo, você pode referenciar o plano que você projetou anteriormente: Implement the plan we agreed upon.

  2.        Copilot inicia uma sessão para fazer as alterações necessárias.

  3. Depois que a sessão for concluída, clique em Diff para examinar as alterações.

  4. Opcionalmente, abra o branch (copilot/BRANCH-NAME) que Copilot criou para inspecionar as mudanças no contexto.

  5. Se você quiser refinamentos, poderá continuar a conversa e pedir que o agente ajuste o trabalho. Por exemplo: Rename this to match our existing conventions.

  6. Continue iterando até que você esteja satisfeito com a ramificação.

  7. Quando estiver satisfeito com os resultados e quando a sessão for concluída, clique em Criar solicitação de pull.

Leitura adicional

  •         [AUTOTITLE](/copilot/concepts/about-copilot-coding-agent)

  •         [AUTOTITLE](/copilot/how-tos/use-copilot-agents/coding-agent/create-a-pr)

  •         [AUTOTITLE](/copilot/how-tos/use-copilot-agents/coding-agent/create-custom-agents)