Passer au contenu principal
Afficher en Markdown

Optimiseur de requêtes

L'optimiseur de requêtes réécrit une requête vague ou hésitante en une requête précise, ciblée et exploitable — avant de l'envoyer à l'agent. Déclenchez-le avec Cmd+Shift+Enter (macOS) / Ctrl+Shift+Enter (Linux), ou cliquez sur le bouton étincelle ✨ dans la barre d'outils de saisie.

Le déroulement

  1. Tapez une requête dans la zone de texte du tableau de bord
  2. Appuyez sur Cmd+Shift+Enter (ou cliquez sur ✨)
  3. Une superposition sombre apparaît : « ✨ Optimisation de la requête… » — la zone de texte devient en lecture seule et s'assombrit
  4. Le texte réécrit remplace le contenu de la zone de texte — vérifiez avant d'envoyer
  5. Appuyez sur Enter pour envoyer (aucun envoi automatique)

En cas d'erreur ou de texte inchangé, l'original est restauré silencieusement. Délai typique : 2 à 5 secondes.

Quand l'utiliser

L'optimisation est surtout utile lorsque l'original est :

  • Vague — « corrige ce truc » → obtient une portée, des fichiers et des contraintes ajoutés
  • Sous-spécifié — « ajoute l'authentification » → obtient les composants requis et les cas limites
  • Sans structure — un mur de texte → obtient des étapes numérotées
  • Incertain — hésitant avec « peut-être » ou « si tu pouvais » → remplacé par des verbes directs

L'optimisation est inutile lorsque la requête est déjà :

  • Précise et ciblée
  • Courte et sans ambiguïté (« Combien font 2+2? »)
  • Faisant référence à un fichier précis que l'agent devrait déjà comprendre

L'optimiseur le sait — il retourne l'original inchangé lorsqu'il n'y a rien à ajouter qui en vaille la peine.

Les règles que suit l'optimiseur

La requête système de l'optimiseur encode six règles (la première l'emporte en cas de conflit) :

  1. Ne jamais changer votre intention — aucune exigence ajoutée, aucune valeur inventée
  2. Retourner inchangé si la requête est déjà précise, ciblée et exploitable
  3. Lors de la réécriture, ajouter ce qui a été omis : portée, contraintes, structure, gestion de l'incertitude
  4. Remplacer les hésitations (« peut-être », « si tu pouvais ») par des verbes directs
  5. Ajouter « préserver le comportement existant » lorsque le changement porte sur un travail existant
  6. Ne jamais dépasser min(3 × original length, 250 words)

Exemple

Avant :

fix the zoom bug in the dashboard

Après :

Fix the zoom bug in the dashboard chat input. Scope: - `website/src/hooks/useZoom.ts` — cleanup CSS custom properties on unmount - `website/src/components/ChatInput.tsx` — cache the `effectiveVh()` result per render Constraints: - Preserve existing zoom-in and zoom-out gestures - Do not change the public API of `useZoom` - Run `npm run build` and `npm run test` before completing If you find related issues while fixing this, list them but do not fix them in this change.

Même intention, mais l'agent connaît maintenant les fichiers, les contraintes et où s'arrêter.

Quel contexte l'optimiseur voit-il

L'optimiseur reçoit :

  • Votre requête dans les balises <original_prompt>
  • Les ~10 derniers messages de la conversation (tronqués à 2 000 caractères)

Le contexte rend l'optimiseur plus intelligent lorsque vous êtes en pleine conversation : il capte les noms de fichiers, les messages d'erreur et la portée antérieure à partir de l'historique récent. Dans une nouvelle session, il travaille uniquement à partir de la requête.

Sous le capot

L'optimiseur fonctionne sur une session _optimizer dédiée avec l'agent kirocrew-lite — un petit agent sans outils, réglé pour des réécritures en une seule passe.

  • Indépendant de la session _bg partagée (qui gère la génération de titres et la catégorisation des dossiers)
  • Aucun appel d'outil — toute demande de permission d'outil pendant l'optimisation est rejetée d'emblée
  • Un asyncio.wait_for de 30 secondes enveloppe l'opération entière (prise de la session + diffusion + libération)
  • La sortie du LLM a une détection « UNCHANGED » intégrée — si le LLM décide que la requête est bonne, l'original est retourné

En cas de délai dépassé ou d'erreur, le texte original est restauré silencieusement. L'optimiseur ne plante jamais bruyamment.

Sécurité

La sortie passe par redact_credentials() et redact_exfiltration_urls() avant d'atteindre votre zone de texte. Si l'optimiseur fait apparaître un identifiant de connexion à partir du contexte, il est masqué.

Page mise à jour : 11 août 2026