Clustraly
Command Menu, prévisualisation & PWA

Repli IA sémantique (niveau 2, Haiku) : retrouvez la bonne action même quand vos mots ne collent pas

Repli IA sémantique (niveau 2, Haiku) une fonctionnalité du module Command Menu, prévisualisation & PWA de Clustraly. Le repli IA sémantique (niveau 2, Haiku) déclenche Claude Haiku quand la recherche locale faiblit, et propose jusqu'à trois actions classées par confiance.

Niveau 2 du Command Menu : quand la recherche floue locale ne renvoie rien de convaincant, Claude Haiku lit votre intention et propose au plus trois pistes sans jamais bloquer l'ouverture du menu.

Le bénéfice

Décrivez l'intention, retrouvez l'action même sans le bon libellé

Vous savez ce que vous voulez faire, pas forcément comment Clustraly l'a nommé. Quand vos mots ne collent à aucun libellé, la recherche exacte reste muette. Le repli IA sémantique prend le relais et propose jusqu'à trois actions qui correspondent à votre intention.

Chaque piste arrive avec une raison de un à trois mots, pour comprendre d'un coup d'œil pourquoi elle vous est suggérée.

  • Comprend l'approximation, le synonyme, la formulation naturelle
  • Au plus 3 suggestions, classées par confiance
  • Chaque piste annotée d'une raison courte (1 à 3 mots)
Fonctionnement

Un appel ciblé à Claude Haiku, avec votre index filtré par permissions

Le client envoie votre requête et l'index d'entrées déjà filtré par vos permissions à Claude Haiku via POST /admin/api/command-intent. Le modèle renvoie au plus trois suggestions ordonnées par confiance, restituées dans un groupe dédié « AI suggestions ✨ · <raison> ».

Les pistes déjà affichées par la recherche locale sont dédupliquées : pas de doublon, seulement ce que le niveau 1 n'avait pas su trouver.

  • POST /admin/api/command-intent → AiService::commandIntent
  • Index d'entrées filtré par permissions transmis au modèle
  • Résultats dédupliqués face aux lignes déjà visibles
  • Chaque appel journalisé dans ai_requests (budget #39)
Sobriété

Déclenché avec parcimonie, un seul appel facturable à la fois

Le repli ne part jamais à la moindre frappe. Il n'appelle le modèle que si la meilleure correspondance locale reste faible (score ≤ 45), 600 ms après que vous ayez cessé de taper, et avec un unique appel facturable en cours.

Résultat : l'IA n'intervient que là où elle apporte vraiment quelque chose, sans multiplier les requêtes pendant que vous tapez.

  • Ne se déclenche que si le meilleur score lexical est ≤ 45
  • Attend 600 ms après l'arrêt de la frappe
  • Un seul appel facturable en cours à la fois
  • Requête bornée à 3–190 caractères
Garde-fous

Fail-open absolu : le menu ne se bloque jamais

Pas de clé API, budget épuisé, timeout ou n'importe quelle erreur ? Le service renvoie un groupe vide en HTTP 200. La recherche locale continue, le Command Menu reste pleinement utilisable l'IA est un bonus, jamais un point de rupture.

L'accès est protégé par un rate-limit dédié (bucket « ai ») et par CSRF, et l'index soumis au modèle est filtré par vos permissions : aucune action hors de votre portée n'est suggérée.

  • Toute erreur → groupe vide, HTTP 200 (jamais bloquant)
  • Rate-limit bucket « ai » + protection CSRF
  • Suggestions bornées à vos permissions
Cas d'usage

Là où le repli sémantique vous fait gagner du temps

Un nouvel arrivant qui ne connaît pas encore l'arborescence, un libellé oublié, un synonyme, une phrase tapée en langage naturel : autant de moments où la recherche exacte cale, alors que l'intention, elle, reste claire.

  • Vous ne vous souvenez plus du nom exact d'un écran
  • Vous tapez un synonyme ou une approximation
  • Vous formulez votre besoin en langage naturel
  • Vous découvrez l'admin et cherchez par intention
Pourquoi ça compte

L'IA propose, vous décidez

Le repli sémantique ne clique jamais à votre place. Il place au plus trois pistes classées par confiance, chacune annotée d'une raison courte ; l'ouverture et le choix restent votre geste.

FAQ

Questions fréquentes

Quand le repli IA sémantique (niveau 2, Haiku) se déclenche-t-il ?
Seulement quand la recherche locale faiblit : meilleur score lexical ≤ 45, 600 ms après l'arrêt de la frappe, pour une requête de 3 à 190 caractères, avec un seul appel facturable en cours.
Que se passe-t-il en cas d'erreur ou de budget épuisé ?
Fail-open absolu. Absence de clé API, budget épuisé, timeout ou toute autre erreur renvoient un groupe vide en HTTP 200 : le Command Menu et sa recherche locale restent pleinement fonctionnels.
Le modèle peut-il proposer des actions auxquelles je n'ai pas accès ?
Non. L'index d'entrées envoyé à Claude Haiku est filtré par vos permissions, et l'appel est protégé par un rate-limit « ai » et par CSRF. Seules des actions autorisées peuvent vous être suggérées.
Combien de suggestions, et sous quelle forme ?
Au plus trois, ordonnées par confiance, chacune accompagnée d'une raison de un à trois mots. Elles s'affichent dans un groupe « AI suggestions ✨ · <raison> », dédupliqué face aux résultats déjà présents à l'écran.
Prêt à commencer ?

Un filet sémantique discret, jamais un péage

Le repli IA sémantique (niveau 2, Haiku) comble l'angle mort de la recherche exacte : il lit votre intention quand les mots ne collent pas, propose au plus trois pistes classées par confiance, et s'efface totalement à la moindre indisponibilité. L'IA propose, vous décidez et le menu, lui, ne s'arrête jamais.