Gerenciando agentes de nuvem

Ao utilizar as funcionalidades de agentes do GitHub, você pode usar a guia Agentes em um repositório onde existam Agente de nuvem Copilot habilitado para iniciar, monitorar e gerenciar sessões dos agentes sem sair do fluxo de trabalho. Você também pode usar a página Agentes para exibir e iniciar sessões de agente. Para saber como ativar Agente de nuvem Copilot, consulte Gerenciando o acesso ao agente de nuvem do GitHub Copilot.

1. Selecione um repositório e escolha seu agente

1. Inicie uma nova tarefa de agente.

   • Abrir a aba Agentes em um repositório
   • Abra a página Agents
   • Use o botão Tarefa ou o comando /taskChat Copilot
   • Abra o painel Agentes clicando na parte superior de qualquer página em GitHub

2. Usando o menu suspenso, selecione o repositório no qual você deseja que o agente de nuvem funcione.

3. Opcionalmente, selecione um branch base para o pull request de Copilot.

4. Opcionalmente, você pode clicar para abrir o menu suspenso do agente, se quiser atribuir um agente ou um agente personalizado com ferramentas e comportamento especializados. Você pode selecionar um existente agente personalizado do seu repositório, organização ou empresa. Você também pode clicar em Criar um agente para criar um novo perfil do agente em seu repositório e branch selecionados. Para saber mais, confira Criando agentes personalizados para Agente de nuvem Copilot.

   Observação

   Agentes de codificação de terceiros estão disponíveis nos planos GitHub Copilot Pro+ e Copilot Enterprise.

5. Opcionalmente, selecione o menu suspenso CURRENT-MODEL e clique no modelo de IA de sua escolha.

6. Digite um prompt descrevendo sua solicitação. Por exemplo:

   Implement a user-friendly message for common errors.
   

7. Clique ou pressione Enter.

          Copilot iniciará o trabalho na tarefa e começará a enviar alterações por push para uma nova solicitação de pull, na qual ela adicionará você automaticamente como revisor.
   

Para obter mais informações sobre maneiras de iniciar novas tarefas de agente, consulte Solicitando GitHub Copilot para criar uma solicitação de pull.

2. Monitorar a atividade do agente

Depois que o agente começar a trabalhar, ele continuará a atualizar o log de sessão e a visão geral com seu progresso e processo de pensamento.

Cada sessão exibe seu status. Clique em uma sessão para abrir o log de sessão, onde você pode monitorar o progresso do agente, ver as ferramentas que ele está usando e acompanhar por quanto tempo a sessão está em execução.

          Agente de nuvem Copilot as sessões também podem ser rastreadas nas IDEs GitHub CLI, GitHub Mobile, Visual Studio Code, Raycast e JetBrains. Para obter mais informações, confira [AUTOTITLE](/copilot/how-tos/use-copilot-agents/coding-agent/track-copilot-sessions).

3. Redirecionar agentes conforme necessário

Você pode intervir e fornecer comando de direção sem Copilot interromper o processo. O controle usa uma solicitação premium por mensagem.

Os motivos pelos quais você pode querer orientar uma sessão incluem:

•         Copilot parece estar indo na direção errada, e você quer dar-lhe mais clareza.
  

• Você cometeu um erro na descrição do trabalho necessário e decidiu recomeçar.

Na caixa de prompt no log de sessão do agente, indique Copilot enquanto está trabalhando em uma tarefa. Por exemplo:

Use our existing ErrorHandler utility class instead of writing custom try-catch blocks for each endpoint.

          Copilot começará a implementar sua entrada após concluir a chamada da ferramenta atual.

4. Abra uma sessão de agente em seu ambiente de desenvolvimento local

Você pode orientar o agente em seu ambiente de desenvolvimento local sobre outras alterações ou fazer edições que exijam experiência humana.

VS Code

Na parte inferior do modo de exibição de sessão do agente, clique no botão Abrir em VS Code para iniciar a sessão diretamente em VS Code.

CLI do GitHub Copilot

1. Na parte inferior da visualização da sessão do agente, clique na lista suspensa ao lado de Abrir em VS Code.

2. Clique em CLI do GitHub Copilot para copiar o copilot --resume=SESSION-ID comando para a área de transferência.

        ![Captura de tela da lista suspensa de ações da sessão, "Continuar na CLI do Copilot" está realçada com um contorno laranja escuro.](/assets/images/help/copilot/coding-agent/open-agent-session-in-copilot-cli.png)
   

3. No terminal, cole e execute o comando para retomar a sessão do agente.

5. Revisar e mesclar o código do agente

Depois que o agente concluir uma sessão, você poderá navegar até a solicitação de pull para examinar as alterações. Na solicitação de pull, você pode verificar a diferença, solicitar melhorias adicionais ou aprovar e mesclar as alterações. Confira Revisar uma solicitação de pull criada por GitHub Copilot.

6. Arquivar sessões do agente

As sessões que foram interrompidas podem ser arquivadas para removê-las da lista de sessões.

1. Abra a sessão do agente que você deseja arquivar.
2. No canto superior direito, clique e clique em Arquivar sessão.
3. Na caixa de diálogo que é aberta, clique em Sim, arquivar.