Documentation

Recherche dans les connaissances

Les passages de la base de connaissances de Gaspard, classés par pertinence, avec leurs sources.

La recherche interroge directement la base de connaissances de Gaspard : des passages classés par pertinence, chacun avec sa source. Elle combine une recherche lexicale (BM25, les mots exacts) et une recherche sémantique (les embeddings, le sens), fusionnées. Utilisez-la pour une FAQ, une aide en ligne, ou pour donner des passages à votre propre modèle (RAG).

Scope knowledge:search, ouvert aux applications serveur et widget. Chaque recherche compte comme une unité dans l’usage de votre application.

Chercher #

POST /v1/public/knowledge/search :

Champ	Description
`query`	2 à 300 caractères
`limit`	1 à 10 passages (défaut 5)
`topics`	facultatif : `app`, `geography`, `history`, `culture`, `institutions`, `education`, `practical`, `transport`, `economy`, `nature`, `tourism`

Terminal

curl -X POST https://hubmix.dealmood-solutions.com/v1/public/knowledge/search \
  -H "Authorization: Bearer $VC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "ouvrir un compte bancaire à l’étranger", "limit": 5, "topics": ["practical"]}'

JSON

{
  "passages": [
    {
      "id": "…",
      "title": "…",
      "text": "…",
      "language": "fr",
      "topic": "practical",
      "score": 0.82,
      "source": { "name": "…", "url": "https://…", "licence": "CC BY-SA 4.0" },
      "redistribution": "full"
    }
  ]
}

Afficher les sources #

Chaque passage dit d’où il vient (source). Montrez le nom de la source et son lien à côté du texte, avec la licence quand il y en a une. Quand une source n’autorise que les faits (redistribution: "facts"), text est vide : affichez le titre et renvoyez vers la page d’origine. Détails : Données des annonces et attribution.

Erreurs : 403 insufficient_scope, 422 invalid_request. Voir Erreurs, limites et quotas.