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
  • retrieval_mode (optionnel) : dense_mmr ou hybrid_rrf

retrieval_mode remplace seulement le mode pour cette requête. Nexus conserve l'autorité sur retrieve_k, fetch_k, mmr_lambda, les prefetch, les seuils, le modèle et le cache. Sans valeur explicite, la priorité est workspace, profil du source_app, puis défaut Nexus dense_mmr.

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, le Bot peut demander retrieval_mode="hybrid_rrf" si ce mode est activé. Toute augmentation de retrieve_k reste une décision de configuration Nexus, jamais un paramètre libre envoyé par le Bot.