Saltar al contenido principal

Notificaciones

La página Notifications es la bandeja de entrada con historial completo de todos los eventos del sistema generados por los agentes de IA y el Beak AI Runtime. Es accesible desde la barra lateral y desde el enlace View all en el menú desplegable de la campana de notificaciones. El encabezado de la página muestra el recuento actual de no leídos como "N unread" para que los usuarios puedan valorar de un vistazo cuánto se ha acumulado desde su última visita.

Las notificaciones se generan para dos tipos de eventos principales: un agente que eleva una solicitud que necesita una decisión humana, y una solicitud de aprobación que alcanza un resultado terminal. Cada notificación enlaza directamente al contexto relevante — ya sea el panel de detalle de la aprobación o el hilo de chat de origen — para que los usuarios puedan actuar sin necesidad de navegar manualmente.

Encabezado de Página​

El encabezado contiene el título de la página Notifications, el recuento de no leídos en tiempo real y el botón Mark all as read. El botón Mark all as read está deshabilitado cuando el recuento de no leídos es cero o mientras una operación de lectura masiva está en curso.

Lista de Notificaciones​

La lista de notificaciones se muestra como una tarjeta desplazable. Cada fila es un NotificationItem y contiene los siguientes elementos.

Fila de Notificación​

  • Ícono de tipo — Un distintivo de ícono circular con color que refleja el tipo de evento y el resultado. Una solicitud de aprobación en espera de decisión utiliza el color de advertencia; una aprobación resuelta como aprobada utiliza el color de éxito; los resultados rechazados o cancelados utilizan el color de error o atenuado, respectivamente.
  • Título — El título principal de la notificación en negrita. Los elementos no leídos también presentan un pequeño punto azul en el borde derecho de la fila del título.
  • Extracto del cuerpo — Hasta dos líneas del texto del cuerpo de la notificación que proporcionan contexto sobre el evento.
  • Marca de tiempo — Tiempo relativo desde que se creó la notificación (por ejemplo, 5m ago, 2h ago, 3d ago).

Al Hacer Clic en una Notificación​

Al hacer clic en una fila se marca la notificación como leída (si estaba sin leer) y se navega al recurso correspondiente.

  • Las notificaciones de tipo needs_approval o approval_resolved enlazan directamente a la página Approvals con la solicitud específica preseleccionada, de modo que el usuario llega directamente al panel de detalle.
  • Todos los demás tipos de notificaciones (como las finalizaciones de ejecución de agentes) navegan al hilo de chat de origen cuando hay un ID de hilo disponible.

Estados Leído y No Leído​

Las filas no leídas tienen un fondo resaltado. Una vez leídas — ya sea haciendo clic en la fila o usando Mark all as read — el fondo vuelve al estado neutro. Las filas individuales pueden marcarse como leídas haciendo clic en ellas; no existe un botón separado de "marcar como leído" por fila fuera de hacer clic en el elemento.

Paginación​

Cuando el recuento total de notificaciones supera los veinte elementos, aparecen controles de paginación debajo de la lista. Los controles muestran la página actual como "Page N of N" y proporcionan los botones Previous y Next. Ambos botones se deshabilitan automáticamente cuando el usuario está en la primera o última página, respectivamente. Cada página carga veinte notificaciones.

Buenas Prácticas​

  • Actúe sobre las notificaciones needs_approval con prontitud — Las solicitudes de aprobación vencen después de un período configurado; una solicitud vencida bloquea al agente para completar la acción que la desencadenó.
  • Use Mark all as read después de una sesión de triaje — Limpiar el recuento de no leídos mantiene preciso el distintivo de la campana y facilita identificar eventos genuinamente nuevos en la próxima visita.
  • Acceda a la página Approvals para tomar decisiones — Al hacer clic en una notificación de aprobación, llegará directamente al panel de detalle donde están disponibles los botones Approve y Reject; no necesita navegar manualmente.
  • Revise el historial de notificaciones después de un período de alta actividad — El historial paginado proporciona un registro de auditoría ligero de qué agentes elevaron solicitudes y qué resultados se registraron.

Páginas Relacionadas​