ForHosting KIT · Recherche sémantique

Reformulation de requête

La reformulation de requête transforme une question floue ou trop courte en une ou plusieurs requêtes plus explicites, afin qu’un moteur de recherche retrouve les bons documents. L’outil clarifie l’intention, ajoute les termes implicites et peut produire des variantes, ce qui améliore le rappel d’un système de recherche sémantique sans changer la question de l’utilisateur.

● Stablepar requête + par recherche$0.003

Lancer — $0.003 + $0.0135/recherche Voir l’API

Utilisez-le depuis WebAPIE-mailApp bientôtTelegram bientôt

Exécuter en ligne

Exécutez cette tâche sur nos serveurs, avec votre compte. Les outils gratuits tournent dans votre navigateur ; celui-ci est facturé sur votre solde KIT au prix affiché ci-dessus.

Le problème que ça résout

Un utilisateur tape rarement la requête idéale. Il écrit trois mots, une abréviation, une question mal cadrée, et le moteur passe à côté de documents pourtant pertinents. La reformulation intervient en amont de la recherche : elle réécrit la requête pour exprimer ce que l’utilisateur cherche vraiment. Le moteur, lui, ne change pas ; c’est la question qu’on lui pose qui devient meilleure, donc les résultats aussi.

Une requête, plusieurs formulations

Au-delà de la simple clarification, l’outil peut générer plusieurs variantes d’une même requête : synonymes, terme technique et terme courant, singulier et pluriel, question et mots-clés. En lançant la recherche sur cet éventail plutôt que sur une seule tournure, un système sémantique élargit son rappel et rate moins de documents formulés autrement. C’est particulièrement utile quand le vocabulaire des documents diffère de celui des utilisateurs.

Où l’insérer dans votre chaîne

La reformulation se place juste avant l’étape de recherche, dans un système de questions-réponses, un moteur interne ou une base documentaire. Vous recevez la ou les requêtes réécrites, que vous transmettez ensuite à votre index. L’outil ne fait pas la recherche lui-même : il prépare la question. C’est une brique modeste, mais elle corrige souvent l’essentiel des recherches qui ne remontaient rien d’exploitable.

Ses limites, dites franchement

Reformuler ne crée pas d’information : si le document n’existe pas dans votre index, aucune réécriture ne le fera apparaître. Trop de variantes peuvent aussi diluer l’intention et remonter du bruit. L’outil travaille sur le sens supposé d’une question ; sur une requête déjà précise, son apport est marginal. Il brille sur le flou, pas sur ce qui était déjà clair.

Cas d’usage

Un moteur interne qui remontait le vide

Le Studio Lumen SAS a monté une recherche sur ses documents projet. Les employés tapaient « compte-rendu réu » et ne trouvaient rien ; en reformulant la requête en « compte rendu de réunion », le moteur retrouve enfin les bons fichiers.

Concilier deux vocabulaires

La documentation de la Menuiserie Rousseau & Fils parle de « quincaillerie » là où les clients écrivent « poignées » ou « charnières ». La reformulation génère les variantes utiles, si bien que la recherche relie la question courante au terme métier.

Des questions clients trop courtes

Sur une base d’aide, Thomas Rousseau constate que les visiteurs posent des questions de deux mots. En les réécrivant en requêtes explicites avant la recherche, le taux de réponses pertinentes progresse sans toucher au contenu.

Préparer une recherche sémantique

Avant d’interroger un index vectoriel, Nadia Benali fait reformuler les requêtes ambiguës. Les termes implicites étant rendus explicites, la recherche sémantique remonte des passages qu’une requête brute aurait manqués.

Questions fréquentes

En quoi est-ce différent d’une recherche classique ?

L’outil ne cherche pas : il réécrit la question avant la recherche. Là où un moteur par mots-clés exige les termes exacts, la reformulation traduit une question floue en requête précise, que vous envoyez ensuite à votre propre index. C’est une étape préparatoire, pas un moteur.

Combien de variantes obtient-on ?

Cela dépend de ce que vous demandez : une seule requête clarifiée, ou un petit ensemble de formulations complémentaires. Un éventail large améliore le rappel mais peut ajouter du bruit ; sur une base homogène, deux ou trois variantes suffisent souvent à couvrir l’essentiel.

Ma requête est-elle conservée ?

Le texte de la requête est traité pour produire la reformulation, puis n’est pas conservé au-delà. Comme il s’agit souvent d’une simple question de quelques mots, la surface de données est réduite ; évitez malgré tout d’y glisser des informations sensibles inutiles à la recherche.

Quel est le prix d’une reformulation ?

Le tarif est affiché, sans abonnement: $0.003 par requête et $0.0135 par reformulation. Vous payez à l’unité, uniquement ce que vous traitez, et l’achat se fait directement, sans compte.

Faut-il l’intégrer par programmation ?

Pas nécessairement. Cette page réécrit une requête à la volée pour tester le résultat. Pour l’insérer dans une chaîne de recherche, l’API fournit la même fonction, à appeler avant votre étape de recherche ; d’autres canaux suivront.

Dans quelle langue fonctionne-t-elle ?

La reformulation traite la requête dans sa langue et rend une version française claire si vous travaillez en français. Le vocabulaire technique courant est reconnu ; pour un jargon très spécialisé, précisez le domaine afin d’orienter les termes retenus.

Pour les développeurs — accès API

Tout sur cette page est disponible par programmation. Cette section s'adresse aux équipes qui veulent l'intégrer à leurs systèmes ; les autres peuvent simplement utiliser l'outil ci-dessus.

Endpoint

POSThttps://api.kit.forhosting.com/rag/query-rewrite

Authentification par jeton Bearer : un seul POST met la tâche en file d’attente, et le résultat vous parvient par webhook ou lien signé.

Appeler depuis votre stack

curl -X POST https://api.kit.forhosting.com/rag/query-rewrite \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d &#39;{"input":"…"}'

const res = await fetch("https://api.kit.forhosting.com/rag/query-rewrite", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "input": "…"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/rag/query-rewrite",
    headers={"Authorization": f"Bearer {os.environ[&#39;KIT_KEY']}"},
    json={
    "input": "…"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/rag/query-rewrite", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => &#39;{"input":"…"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"input":"…"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/rag/query-rewrite", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Exemple de requête

{
  "input": "…"
}

Exemple de réponse

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "rag.query_rewrite",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

L’API est asynchrone : chaque appel renvoie un task_id immédiatement, puis vous interrogez l’état à raison d’une requête par seconde.

Tarifs

par requête$0.003

par recherche$0.0135

Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.

Limites

`max_chunks`	10000
`max_tokens`	20000

Erreurs

HTTP	Code	Signification
`401`	`unauthorized`	Clé API absente ou invalide : vérifiez l’en-tête Authorization.
`402`	`insufficient_balance`	Solde insuffisant : rechargez votre compte pour lancer cette tâche.
`404`	`unknown_type`	Type de tâche inconnu : vérifiez le champ type de votre requête.
`429`	`rate_limited`	Trop de requêtes : ralentissez la cadence, puis réessayez.
`422`	`task_failed`	La tâche a échoué : elle ne vous est pas facturée.

Consulter la documentation complète du KIT →