Recursos · Arquitetura
Arquitetura do Runtime do OpenQCore
Arquitetura em nível de sistema para orquestração de provedores, controle de roteamento, normalização de contratos e confiabilidade em produção.
Arquitetura de Runtime
Modelo de execução em camadas, desde a entrada da requisição até a resposta determinística e o processo de limpeza.
Gateway de API
Autenticação, validação de escopo, regulação de requisições e inicialização de rastreamento.
Roteador de decisões
Classifica intenção e modalidade e seleciona a rota conforme as políticas.
Motor de execução
Execução de chat, voz e Iris, com suporte a streaming e a processamento sem streaming.
Controles de segurança
Limites de taxa, bloqueios distribuídos, circuit breakers e proteção contra sobrecarga.
Camada de persistência
Mensagens de sessão, cache de desduplicação e registro de uso e eventos.
Conectores de provedores
Adaptadores OpenAI, Gemini, Claude e Replicate sob uma única interface.
Construtor de contratos
Gera envelopes de resposta estáveis para clientes e sistemas a jusante.
Camada de Provedores
Abstração unificada de provedores com roteamento orientado por políticas e gestão de fallback.
OpenAI
Principal para canais de geração de chat, voz e imagem.
Gemini
Raciocínio multimodal e canal com suporte a imagens.
Claude
Canal de fallback focado em raciocínio textual.
Replicate
Canal especializado em geração de imagens e vídeos.
Roteador de abstração de provedores
Seleciona o provedor com base em capacidade, perfil de latência, estado de confiabilidade e políticas do ambiente.
Matriz de Roteamento
Despacho orientado por intenção com seleção primária/fallback consciente das capacidades.
| Tipo de intenção | Rota primária | Rota de fallback | Contrato de saída |
|---|---|---|---|
| Chat de texto | OpenAI/Claude | Gemini | Envelope de texto padrão |
| Conversa por voz | OpenAI (canal de voz) | Alternativa Azure/OpenAI | Voz + envelope de metadados |
| Geração de imagens | OpenAI/Replicate | Replicate/OpenAI | Array de imagens + uso + metadados |
| Geração de vídeos | Canal de vídeo Replicate | Definido por política | Array de vídeos + metadados |
Camada de Contrato de Saída
Envelope de resposta normalizado para todos os provedores e modalidades.
{
"success": true,
"content": "...",
"provider": "...",
"usage": {},
"metadata": {},
"images": [],
"files": [],
"videos": []
}Pilares da Arquitetura
- Entrada unificada para autenticação, escopo e validação de políticas.
- Roteamento orientado por intenção com estratégias de execução adaptadas à modalidade.
- Abstração de provedores que isola diferenças entre fornecedores das interfaces do produto.
- Normalização de contratos que garante estabilidade do frontend e dos SDKs.
Garantias de Produção
- Limpeza determinística para rastreamento de bloqueios e de requisições pendentes.
- Degradação controlada em caso de estresse do provedor ou do sistema.
- Execução rastreável por meio de identificadores de requisição, sessão e rastreamento.
- Contratos de resposta consistentes entre todos os provedores.
- Controles operacionais projetados para cargas de trabalho de produção em escala empresarial.
