# Pesquisar, planejar e iterar alterações de código com Copilot cloud agent

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.

Copilot cloud agent permite que você:

* **Pesquise** um repositório fazendo Copilot perguntas.
* **Planeje** e refine uma abordagem antes Copilot de fazer alterações.
* ```
            **Iterar** em alterações de código, examinar uma diferença e **criar uma pull request quando estiver pronto**.
  ```

As sessões não criam solicitações de pull automaticamente. Para criar um imediatamente, inclua-o no prompt, por exemplo, "Criar uma solicitação de pull para ...".

> \[!NOTE] Esses recursos só estão disponíveis com Copilot cloud agent em GitHub.com e no prévia pública para as integrações com Teams e Slack. Outras Cloud agent integrações (como Azure Boards, JIRA ou Linear) só dão suporte à criação de uma solicitação de pull diretamente.

## Realizar pesquisas profundas

Faça Copilot cloud agent perguntas sobre um repositório para entender como ele funciona, encontrar onde fazer uma alteração ou confirmar suposições antes do planejamento.

1. Inicie uma tarefa pela aba Agentes, pelo painel, pelo dashboard, Copilot Chat ou de dentro de uma integração compatível. Consulte [Iniciar uma tarefa com Copilot agentes em GitHub](/pt/copilot/how-tos/copilot-on-github/use-copilot-agents/kick-off-a-task).
2. Faça uma pergunta sobre o repositório.

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

   > \[!TIP] Você também pode abrir Copilot Chat e anexar o repositório relevante como contexto.
   > Copilot solicita que você aprove uma sessão de pesquisa profunda.
3. Opcionalmente, envie prompts de acompanhamento enquanto Copilot estiver trabalhando para orientar a sessão.
4. Examine a resposta e faça perguntas de acompanhamento.

## Criar um plano

Peça Copilot cloud agent para propor um plano antes de fazer alterações.

1. Descreva o plano desejado.

   Por exemplo: `Create a plan to implement the most impactful performance improvements for this app.`
2. Revise o plano e itere com Copilot até que corresponda à sua intenção.

## Iterar em alterações de código

Após a pesquisa e o planejamento, faça alterações em uma ramificação, examine a diferença e decida se deseja iterar mais ou criar uma pull request.

1. Descreva as alterações desejadas no prompt.

   Por exemplo, faça referência ao plano anterior: `Implement the plan we agreed upon.`
2. Aguarde que o Copilot conclua a sessão.
3. Clique em **Diferenças** para examinar as alterações.
4. Opcionalmente, abra a ramificação (`copilot/BRANCH-NAME`) para inspecionar as alterações no contexto.
5. Para solicitar refinamentos, continue a conversação. Por exemplo: `Rename this to match our existing conventions.`
6. Quando a sessão for concluída e você estiver satisfeito, clique em **Criar solicitação de pull**.

## Fornecer contexto visual

Cloud agent processa imagens, como capturas de tela, esboços ou designs, como parte da descrição da tarefa. Arraste e solte uma imagem no texto do problema, ou em um prompt do Copilot Chat, e descreva o que o Copilot deve fazer com ela.

## Leitura adicional

* [Sobre o agente de nuvem do GitHub Copilot](/pt/copilot/concepts/agents/cloud-agent/about-cloud-agent)