Gerenciando agentes de codificação do Copilot

Ao utilizar as funcionalidades de agentes do GitHub, você pode usar a guia Agentes em um repositório onde existam Agente de codificação do 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 codificação do Copilot, consulte Como gerenciar o acesso ao agente de codificação do GitHub Copilot.

1. Selecione um repositório e escolha seu agente

1. Inicie uma nova tarefa de agente.

   • No repositório, abra a aba Agentes
   • Abrir a página Agentes
   • Usar o Tarefa botão ou /task um comando de Bate-papo do Copiloto
   • Abra o painel Agentes clicando no na parte superior de qualquer página em GitHub

2. Usando o menu suspenso, selecione o repositório em que você deseja Copilot trabalhar, se necessário.

3. Você também pode selecionar um branch base para a pull request do Copilot.

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

5. Caso deseje, selecione o menu suspenso CURRENT-MODEL e, em seguida, 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 em Iniciar tarefa ou pressionar o Return.

Copilot iniciará o trabalho na tarefa e começará a fazer push das alterações para uma nova solicitação pull, na qual ele te adicionará automaticamente como revisor.

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

2. Monitorar a atividade do agente

Depois que Copilot começar a funcionar, ele continuará atualizando o log de sessão com seu progresso e processo de raciocínio.

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.

As sessões do agente também podem ser rastreadas nos IDEs GitHub CLI, GitHub Mobile, Visual Studio Code, Raycast e JetBrains. Para obter mais informações, confira Acompanhar sessões do GitHub Copilot.

3. Redirecionar agentes conforme necessário

Você pode intervir e fornecer entrada de direcionamento para Copilot sem interromper a execução. O controle usa uma solicitação premium por mensagem.

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

• O Copilot parece estar indo na direção errada e você deseja dar-lhe mais clareza.
• Você cometeu um erro na descrição do trabalho necessário e decidiu recomeçar.

Na caixa de solicitações no log de sessões do agente, faça uma solicitação para o Copilot enquanto ele está trabalhando em uma tarefa. Por exemplo:

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

O Copilot começará a implementar sua entrada depois de concluir sua chamada de ferramenta atual.

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

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

VS Code

Na parte inferior da visualização da sessão do agente, clique no botão Abrir no VS Code para abrir a sessão diretamente no VS Code.

CLI do GitHub Copilot

1. Na parte inferior da visão da sessão do agente, clique na lista suspensa ao lado de Abrir em VS Code.
2. Clique Continue em CLI do GitHub Copilot para copiar o copilot --resume=<session ID> comando para sua área de transferência.
   
3. No terminal, cole e execute o comando para retomar a sessão do agente.

5. Examinar e mesclar código do agente

Depois que Copilot 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 analisar o diff, solicitar melhorias adicionais de Copilot ou aprovar e mesclar as alterações. Confira Como revisar uma pull request criada pelo 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 em , e clique em Arquivar sessão.
3. Na caixa de diálogo que é aberta, clique em Sim, arquivar.