Gerenciando agentes de codificação

Visualize o progresso do agente e mantenha-o na tarefa.

Quem pode usar esse recurso?

Coding agents are available with the GitHub Copilot Pro, GitHub Copilot Pro+, GitHub Copilot Business and GitHub Copilot Enterprise plans.
Sign up for Copilot

Neste artigo

Ao utilizar as funcionalidades de agentes do GitHub, você pode usar a guia Agentes em um repositório onde existam agente de codificação 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 Copilot, consulte Gerenciando o acesso ao agente de codificação 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
    • Abra a página Agents
    • Use o botão Task ou o comando /task do Chat Copilot
    • Abra o painel Agentes clicando no 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 codificação funcione.

  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 do agente se desejar atribuir um agente de codificação ou 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 para agente de codificação Copilot.

    Observação

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

  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 ou pressione Enter.

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 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.

As sessões agente de codificação Copilot também podem ser acompanhadas a partir do GitHub CLI, GitHub Mobile, Visual Studio Code, Raycast e JetBrains IDEs. Para obter mais informações, confira Acompanhamento das 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.

Observação

No momento, o direcionamento de uma sessão não está disponível para agentes de codificação de terceiros.

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 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 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.

Observação

Abrir uma sessão no VS Code requer as versões mais recentes do VS Code, a extensão GitHub Copilot e a extensão GitHub Pull Requests.

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.

         ![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 em , e clique em Arquivar sessão.
  3. Na caixa de diálogo que é aberta, clique em Sim, arquivar.