zia-rag

Micro service pour exposer des fonctionnalités de Retrieval d’un Vector Store.

Base path : /zia-rag/api/v1/retrieval

{
  "question": "Comment réinitialiser mon mot de passe ?",
  "config": {
    "topK": 10,
    "useReranker": false,
    "useBm25": false,
    "sources": ["handbook", "faq"]
  }
}

• topK : nombre maximum de documents retournés (défaut : 10).
• useReranker : active le reranking distant.
• useBm25 : ajoute une recherche plein-texte BM25 (extension PG pg_textsearch, index idx_vector_store_content_bm25) à la recherche vectorielle classique. Comme les scores des deux retrievers ne sont pas comparables, activer useBm25 force l'utilisation du reranker. Les résultats sont alors unis puis dédupliqués par identifiant de document avant reranking.
• sources : filtre optionnel sur la métadonnée source (vide = pas de filtre).

Note : seuls les documents publics sont retournés. Un document est considéré public lorsque sa métadonnée user_uuid est absente ou vide ; les documents rattachés à un utilisateur (user_uuid non vide) sont systématiquement exclus du retrieval.

L'API est documentée via springdoc-openapi :

• UI : /zia-rag/swagger-ui.html
• Spécification OpenAPI : /zia-rag/v3/api-docs

Variables d'environnement principales (voir application.yml) :

Spring Security est toujours présent. La validation du jeton bleu (header Blue) est fournie par la librairie interne zas-common-security-starter, ajoutée uniquement via le profil Maven internal (utilisé par le Jenkinsfile, non disponible sur GitHub) :

mvn clean verify -Pinternal

• Avec le profil internal : un jeton bleu valide est requis, sauf pour /actuator/**, /swagger-ui.html, /swagger-ui/** et /v3/api-docs/**.
• Sans le profil : toutes les requêtes sont autorisées (développement local, CI GitHub).