Triar a sua caixa de entrada

Este guia mostra-lhe como trabalhar na caixa de entrada: a superfície única que reúne tudo o que o bloqueia ou que o pede explicitamente — aprovações de agentes pendentes, sincronizações de tickets falhadas e todas as pull requests em que participa como revisor ou autor.

Abrir a caixa de entrada

1. Clique em Caixa de entrada na barra lateral. O respetivo distintivo conta aprovações de agentes pendentes, sincronizações falhadas e PRs abertas à espera da sua revisão.
2. Ou prima ⌘K e execute o comando de navegação Caixa de entrada.
3. Ou siga um link direto para /workspaces/<workspace-id>/inbox.

A entrada da barra lateral mostra sempre a contagem em direto, para que veja o trabalho de triagem a acumular-se sem abrir a página.

Ler a gravidade num relance

Percorra de cima para baixo; a caixa de entrada já está ordenada por urgência:

1. A faixa fixada Precisa da sua atenção fica acima das secções de PRs. Cada cartão traz um chip de gravidade. As origens registadas (um agente preso num pedido de confirmação, uma sincronização de tickets cujo espelho do fornecedor está desatualizado) emitem Bloqueado.
2. Dentro da faixa, a gravidade mais urgente vem primeiro; em caso de empate, ganha o item que está à espera há mais tempo.
3. Abaixo da faixa, as PRs são agrupadas em secções fixas do ciclo de vida de revisão — A aguardar a sua revisão, Devolvidas a você, Aprovadas, Rascunhos, A aguardar revisores, Em merge e fundidas recentemente, A aguardar o autor. As secções do topo são o que precisa de si; as restantes são onde estão as suas PRs. A aguardar a sua revisão inclui PRs que ainda pedem uma equipa a que pertence nas forges que as têm (o GitHub retira a equipa assim que qualquer membro da equipa reveja).

Um item só aparece na caixa de entrada quando bloqueia algo ou o pede explicitamente. Uma faixa vazia e uma lista de secções vazia só mostram Você está em dia quando esse vazio é de confiança.

Uma caixa de entrada em todas as forges

Se o espaço de trabalho tem repos em mais do que um host de código, a caixa de entrada funde-os num único fluxo — uma pull request do GitHub e uma pull request do Bitbucket ficam na mesma secção, ordenadas por tempo em vez de agrupadas por fornecedor. É o metadado repo #number da linha que as distingue.

«Suas» é resolvido por forge, porque é uma conta diferente em cada uma. Uma pull request só conta como sua, ou como pedindo a sua revisão, quando corresponde à sua identidade na forge onde esse repo vive de facto.

Uma forge em baixo ou não ligada não contribui com nada e deixa o resto da caixa de entrada intacto — uma ligação quebrada nunca esvazia a lista inteira. O estado vazio indica uma ressalva em vez de Você está em dia quando todos os inícios de sessão nas forges continuam por resolver (Não foi possível confirmar sua conta do GitHub — o texto continua a mencionar o GitHub), quando o githubstatus.com reporta um incidente, ou quando uma instalação da GitHub App que abrange repos vinculados está suspensa.

Limpar a faixa de atenção

Cada cartão da faixa tem uma única ação seguinte:

1. Se um cartão for uma confirmação pendente de um agente, clique em Revisar — é levado ao espaço desse agente com a respetiva confirmação pendente. Aprove ou rejeite aí (ver Conversar com um agente).
2. Se um cartão disser Falha na sincronização para um fornecedor, clique em Abrir — é levado a Definições → Espaço de trabalho → Geral, cujo cartão Estado da sincronização mostra a última sincronização de cada ligação, a série de falhas consecutivas e o resultado mais recente. Só a falha mais recente de cada fornecedor aparece na caixa de entrada, pelo que uma sincronização recuperada limpa o cartão.
3. Os cartões desaparecem sozinhos assim que o estado subjacente se resolve (o agente recebe resposta, a sincronização recupera) — não há nada para dispensar manualmente.

Estas são confirmações por turno, não aprovações de governação

Um cartão de «aprovação de agente» é um agente em execução que faz uma pausa para pedir permissão para uma ação, na sua própria conversa. É uma coisa diferente do registo Approval de governação que os agentes criam com as ferramentas MCP de aprovação — esses não têm ecrã humano em lado nenhum da aplicação e nunca aparecem aqui.

O estado da sincronização é apenas de leitura

O cartão informa sobre as ligações de sincronização de tickets; além de um botão Sincronizar, não consegue criar, editar ou voltar a ligar nenhuma, e não há outro ecrã que o possa fazer. Sem nenhuma ligação configurada, lê simplesmente «Ainda sem ligações de sincronização», que é o que um espaço de trabalho novo mostra.

Filtrar para o que está a bloquear

1. Prima f (sem nenhum campo de texto focado) para abrir o menu de filtros, ou clique no botão de filtro na barra de ferramentas.
2. Escolha qualquer combinação de estado, autor, revisores, conteúdo, proprietário/nome do repo, intervalos de datas ou de revisão rápida. As contagens de facetas no menu mostram quantos itens da caixa de entrada correspondem a cada opção.
3. Os filtros ativos aparecem como chips na barra acima da lista; clique no ✕ de um chip para remover esse critério.
4. Use a barra lateral esquerda para saltar entre secções — cada entrada mostra a respetiva contagem em direto e o realce acompanha a sua posição de deslocamento. Clique num cabeçalho de secção para recolher as secções que não tria (por exemplo Rascunhos enquanto limpa revisões).
5. Clique num cabeçalho de coluna (título, alterações ou atualizado) para ordenar todas as secções; clique novamente na coluna ativa para inverter a direção. O botão de opções de visualização controla a visibilidade dos rascunhos, a janela das fundidas recentemente, as propriedades das linhas, a ordenação e o agrupamento (só o agrupamento por autor altera a disposição da caixa de entrada).

Os filtros aqui são independentes da fila de PRs — restringir a caixa de entrada nunca altera os filtros da fila, e vice-versa.

Agir sobre um item de PR

1. Clique em qualquer linha para abrir a página de detalhe da PR.
2. Se a PR estiver em A aguardar a sua revisão, reveja-a e submeta a sua decisão — ver Rever e fazer merge de uma PR.
3. Se a PR estiver em Devolvidas a você (alterações pedidas ou CI falhou), faça push das correções a partir do seu checkout ou entregue o seguimento a um agente.
4. Se a PR estiver em Aprovadas, faça o merge a partir da página de detalhe.
5. Se preferir delegar uma revisão em vez de a fazer você mesmo, ver Despachar agentes revisores e o ciclo de vida do despacho.

Assim que o estado subjacente muda (a sua revisão fica registada, a PR é fundida), o classificador volta a colocar a PR na sua nova secção automaticamente.

Anular uma ação enganada

1. Prima ⌘Z para anular a última ação e ⌘⇧Z para a refazer.
2. Se um campo de texto estiver focado, ⌘Z edita o texto do campo — clique fora do campo primeiro para anular uma ação ao nível da aplicação.

Consultar atalhos no próprio local

Prima ? (sem nenhum campo de texto focado) para abrir a folha de referência de atalhos de teclado. Ela lista todas as combinações ativas na rota atual, incluindo o atalho de filtro f da caixa de entrada. O mapa completo está na referência de atalhos de teclado.

Controlá-la a partir da paleta de comandos

1. Prima ⌘K em qualquer sítio para abrir a paleta de comandos.
2. Escreva Caixa de entrada para saltar para a página ou escreva o título de uma PR — a paleta lista as pull requests correspondentes e abre a que escolher.
3. Com a caixa de entrada aberta, execute Copiar link desta página para copiar esse URL para partilha. O comando copia a rota atual, pelo que só é o URL da caixa de entrada quando está nesta página.

Atualizar a pedido

A caixa de entrada atualiza-se em direto, mas se suspeitar de dados desatualizados, clique no controlo de atualização na barra de ferramentas — ele força uma varredura imediata do lado do servidor a todas as forges ligadas e volta a obter as sobreposições de fundidas/revisadas. O ícone gira até todas as obtenções terminarem.

Guias relacionados

• Rever e fazer merge de uma PR
• Conversar com um agente
• Despachar agentes revisores

Conceitos relacionados

• Ciclo de vida do despacho