search interroge la base de connaissance clinique et renvoie des unités
documentaires structurées — jamais un bloc de texte libre. C’est la fondation
de retrieval sur laquelle reposent les autres capacités.
Endpoint : POST /v1/search · Outil MCP : search
Quand l’utiliser
- Vous voulez les sources brutes d’une requête, pour les afficher ou les citer.
- Vous construisez votre propre synthèse et n’avez besoin que du retrieval.
Pour une réponse rédigée plutôt que des sources, utilisez answer.
Requête
| Champ | Type | Notes |
|---|
query | string | Requête clinique en texte libre (français). |
source_ids | int[] | Optionnel. Restreindre à des sources précises. |
limit | int | Nombre max d’unités documentaires (défaut 10). |
max_chunks_per_unit | int | Meilleurs extraits gardés par unité (défaut 3). |
Réponse
Chaque unité est un document source avec ses meilleurs extraits :
{
"query": "antibioprophylaxie chirurgie colorectale",
"units": [
{
"document_id": 14853,
"document_title": "Antibioprophylaxie en chirurgie",
"reco_id": 900,
"reco_title": "Chirurgie colorectale",
"source_id": 3,
"source_name": "SFAR",
"year": "2023",
"deep_link": "https://.../14853.pdf",
"score": 0.91,
"chunks": [
{ "chunk_index": 0, "content": "Céfazoline en dose unique...", "score": 0.91 }
]
}
],
"retrieved_pool": 100
}
limit plafonne le nombre d’unités documentaires, pas d’extraits.
retrieved_pool est le compteur diagnostique d’extraits balayés avant
regroupement — il n’est pas borné par limit.
