Triar tu bandeja de entrada

Esta guía te muestra cómo trabajar con la bandeja de entrada: la única superficie que reúne todo lo que te bloquea o te pide explícitamente —aprobaciones de agentes pendientes, sincronizaciones de tickets fallidas y todas las pull request en las que participas como revisor o autor.

Abrir la bandeja de entrada

1. Haz clic en Bandeja de entrada en la barra lateral. Su insignia cuenta las aprobaciones de agentes pendientes, las sincronizaciones fallidas y las PR abiertas que esperan tu revisión.
2. O pulsa ⌘K y ejecuta el comando de navegación Bandeja de entrada.
3. O ve directamente a /workspaces/<workspace-id>/inbox.

La entrada de la barra lateral siempre muestra el recuento en vivo, así que puedes ver cómo se acumula el trabajo de triaje sin abrir la página.

Ver la gravedad de un vistazo

Recorre la lista de arriba abajo; la bandeja de entrada ya está ordenada por urgencia:

1. La franja fija Requiere tu atención está situada encima de las secciones de PR. Cada tarjeta lleva un chip de gravedad. Las fuentes registradas (un agente atascado en un aviso de confirmación, una sincronización de tickets cuyo espejo del proveedor está obsoleto) emiten Bloqueado.
2. Dentro de la franja, la gravedad más urgente va primero; los empates los gana el elemento que lleva más tiempo esperando.
3. Por debajo de la franja, las PR se agrupan en secciones fijas del ciclo de vida de la revisión: Esperan tu revisión, Devueltas a ti, Aprobadas, Borradores, Esperando revisores, Fusionándose y fusionadas recientemente, Esperando al autor. Las secciones de arriba son lo que te necesita a ti; el resto es dónde están tus PR. Esperan tu revisión incluye las PR que aún solicitan un equipo al que perteneces en los hosts de código que los admiten (GitHub retira el equipo en cuanto cualquier compañero revisa).

Un elemento solo llega a la bandeja de entrada cuando bloquea algo o te solicita explícitamente. Una franja vacía junto con una lista de secciones vacía muestra Estás al día solo cuando ese vacío es fiable.

Una sola bandeja de entrada en todos los hosts de código

Si el espacio de trabajo tiene repos en más de un host de código, la bandeja de entrada los combina en un único flujo: una pull request de GitHub y una pull request de Bitbucket aparecen en la misma sección, ordenadas por hora en lugar de agrupadas por proveedor. El metadato repo #number de la fila es lo que las distingue.

«Tuyo» se resuelve por host de código, porque eres una cuenta distinta en cada uno. Una pull request solo cuenta como tuya, o como que solicita tu revisión, cuando coincide con tu identidad en el host de código donde vive realmente ese repo.

Un host de código caído o sin conectar no aporta nada y deja intacto el resto de la bandeja de entrada: una conexión rota nunca vacía toda la lista. El estado vacío indica una salvedad en lugar de Estás al día cuando aún no se ha resuelto el inicio de sesión en todos los hosts de código (No se pudo confirmar tu cuenta de GitHub — el texto sigue diciendo GitHub), cuando githubstatus.com informa de un incidente, o cuando está suspendida una instalación de GitHub App que cubre repos vinculados.

Despejar la franja de atención

Cada tarjeta de la franja tiene una única acción siguiente:

1. Si una tarjeta es una confirmación pendiente de un agente, haz clic en Revisar: llegas al espacio de ese agente con su confirmación pendiente. Aprueba o rechaza allí (consulta Chatear con un agente).
2. Si una tarjeta dice Error de sincronización para un proveedor, haz clic en Abrir: llegas a Ajustes → Espacio de trabajo → General, cuya tarjeta Estado de sincronización muestra la última sincronización de cada conexión, la racha de fallos consecutivos y el último resultado. En la bandeja de entrada solo aparece el último fallo de cada proveedor, así que una sincronización recuperada borra la tarjeta.
3. Las tarjetas desaparecen solas en cuanto se resuelve el estado subyacente (el agente recibe respuesta, la sincronización se recupera): no hay nada que descartar manualmente.

Estas son confirmaciones por turno, no aprobaciones de gobernanza

Una tarjeta de «aprobación de agente» es un agente en ejecución que se detiene para pedir permiso para una acción, en su propia conversación. Es algo distinto del registro de gobernanza Approval que los agentes crean con las herramientas MCP de aprobación: esos no tienen ninguna pantalla humana en toda la aplicación y nunca aparecen aquí.

El estado de sincronización es de solo lectura

La tarjeta informa sobre las conexiones de sincronización de tickets; aparte de un botón Sincronizar, no puede crear, editar ni reconectar una, y no hay ninguna otra pantalla que pueda hacerlo. Sin ninguna conexión configurada, simplemente dice «Aún no hay conexiones de sincronización», que es lo que muestra un espacio de trabajo recién creado.

Filtrar hasta lo que te bloquea

1. Pulsa f (sin ningún campo de texto enfocado) para abrir el menú de filtros, o haz clic en el botón de filtro de la barra de herramientas.
2. Elige cualquier combinación de estado, autor, revisores, contenido, propietario/nombre del repo, ventanas de fechas o rápidas de revisar. Los recuentos de facetas del menú muestran cuántos elementos de la bandeja de entrada coincide cada opción.
3. Los filtros activos aparecen como chips en la barra situada encima de la lista; haz clic en la ✕ de un chip para quitar ese criterio.
4. Usa el carril izquierdo para saltar entre secciones: cada entrada muestra su recuento en vivo y el resaltado sigue tu posición de desplazamiento. Haz clic en la cabecera de una sección para plegar las secciones que no trias (por ejemplo Borradores mientras despejas revisiones).
5. Haz clic en la cabecera de una columna (título, cambios o actualizado) para ordenar todas las secciones; haz clic otra vez en la columna activa para invertir la dirección. El botón de opciones de visualización controla la visibilidad de los borradores, la ventana de fusión reciente, las propiedades de fila, el orden y la agrupación (solo agrupar por autor cambia el diseño de la bandeja de entrada).

Los filtros de aquí son independientes de la cola de PR: restringir la bandeja de entrada nunca cambia los filtros de la cola, ni al contrario.

Actuar sobre un elemento de PR

1. Haz clic en cualquier fila para abrir la página de detalle de la PR.
2. Si la PR está en Esperan tu revisión, revísala y envía tu decisión; consulta Revisar y fusionar una PR.
3. Si la PR está en Devueltas a ti (cambios solicitados o CI fallida), sube las correcciones desde tu copia de trabajo o deja el seguimiento a un agente.
4. Si la PR está en Aprobadas, fusiónala desde la página de detalle.
5. Si prefieres delegar una revisión en lugar de hacerla tú, consulta Despachar agentes revisores y el ciclo de vida del despacho.

En cuanto cambia el estado subyacente (tu revisión se envía, la PR se fusiona), el clasificador vuelve a colocar la PR en su nueva sección automáticamente.

Deshacer una acción por error

1. Pulsa ⌘Z para deshacer la última acción y ⌘⇧Z para rehacerla.
2. Si hay un campo de texto enfocado, ⌘Z edita el texto del campo; haz clic fuera del campo para deshacer una acción de la aplicación.

Consultar los atajos sin salir de la página

Pulsa ? (sin ningún campo de texto enfocado) para abrir la hoja de atajos de teclado. Enumera todas las combinaciones activas en la ruta actual, incluido el atajo de filtro f de la bandeja de entrada. El mapa completo está en la referencia de atajos de teclado.

Controlarla desde la paleta de comandos

1. Pulsa ⌘K en cualquier lugar para abrir la paleta de comandos.
2. Escribe Bandeja de entrada para saltar a la página, o escribe el título de una PR: la paleta lista las pull request coincidentes y abre la que elijas.
3. Con la bandeja de entrada abierta, ejecuta Copiar enlace de esta página para copiar esa URL y compartirla. El comando copia la ruta actual, así que solo es la URL de la bandeja de entrada cuando estás en esta página.

Actualizar a petición

La bandeja de entrada se actualiza en vivo, pero si sospechas que los datos están obsoletos, haz clic en el control de actualización de la barra de herramientas: fuerza un barrido inmediato en el servidor de todos los hosts de código conectados y vuelve a obtener las superposiciones de fusionadas y revisadas. El icono gira hasta que terminan todas las peticiones.

Guías relacionadas

• Revisar y fusionar una PR
• Chatear con un agente
• Despachar agentes revisores

Conceptos relacionados

• Ciclo de vida del despacho