Choisir le bon mode de recherche

How-to — objectif : savoir quand utiliser la recherche sémantique, lexicale ou hybride, et régler la précision.

Les trois modes

Mode	Quand	Ce qu'il fait
semantic (défaut)	question conceptuelle, « comment X marche », « pourquoi Y »	cherche par le sens
lexical	vous connaissez le mot/symbole exact (nom de fonction, sigle)	cherche le mot exact, répond même quand l'index sémantique est indisponible
hybrid	vous voulez les deux à la fois	lance les deux en parallèle, résultats présentés séparément

noezis search "comment l'authentification fonctionne"            # semantic
noezis search "OAuth2Provider" --mode lexical                    # mot exact
noezis search "gestion des sessions" --mode hybrid --json

Régler la précision

--min-score 0.85 — résultats ciblés (haut seuil) ; --min-score 0.3 — large.
--max-results 10 — nombre de résultats retournés.
--path-prefix DOCS/ — restreint aux documents sous un préfixe de chemin (recherche par le sens).
--community-id <id> — restreint à un sujet précis (l'identifiant vient du rapport de graphe).

noezis search "politique d'authentification" --min-score 0.7 --max-results 5 --path-prefix DOCS/ --json

Côté agent (MCP)

Le verbe noezis_search expose les mêmes modes (mode: semantic|lexical|hybrid). La plupart du temps un agent n'a pas besoin d'appeler noezis_search : le contexte pertinent lui est déjà fourni au début du tour. On appelle noezis_search pour creuser plus loin.

Voir aussi

Pourquoi la recherche est déterministe → Pourquoi la recherche n'utilise pas de LLM
Tous les flags → CLI · le verbe → Verbes MCP