Pular para conteúdo

⚡ API & Streaming SSE

A API do Conselho de IA é construída com FastAPI, oferecendo documentação interativa OpenAPI/Swagger em /docs e suporte a Server-Sent Events (SSE) para streaming em tempo real.

📡 Endpoints Principais

Deliberações Individuais

  • POST /api/v1/deliberations — Cria uma nova deliberação assíncrona. Retorna {"id": "...", "status": "processing"}.
  • GET /api/v1/deliberations/{id}/stream — Endpoint SSE que transmite cada fase em tempo real (phase1_start, member_opinion_ready, phase2_start, debate_reply_ready, phase3_start, dossier_ready).
  • GET /api/v1/deliberations/{id} — Retorna o CouncilDossier consolidado em JSON.
  • GET /api/v1/deliberations/{id}/html — Retorna o painel interativo HTML de alta densidade.
  • GET /api/v1/deliberations/{id}/pdf — Gera e baixa o Dossiê Executivo em PDF corporativo.
  • GET /api/v1/deliberations/{id}/markdown — Retorna o relatório estruturado em Markdown.

Deliberações Comparativas A/B

  • POST /api/v1/deliberations/comparative — Executa confronto direto entre 2 ou mais propostas e retorna a matriz de trade-offs.
  • GET /api/v1/deliberations/comparative/{id}/html — Retorna o painel HTML comparativo side-by-side.
  • GET /api/v1/deliberations/comparative/{id}/pdf — Baixa o relatório comparativo em PDF.
  • GET /api/v1/deliberations/comparative/{id}/markdown — Retorna o comparativo em Markdown.

Saúde e Metadados

  • GET /health — Liveness e readiness probe para orquestradores de contêineres.
  • GET /api/v1/personas — Lista as 10 personas especialistas e suas configurações.