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.
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.
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ón | Ruta primaria | Ruta de respaldo | Contrato de salida |
|---|---|---|---|
| Chat de texto | OpenAI/Claude | Gemini | Envoltorio de texto estándar |
| Conversación por voz | OpenAI (canal de voz) | Azure/OpenAI (respaldo) | Envoltorio de voz + metadatos |
| Generación de imágenes | OpenAI/Replicate | Replicate/OpenAI | Array de imágenes + uso + metadatos |
| Generación de video | Canal de video de Replicate | Definido por políticas | Array 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.
