Skip to content
PointSav Digital Systems

Last updated · 33df4c92 · English

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.

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

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.

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.

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.

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.

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

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

Véase también

Important Information

Important Information

Corporate structure. PointSav Digital Systems ("PointSav") is a trade name of Woodfine Capital Projects Inc. ("Woodfine"). PointSav does not itself offer, sell, or solicit any security. Any securities offering associated with Woodfine's real-property direct-hold solutions is made exclusively by Woodfine, and only by means of the applicable Private Placement Memorandum.

No investment advice. This wiki's content is provided for engineering, operational, research, and development purposes. Nothing on this wiki constitutes investment advice or a solicitation to invest in any Woodfine partnership or direct-hold solution.

Intellectual property. The PointSav name, trade name, wordmark, and marks, together with all current and future PointSav- and Totebox-branded products, services, and offerings — and the software, source code, documentation, design system, and all related materials — are proprietary to Woodfine and its affiliates, except for components identified as open source. No rights are granted except as expressly set out in a written license or agreement. See TRADEMARK.md in this repository for the full trademark notice.

Open source components. Portions of the platform are made available under permissive open-source licenses identified in the accompanying repository. Use of those components is governed by their respective license terms.

No warranty; informational use. Content on this wiki is provided for general informational purposes only and does not constitute a representation, warranty, or commitment with respect to product functionality, availability, pricing, or roadmap. Some articles describe planned or intended features, capabilities, and milestones — language such as "planned," "intended," "targeted," "may," and "expected" marks this forward-looking content, which is subject to change and does not constitute a commitment regarding future performance.

Confidentiality. Where an article describes an operational or deployment detail that is not intended for public disclosure, that article is not published on this wiki. Content here is general-purpose engineering documentation, not customer-specific configuration.

Jurisdiction. Woodfine Capital Projects Inc. is organized in British Columbia, Canada. References to the Sovereign Data Foundation on this wiki describe a planned or intended initiative only, not a current equity holder or active governance body.

Changes to this notice. PointSav may update this notice from time to time; the version posted on this page governs.

Not a filing system. This wiki is not a securities filing system, an electronic disclosure repository, or a substitute for SEDAR+ or any other regulatory filing system. Formal securities filings are made through the applicable regulatory filing system, not through this wiki.

Full disclaimer. This notice supplements, and does not replace, the full Disclaimers article. In the event of any conflict, the full Disclaimers article governs.

Read the full disclaimer →