Revise sua primeira pull request

O que você vai construir

Ao final deste tutorial, você terá:

• Aberto uma pull request no ambiente de trabalho de PR do Control Center
• Lido o diff dela e deixado um comentário em linha
• Enviado um veredito de revisão
• Feito o merge da PR

Pré-requisitos: Despache seu primeiro agente concluído e uma pull request aberta em um repo registrado neste espaço de trabalho. Para as etapas de revisão, escolha uma PR que você não abriu — o botão Revisão fica oculto nas suas próprias PRs. O merge ainda funciona em uma PR de sua autoria.

Etapa 1: Abrir a pull request

1. Clique em Pull requests na barra lateral
2. Encontre a sua PR e clique nela

Ponto de verificação: a PR abre como um ambiente de trabalho com abas — Visão geral, Diff, Controle de versão, Chat, Ações — focada em Visão geral: o título e as ações, a descrição e a linha do tempo de atividades e uma barra lateral com status, revisores, responsáveis, verificações e arquivos alterados. Clicar em um arquivo ali leva direto para ele na aba Diff. A aba Revisão não fica aberta até alguém pedir uma revisão com IA.

Fila vazia com um aviso para conectar o GitHub

Esse estado significa que o servidor não tem nenhum token do GitHub — seu cliente nunca tem um. Defina um em Configurações → Espaço de trabalho → Perfil e identidade → Hospedagem de código e atualize a lista.

Etapa 2: Ler o diff

Abra a aba Diff. Uma árvore de arquivos recolhível fica à esquerda, e a faixa acima do diff traz um seletor de intervalo de commits — restrinja o diff a um commit ou a um intervalo deles — além da contagem de arquivos e das adições e exclusões acumuladas.

O botão de configurações na barra de ferramentas do diff controla como ele é renderizado:

• Exibição dividida ou unificada
• Quebrar linhas ou rolar as linhas longas
• Ligaduras da fonte de código

Marque um arquivo como visto para acompanhar seu progresso em um diff grande. A navegação por teclado está em Atalhos de teclado.

Etapa 3: Deixar um comentário em linha

1. Passe o mouse sobre uma linha no diff — uma pequena pílula + aparece na margem
2. Clique nela para comentar naquela linha, ou arraste-a verticalmente antes para selecionar um intervalo
3. Digite o seu comentário. O campo de comentário oferece dois envios:
   • Iniciar uma revisão (ou Adicionar à revisão, se já houver uma revisão em andamento) enfileira o comentário. A conversa mostra Revisão pendente até você enviar um veredito na etapa 4.
   • Adicionar um único comentário publica no GitHub imediatamente. A conversa mostra Publicando…, depois Sincronizado, e oferece uma nova tentativa se a publicação falhar.

Para este tutorial, use Iniciar uma revisão para que o comentário saia junto com o veredito.

Um comentário enfileirado ainda não está no GitHub

Iniciar uma revisão / Adicionar à revisão mantêm o comentário localmente até você enviar um veredito. Apenas Adicionar um único comentário publica imediatamente. O corpo da revisão que você escreve na etapa 4 é um rascunho separado.

Etapa 4: Enviar uma revisão

1. Clique em Revisão na linha de ações da Visão geral — o mesmo botão também fica na barra de ferramentas da aba Diff. Ele fica oculto em PRs de sua autoria e em uma PR fechada ou já mesclada.
2. Escreva um resumo no campo de comentário. Ele é salvo automaticamente como rascunho, então você pode fechar o overlay e voltar depois.
3. Escolha um veredito:
   • Solicitar alterações
   • Comentário
   • Aprovar

O veredito é o botão. Depois de Aprovar ou Solicitar alterações, o botão muda de rótulo para Aprovado ou Alterações solicitadas. Um veredito Comentário deixa o botão com o rótulo Revisão.

Ponto de verificação: o botão exibe “Aprovado” ou “Alterações solicitadas” se você escolheu uma dessas duas opções.

Etapa 5: Fazer merge

O botão Merge aparece sempre que o GitHub informa que a PR pode ser mesclada — ele não depende da sua própria aprovação. A cor dele indica prontidão, e não permissão: primária quando as aprovações obrigatórias e as verificações estão verdes, secundária enquanto uma verificação ainda está em execução, destrutiva quando um revisor solicitado não aprovou ou uma verificação está falhando.

1. Clique em Merge
2. Escolha um método: Squash and merge, Create a merge commit ou Rebase and merge
3. Nos dois primeiros, edite o título e a mensagem de commit preenchidos previamente
4. Confirme

Qualquer problema pendente — “Verificações com falha”, “Some reviews are pending” — é listado no painel flutuante antes de você confirmar.

Fazer merge é irreversível

Fazer merge envia commits para o GitHub. Ele nunca entra na pilha de desfazer do Control Center e não pode ser desfeito daqui.

Depois do merge, um evento de domínio PrMerged é disparado; a análise e as notificações o consomem. Consulte Eventos de domínio para saber o que mais o escuta.

Revisar com IA

O Control Center pode colocar um pipeline de revisores em uma PR aberta, mas apenas quando você pedir: o modelo pr_review tem um gatilho manual e nada mais.

1. Abra o menu de overflow na linha de ações da Visão geral e escolha Ask AI. O Control Center inicia a execução e abre a aba Revisão, para você acompanhar o trabalho dos especialistas.
2. Os agentes revisores registram os achados como nós de revisão no espaço da PR; uma etapa final os consolida em um único relatório.

O pipeline de propósito não publica no GitHub — ele termina depois de consolidar. A publicação é um passo separado, que você mesmo dá, com o botão Publicar no GitHub na aba Revisão. Consulte Usar revisão com IA.

Recapitulação

Você abriu uma PR no ambiente de trabalho, leu o diff com realce de sintaxe, deixou um comentário em linha, enviou um veredito e fez o merge — sem sair do app.

A seguir: Crie seu primeiro pipeline para automatizar fluxos de trabalho com várias etapas.