Docs / Recherche

Recherche

aqoon utilise la recherche hybride — une combinaison de recherche sémantique (basée sur le sens) et par mots-clés — pour trouver le contenu le plus pertinent dans vos documents.

Il existe plusieurs façons de rechercher dans votre base de connaissances :

  • MCP — Connectez Claude Desktop ou Claude Code via MCP et utilisez l'outil search_documents. Voir Configuration MCP.
  • API — Envoyez une requête POST /api/search/ avec votre clé API. Voir Référence API.
  • Playground — Utilisez le Playground de recherche interactif pour tester des requêtes avec votre clé API.

Vous pouvez éventuellement filtrer par une collection spécifique pour affiner les résultats. La limite par défaut est de 10 résultats (configurable de 1 à 50 via l'API).

Comprendre les résultats

Chaque résultat affiche :

  • Titre du document — Le document source
  • Collection — À quelle collection appartient le document
  • Pertinence — Les résultats sont classés selon la correspondance entre le contenu et votre requête, les plus pertinents en premier
  • Extrait de contenu — Un aperçu du texte correspondant
  • Tags — Tous les tags attribués au document

Conseils de recherche

  • Soyez précis — « chiffre d'affaires trimestriel 2025 » fonctionne mieux que « chiffre d'affaires »
  • Utilisez le langage naturel — La recherche sémantique comprend le sens, donc « comment réinitialiser un mot de passe » et « instructions de réinitialisation de mot de passe » fonctionnent tous les deux
  • Filtrez par collection — Si vous savez quelle collection contient la réponse, le filtrage accélère la recherche et améliore la pertinence
  • Vérifiez le statut d'indexation — Seuls les documents avec le statut Indexé apparaissent dans les résultats de recherche. Si vous venez de télécharger un document, attendez la fin du traitement.

Ce qui est recherché

La recherche couvre toutes les collections visibles pour vous :

  • Les collections que vous possédez
  • Les collections publiques auxquelles vous êtes abonné

Vous ne verrez pas de résultats provenant des collections privées d'autres utilisateurs ou des collections publiques auxquelles vous n'êtes pas abonné.