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.

Fluxo de execução

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.

Roteamento orientado por políticas

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çãoRota primáriaRota de fallbackContrato de saída
Chat de textoOpenAI/ClaudeGeminiEnvelope de texto padrão
Conversa por vozOpenAI (canal de voz)Alternativa Azure/OpenAIVoz + envelope de metadados
Geração de imagensOpenAI/ReplicateReplicate/OpenAIArray de imagens + uso + metadados
Geração de vídeosCanal de vídeo ReplicateDefinido por políticaArray 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.