Pular para o conteúdo principal

Trabalhar com pull requests no Agent Manager

Quando a branch de um worktree tem um pull request no GitHub, o Agent Manager mostra as verificações, os comentários de revisão e o status de merge ao lado da sessão. Envie falhas e comentários ao agente, responda aos revisores e faça o merge sem sair do VS Code.

Antes de começar​

Os recursos de pull request usam o GitHub CLI.

  1. Instale o GitHub CLI.
  2. Execute gh auth login em um terminal e conclua o login.

Se o CLI não estiver instalado ou estiver desconectado, o Agent Manager mostra GitHub CLI not installed (GitHub CLI não instalado) ou GitHub authentication required (Autenticação do GitHub necessária) no lugar do status do pull request.

Abrir o painel do pull request​

Selecione um worktree cuja branch tenha um pull request e pressione Ctrl+Shift+R (Cmd+Shift+R no macOS) ou execute AI Cockpit: Agent Manager: Open Pull Request. O PR Summary mostra de relance as verificações, as aprovações e os comentários não resolvidos; selecione um item para ir até a seção correspondente. Use Copy PR link (Copiar link do PR) para compartilhá-lo.

Para começar a partir de um pull request existente, use a aba Import (Importar) ao criar um worktree e cole a URL dele.

Corrigir verificações que falharam​

Checks (Verificações) agrupa os resultados de CI em aprovadas, com falha, em execução, canceladas ou ignoradas. Para as verificações com falha:

  • Fix with AI Cockpit (Corrigir com AI Cockpit) envia as falhas ao agente na sessão do worktree.
  • Send failures to terminal (Enviar falhas para o terminal) cola as falhas no terminal do worktree.
  • Open check in browser (Abrir verificação no navegador) abre o log completo no GitHub.

Tratar comentários de revisão​

Comments (Comentários) lista as conversas de revisão, com as não resolvidas primeiro. Em cada conversa, você pode usar Reply (Responder), Resolve (Resolver) ou Unresolve (Desfazer resolução), adicionar uma reação, Show in diff (Mostrar no diff) ou Open on GitHub (Abrir no GitHub).

  • Selecione Fix with AI Cockpit para enviar um comentário, ou Fix N with AI Cockpit para enviar todos os comentários não resolvidos, ao agente.
  • Quando um revisor sugerir uma alteração, selecione Preview change (Pré-visualizar alteração) e depois Apply to worktree (Aplicar à worktree). A alteração é aplicada só no worktree, sem commit nem push; a conversa continua aberta até você resolvê-la.
  • Comentários cujas linhas não estão mais no diff aparecem em Comments outside the current diff (Comentários fora do diff atual).

Conversation (Conversa) mostra a linha do tempo do pull request e os comentários gerais. Use Dismiss (Descartar) em um comentário que você não pretende tratar ou envie os demais ao agente.

Deixar o agente atualizar o pull request​

Com Push Pull Request Fixes (Enviar correções do pull request) ativado, que é o padrão, o agente faz commit e push depois que você envia falhas de CI ou comentários de revisão, e o pull request é atualizado. Os pedidos de permissão continuam valendo. Desative essa opção em Settings → Agents (Configurações → Agentes) para fazer os commits manualmente.

Revisar o pull request você mesmo​

  1. Abra Files and review (Arquivos e revisão) e selecione Load PR files (Carregar arquivos do PR).
  2. Selecione uma linha, ou arraste por várias, para escrever um comentário de linha.
  3. Selecione Submit review (Enviar revisão), escreva o Review summary (Resumo da revisão) e escolha Comment (Comentar), Approve (Aprovar) ou Request changes (Solicitar alterações).

Não é possível aprovar nem solicitar alterações no seu próprio pull request, e as revisões só estão disponíveis para pull requests abertos.

Manter a branch atualizada e fazer o merge​

  • Update from base (Atualizar a partir da base) pede ao agente que busque e faça merge da branch base do worktree. Execute AI Cockpit: Agent Manager: Update from base ou digite /update-from-base na sessão do worktree.
  • Quando a branch estiver atrás da base, selecione Update branch (Atualizar branch). Quando houver conflitos de merge, selecione Fix with AI Cockpit.
  • Quando o pull request mostrar Ready to merge (Pronta para fazer o merge), escolha um método de merge (Create merge commit (Criar commit de merge), Squash and merge (Fazer squash e merge) ou Rebase and merge (Fazer rebase e merge)) e confirme. Selecione Enable auto-merge (Ativar auto-merge) para que o GitHub faça o merge assim que os requisitos forem atendidos.