Visão de arquitetura
Clinical Corvus usa um control plane próprio para manter as regras clínicas e de produto separadas dos runtimes de IA. Essa divisão permite trocar modelos, provedores ou adaptadores sem alterar a fronteira do beta, o CaseState ou o contrato entregue à interface.
Componentes
| Componente | Papel |
|---|---|
| Workspace clínico | Exibe contexto, deltas, planos, ações e estados de revisão. |
| FastAPI | Oferece APIs de pacientes, grupos, agentes, documentos, estado, feedback e uso. |
| Control plane Corvus | Classifica a pergunta, escolhe a sequência, aplica budgets e monta AgentResponse. |
| BAML | Define prompts e saídas estruturadas para funções delimitadas. |
| Langroid | Atua como runtime seletivo para agentes, ferramentas, lineage e tarefas quando preserva os contratos Corvus. |
| Recuperação | Combina corpus local, fontes bibliográficas e provedores externos permitidos. |
| CaseState e PCM | Separam estado do episódio e contexto longitudinal. |
| Rails | Registram evidência, contexto usado e rota de execução quando o caminho os produz. |
Fronteiras importantes
Dados externos
O compartilhamento de PHI com terceiros é desabilitado por padrão. Consultas explicitamente públicas e sem sinais de PHI podem usar provedores aprovados. A pesquisa clínica canônica constrói consultas redigidas para fontes externas.
Execução
Nem toda ação de IA passa pelo pipeline canônico. Essa diferença deve permanecer visível na documentação e na interface.
Estado
O Patient Context Manager agrega o histórico conhecido. CaseState representa o problema ativo e suas mudanças. Memória de conversa e preferências aprendidas têm ciclos de retenção e escopos próprios.
Tenant
Serviços aplicam tenant_id, e tabelas PostgreSQL cobertas pela migração de tenant scoping recebem políticas de RLS. Uma implantação deve confirmar quais tabelas e caminhos administrativos estão incluídos.
O que a arquitetura permite avaliar
- qual contexto entrou em uma resposta;
- qual rota e quais ferramentas participaram;
- quais evidências foram aceitas ou rejeitadas;
- onde houve bloqueio, insuficiência ou revisão obrigatória;
- quais contratos uma superfície pode exibir.
Esses mecanismos aumentam a capacidade de inspeção. Eles não demonstram, sozinhos, segurança clínica ou eficácia.