Saltar al contenido principal

Ajustes

La página Settings es el centro de configuración de administración del Beak AI Runtime. El subtítulo de la página indica "Configure your system preferences and integrations". Seis pestañas cubren áreas de configuración distintas: Users, AI Provider, Notifications (SMTP), Email Settings, Microsoft Teams y Slack Integration. Cada pestaña carga y guarda su configuración de forma independiente; los cambios no guardados en una pestaña no se ven afectados al cambiar a otra.

Los campos de contraseña y secreto enmascaran sus valores tras el guardado inicial y muestran el marcador Saved (unchanged) para que los administradores sepan que hay un valor almacenado sin exponerlo. Dejar un campo enmascarado en blanco al guardar preserva el secreto existente.

Pestaña Users​

La pestaña Users proporciona gestión completa del ciclo de vida de las cuentas de usuario del Runtime. La columna izquierda lleva un encabezado User Management con un resumen del recuento actual de administradores y de usuarios activos. La columna derecha contiene la tabla de usuarios.

Barra de herramientas de la tabla de usuarios​

  • Botones de filtro — Los botones all (N), active (N) e inactive (N) filtran las filas mostradas. El botón activo se resalta con el color primario.
  • Botón Add User — Abre el diálogo Agregar usuario.

Fila de usuario​

Cada fila de la tabla muestra:

  • Avatar — Iniciales derivadas del nombre y apellido del usuario, o el primer carácter de la dirección de correo electrónico. Los avatares de administrador usan el fondo de color primario; los usuarios estándar usan el fondo atenuado.
  • Nombre para mostrar y correo electrónico — Nombre completo (o dirección de correo electrónico si no hay nombre establecido) en negrita, con la dirección de correo electrónico como texto secundario debajo.
  • Insignia Inactive — Se muestra en rojo cuando la cuenta del usuario está desactivada.
  • Insignia de rol — Una etiqueta interactiva que muestra Admin (con ícono de escudo, borde de color primario) o User (con ícono de usuario, borde neutro). Al hacer clic en la etiqueta se alterna el rol entre admin y user de forma inmediata.
  • Insignia de método de autenticación — Una pequeña etiqueta en mayúsculas que muestra local o sso indicando cómo se autentica el usuario.
  • Botón Deactivate / Activate — Alterna el estado activo de la cuenta. Las cuentas desactivadas no pueden iniciar sesión.

Diálogo Agregar usuario​

El diálogo Add User recopila:

  • First Name y Last Name — Campos opcionales de nombre para mostrar.
  • Email — Obligatorio. El identificador de inicio de sesión de la cuenta.
  • Role — User (predeterminado) o Admin. Los usuarios administradores pueden acceder a todas las páginas de administración, incluidas Connections, Providers y Settings.
  • Auth Method — Local (Password) para credenciales almacenadas en el Runtime, o SSO para cuentas autenticadas a través del proveedor de identidad configurado.
  • Password — Obligatorio cuando se selecciona Local (Password); debe tener al menos ocho caracteres.

El botón Add User del diálogo está deshabilitado hasta que se rellena el campo de correo electrónico y mientras la solicitud de creación está en curso.

Pestaña AI Provider​

La pestaña AI Provider enruta las solicitudes LLM hacia el Beak AI Gateway o hacia un endpoint personalizado compatible con OpenAI. La columna izquierda lleva el encabezado AI Provider y una descripción que explica los dos modos de enrutamiento.

Selección de proveedor​

Se presentan dos opciones de radio.

  • Beak AI Gateway — Enruta a través del Beak Gateway Manager para enrutamiento unificado de múltiples proveedores, seguimiento de gasto y limitación de velocidad. Recomendado para implementaciones que comparten la pila de la plataforma Beak.
  • Custom OpenAI-Compatible Endpoint — Se conecta directamente a cualquier API que siga la interfaz REST de OpenAI, incluidas OpenAI, Azure OpenAI, Ollama y vLLM.

Campos de Beak AI Gateway​

  • Gateway URL — La URL base del servicio Beak Gateway Manager (por ejemplo, http://gateway-manager:5060).
  • Virtual API Key — La clave API emitida por el Gateway Manager para esta instancia del Runtime; almacenada de forma cifrada.
  • Default Model — Un menú desplegable poblado dinámicamente con los modelos disponibles en el Gateway conectado. Si el Gateway no es accesible o no devuelve modelos, se muestra un campo de texto libre en su lugar.

Campos de endpoint personalizado​

  • Base URL — La raíz de la API (por ejemplo, https://api.openai.com/v1).
  • API Key — La clave API del proveedor; almacenada de forma cifrada.
  • Default Model — Identificador de modelo en texto libre (por ejemplo, gpt-4o).
  • Botón Test Connection — Ejecuta una prueba en vivo contra el endpoint configurado y muestra la latencia en caso de éxito o el mensaje de error en caso de fallo.

El botón Save Provider Settings es compartido por ambos modos y aparece en la parte inferior del formulario.

Pestaña Notifications (SMTP)​

La pestaña Notifications (SMTP) configura el servidor de correo saliente que el Runtime utiliza para enviar alertas transaccionales, correos de aprobación y otros mensajes automatizados. La columna izquierda lleva el encabezado Notifications (SMTP).

Campos SMTP​

  • Host — El nombre de host del servidor SMTP (por ejemplo, smtp.gmail.com).
  • Port — El número de puerto SMTP (por ejemplo, 587).
  • Username — El nombre de usuario de la cuenta SMTP.
  • Password — La contraseña de la cuenta SMTP; almacenada de forma cifrada. Dejar el campo en blanco al guardar preserva la contraseña existente.
  • Interruptor Use SSL/TLS — Habilita o deshabilita una conexión segura al servidor de correo.

El pie de la pestaña contiene un botón Test Connection que realiza una entrega de prueba y un botón Save SMTP Settings.

Pestaña Email Settings​

La pestaña Email Settings controla cómo aparecen los mensajes salientes para los destinatarios. Se encuentra dentro de la misma pestaña Notifications (SMTP) en la navegación, pero se representa como una tarjeta separada debajo de la configuración SMTP.

  • Sender Name — El nombre para mostrar que aparece en el campo From de los correos electrónicos salientes (por ejemplo, Beak Administrator).
  • Reply-To Address — La dirección de correo electrónico a la que se dirigen las respuestas (por ejemplo, support@beak.io).

Los cambios se confirman con el botón Save Email Settings.

Pestaña Microsoft Teams​

La pestaña Microsoft Teams conecta el Runtime a un canal de Teams para entregar alertas de agentes y notificaciones de aprobación. La columna izquierda lleva el encabezado Microsoft Teams.

Campos de Teams​

  • Webhook URL — La URL del webhook entrante generada desde el canal de Teams de destino. El campo muestra Saved (unchanged) cuando ya hay una URL almacenada.
  • Channel Name — El nombre para mostrar del canal de Teams (por ejemplo, #beak-notifications).
  • Interruptor Enable Notifications — Activa o suspende la entrega de notificaciones de Teams sin eliminar la configuración.

El pie de la pestaña contiene un botón Test Connection y un botón Save Teams Settings.

Pestaña Slack Integration​

La pestaña Slack Integration conecta el Runtime a un espacio de trabajo de Slack para alertas en tiempo real e interacción con agentes desde canales de Slack. La columna izquierda lleva el encabezado Slack Integration.

Campos de Slack​

  • Bot Token — El token OAuth de bot con prefijo xoxb- de la configuración de la aplicación de Slack; almacenado de forma cifrada.
  • Signing Secret — El secreto de firma utilizado para verificar que las solicitudes entrantes de Slack provienen de la aplicación configurada; almacenado de forma cifrada.
  • Default Channel — El canal de reserva utilizado cuando ningún canal es especificado por el evento desencadenante (por ejemplo, #beak-alerts).
  • Interruptor Enable Notifications — Activa o suspende la entrega de notificaciones de Slack sin eliminar la configuración.

El pie de la pestaña contiene un botón Test Connection y un botón Save Slack Settings.

Buenas prácticas​

  • Cree al menos dos cuentas de administrador — Una sola cuenta de administrador crea el riesgo de quedarse sin acceso. Mantenga un segundo administrador como cuenta de acceso de emergencia.
  • Use Test Connection antes de guardar la configuración SMTP o de Teams en producción — Una prueba exitosa confirma que las credenciales y la ruta de red son correctas antes de que los agentes dependan del canal para las notificaciones de aprobación.
  • Enrute a través del Beak AI Gateway cuando sea posible — El Gateway proporciona seguimiento centralizado del gasto y limitación de velocidad que no está disponible cuando se conecta directamente a un endpoint de proveedor.
  • Rote los secretos introduciendo un nuevo valor en el campo de contraseña y guardando — El Runtime reemplaza el secreto almacenado al guardar; el marcador Saved (unchanged) confirma que el valor anterior permanece intacto hasta que se proporciona explícitamente uno nuevo.
  • Habilite los canales Microsoft Teams o Slack junto con SMTP — Los canales de notificación redundantes garantizan que las solicitudes de aprobación lleguen a los aprobadores incluso si una ruta de entrega no está disponible.

Páginas relacionadas​