Intégration : Aurora Bot → Nexus (query + streaming)

Objectif : permettre à Aurora Bot d’interroger Nexus sur un service/workspace, avec une UX “chat” et un streaming SSE.

Auth (end-user)

• L’utilisateur final se connecte avec ses identifiants Nexus.
• Le Bot conserve le JWT (cookie ou storage serveur) et le renvoie sur les appels API.

Query (sync)

• Endpoint : POST /api/query
• Champs importants :
  • query : question
  • caller_app : ex. aurora_bot
  • source_app : service Nexus (optionnel mais recommandé)
  • workspace : workspace Nexus (optionnel, null = “tous”)
  • provider_model (optionnel) : override ponctuel du modèle

Query (streaming SSE)

• Endpoint : POST /api/query/stream
• Même payload que /api/query
• Réponse : flux SSE (tokens / chunks)

Points d’attention

• Toujours envoyer caller_app (observabilité, cache, quotas).
• Si “aucune source pertinente” : vérifier ingestion + filtres service/workspace.
• Sur gros corpus mono-sujet : préférer hybrid_rrf (si activé) avec un retrieve_k plus élevé.