Cómo configurar el gateway Doorman

El gateway Doorman enruta todas las solicitudes de inferencia y búsqueda de entidades al nivel apropiado: Nivel A (DataGraph), Nivel B (SLM local) o Nivel C (respaldo local). Configurar Doorman significa establecer las direcciones de nivel superior para cada nivel, definir los umbrales del interruptor de circuito y verificar el endpoint de salud después del inicio. Esta guía cubre un despliegue de Doorman en una sola instancia.

Para el protocolo de Doorman y el modelo de interruptor de circuito, véase doorman-protocol. Para iniciar el modelo SLM del que depende el Nivel B, véase run-local-slm-inference.

[edit]Requisitos previos

• El binario slm-doorman-server disponible en el host de despliegue
• Acceso de red al endpoint del DataGraph (service-content) si el Nivel A está previsto
• El binario del modelo OLMo presente en la ruta configurada para el Nivel B
• Una sesión de terminal en el host donde se ejecutará Doorman

[edit]Paso 1: Crear el archivo de configuración de Doorman

Doorman lee su configuración desde un archivo TOML. Cree doorman.toml:

[server]
port = 9080
bind = "127.0.0.1"

[tier_a]
enabled = true
service_content_url = "http://127.0.0.1:9090"
circuit_breaker_threshold = 5
circuit_breaker_timeout_secs = 30

[tier_b]
enabled = true
model_path = "/opt/pointsav/models/olmoe-1b-7b-instruct.gguf"
context_window = 4096
max_tokens = 512

[tier_c]
enabled = true
fallback_message = "Inferencia no disponible — solo respaldo local"

Ajuste service_content_url para que coincida con la dirección del servicio DataGraph en su despliegue. Si el DataGraph está en el mismo host, 127.0.0.1:9090 es típico. Si está en un nodo separado, use su dirección de red.

[edit]Paso 2: Iniciar el servicio Doorman

Inicie el servicio con el archivo de configuración:

slm-doorman-server --config doorman.toml

O como un servicio systemd:

sudo systemctl start slm-doorman-server

Doorman registra su secuencia de inicio: intenta contactar el DataGraph (Nivel A), carga el modelo SLM (Nivel B) y confirma que el Nivel C siempre está disponible. Cualquier fallo al contactar el Nivel A en el inicio no impide que Doorman inicie — marca el circuito del Nivel A como OPEN y enruta al Nivel B en su lugar.

[edit]Paso 3: Verificar el endpoint de salud

Doorman expone un endpoint de salud en /health:

curl http://127.0.0.1:9080/health

Una respuesta saludable:

{
  "tier_a_state": "CLOSED",
  "tier_b_state": "CLOSED",
  "tier_c_state": "AVAILABLE",
  "active_tier": "A"
}

CLOSED significa que el circuito está saludable y enrutando solicitudes. OPEN significa que el circuito se ha activado y Doorman no está enrutando a ese nivel. active_tier muestra qué nivel está recibiendo solicitudes actualmente.

[edit]Paso 4: Verificar desde la consola

Abra la consola y presione F9 para ver el panel de salud de Doorman. El panel lee desde el mismo endpoint /health. Los Niveles A, B y C deben mostrar verde bajo operación normal.

Si el Nivel A muestra OPEN pero el servicio DataGraph está en ejecución, verifique service_content_url en la configuración. Un fallo de resolución DNS o un puerto incorrecto es la causa más común.

[edit]Paso 5: Ajustar los umbrales del interruptor de circuito (opcional)

El circuit_breaker_threshold en [tier_a] establece cuántos fallos consecutivos activan el circuito. Un umbral más bajo (p.ej., 3) hace que el circuito se active más rápido ante fallos transitorios; un umbral más alto (p.ej., 10) tolera más errores antes de hacer el respaldo. El valor predeterminado de 5 es apropiado para la mayoría de los despliegues.

Después de cambiar el umbral, reinicie Doorman para que el cambio surta efecto:

sudo systemctl restart slm-doorman-server

[edit]Puntos clave

• Doorman inicia independientemente de si el Nivel A (DataGraph) es accesible — marca los niveles no disponibles como OPEN y enruta al siguiente
• El endpoint /health es la fuente autorizada del estado del circuito — léalo directamente o a través de F9 en la consola
• Los ajustes del interruptor de circuito están en doorman.toml bajo [tier_a]; los cambios requieren un reinicio del servicio
• El Nivel C siempre está disponible; nunca se activa

[edit]Véase también

• doorman-protocol — el modelo de interruptor de circuito y la lógica de enrutamiento entre niveles
• slm-stack-architecture — cómo está estructurado el modelo SLM del que depende el Nivel B
• run-local-slm-inference — verificar que el servicio SLM esté saludable antes de que inicie Doorman
• navigate-console-tui — leer el estado del Nivel en la barra de estado de la consola
• run-first-slm-query — enviar su primera solicitud de inferencia una vez que Doorman esté configurado