Recursos · Arquitectura

Arquitectura de tiempo de ejecución de OpenQCore

Arquitectura a nivel de sistema para la orquestación de proveedores, control de enrutamiento, normalización de contratos y fiabilidad en producción.

Arquitectura del tiempo de ejecución

Un modelo de ejecución por capas desde el ingreso de la solicitud hasta la respuesta determinista y la limpieza.

Pasarela de API

Autenticación, validación de alcance, formateo de solicitudes e inicialización de trazas.

Enrutador de decisiones

Clasificación por intención + modalidad con selección de ruta consciente de políticas.

Motor de ejecución

Ejecución de Chat/Voice/Iris con streaming y manejo sin streaming.

Controles de seguridad

Límites de tasa, bloqueos distribuidos, disyuntores y protección contra sobrecarga.

Flujo de ejecución

Capa de persistencia

Mensajes de sesión, caché de deduplicación y registro de uso/eventos.

Conectores de proveedores

Adaptadores de OpenAI, Gemini, Claude y Replicate bajo una misma interfaz.

Generador de contratos

Construye envoltorios de respuesta estables para clientes y sistemas aguas abajo.

Capa de proveedores

Abstracción de proveedores unificada con enrutamiento sensible a políticas y gestión de fallback.

OpenAI

Principal para canales de chat/voz/generación de imágenes.

Gemini

Canal multimodal de razonamiento y con capacidad para imágenes.

Claude

Canal de respaldo para razonamiento centrado en texto.

Replicate

Canal especializado en generación de imágenes/videos.

Enrutamiento consciente de políticas

Enrutador de abstracción de proveedores

Selecciona el proveedor según capacidad, perfil de latencia, estado de fiabilidad y política del entorno.

Matriz de enrutamiento

Despacho impulsado por intención con selección de primario/fallback consciente de capacidades.

Tipo de intenciónRuta primariaRuta de respaldoContrato de salida
Chat de textoOpenAI/ClaudeGeminiEnvoltorio de texto estándar
Conversación por vozOpenAI (canal de voz)Azure/OpenAI (respaldo)Envoltorio de voz + metadatos
Generación de imágenesOpenAI/ReplicateReplicate/OpenAIArray de imágenes + uso + metadatos
Generación de videoCanal de video de ReplicateDefinido por políticasArray de videos + metadatos

Capa del contrato de salida

Envoltorio de respuesta normalizado para todos los proveedores y modalidades.

{
  "success": true,
  "content": "...",
  "provider": "...",
  "usage": {},
  "metadata": {},
  "images": [],
  "files": [],
  "videos": []
}

Pilares de la arquitectura

  • Ingreso unificado para autenticación, alcance y validación de políticas.
  • Enrutamiento orientado a la intención con estrategias de ejecución conscientes de la modalidad.
  • La abstracción del proveedor aísla las diferencias entre proveedores de las superficies del producto.
  • La normalización de contratos garantiza la estabilidad del frontend y del SDK.

Garantías de producción

  • Limpieza determinista para el seguimiento de bloqueos y solicitudes pendientes.
  • Degradación controlada bajo estrés del proveedor o del sistema.
  • Ejecución trazable mediante identificadores de solicitud, sesión y traza.
  • Contratos de respuesta consistentes entre todos los proveedores.
  • Controles operativos diseñados para cargas de trabajo de producción a escala empresarial.