Une fois connecté à Elium via MCP, un assistant utilise les outils ci-dessous pour trouver et lire vos contenus. Chaque outil s’exécute avec les droits de l’utilisateur authentifié : un assistant ne peut donc accéder qu’au contenu que cet utilisateur est déjà autorisé à voir dans Elium.

Outil	Rôle
`findRelevantArticles`	Cherche dans toute la base de connaissances par le sens. La méthode par défaut pour répondre à une question.
`findSpecificArticles`	Cherche avec des filtres : mots-clés, modèle, espaces, plage de dates.
`readArticle`	Renvoie le contenu et les métadonnées d’un article, dont sa langue et sa version.
`readAsset`	Renvoie le texte brut d’un document joint à un article.
`findSpaces`	Liste les espaces auxquels l’utilisateur a accès.
`findTemplates`	Liste les modèles d’article disponibles.

`findRelevantArticles`

Effectue une recherche sémantique (basée sur le sens) dans toute la base de connaissances à partir d’une question en langage naturel et renvoie les articles les plus pertinents, classés par pertinence. Cet outil n’accepte ni filtre ni restriction de périmètre. C’est l’outil utilisé par défaut par un assistant pour répondre à une question.

Chaque résultat comprend le titre de l’article, un lien pour l’ouvrir et un extrait du contenu correspondant. Les extraits peuvent aussi provenir de documents joints, lorsque ceux-ci sont les plus pertinents.

`findSpecificArticles`

Exécute une recherche plus ciblée, lorsqu’un assistant a besoin de filtrer plutôt que de classer par sens. Elle prend en charge :

la recherche par mots-clés (un résultat doit contenir tous les termes fournis)
le filtrage par modèle, par espaces précis et par plage de dates
le choix de l’ordre de tri
la limitation du nombre de résultats (10 par défaut, 50 au maximum)

Utile pour des demandes telles que "les cinq articles les plus récents créés à partir du modèle Politique dans l’espace RH".

`readArticle`

Récupère le contenu d’un article à partir de son identifiant, au format Markdown, ainsi que ses principales métadonnées : propriétaire, espace, modèle, tags, attributs personnalisés éventuels (libellé et valeur), date de revue ou d’expiration, statut d’approbation, date de dernière version et indication si l’article est archivé.

Un assistant appelle généralement cet outil après une recherche, lorsqu’il a besoin de plus de contexte que ce que fournit un extrait. Il utilise les métadonnées pour évaluer l’actualité et la fiabilité du contenu.

Lorsqu’ils sont renseignés, le propriétaire, l’espace et le modèle sont chacun désignés par un identifiant et un nom. Les informations de vérification aident l’assistant à préciser le statut de ses sources :

Information	Comment l’interpréter
Date de revue ou d’expiration	Une date passée indique que la revue est en retard. Une date future indique que l’échéance n’est pas encore atteinte. Sans date, aucune expiration n’est définie.
Statut d’approbation	Indique si la dernière procédure d’approbation visible pour vous a abouti à une publication, attend une approbation, nécessite une correction ou a été annulée.
Date de dernière version	Date de publication de la version active, ou de sa création si elle n’est pas publiée. Elle ne correspond pas à chaque modification.
Archivage	Indique si l’article est archivé.

Le résultat précise aussi la langue, les traductions disponibles et la version lue. L’assistant peut demander le dernier brouillon avec draft: true, si vous avez le droit d’y accéder.

`readAsset`

Récupère le texte brut d’un document (fichier) joint à un article. Utilisez cet outil lorsqu’il faut plus de détails qu’un extrait de findRelevantArticles, ou lorsque le corps de readArticle fait référence à un document à lire en entier.

L’outil demande deux identifiants : l’ID de l’article et l’UUID du document. L’UUID provient d’un résultat de findRelevantArticles (le champ doc_uuid) ou d’un élément <el-asset>, <el-asset-inline> ou <el-asset-link> dans le corps renvoyé par readArticle (l’attribut data-asset).

Renvoie null si l’article ou le document est introuvable. Si aucun texte n’a pu être extrait (par exemple, le fichier est une image ou son texte n’est pas encore disponible), l’outil refuse en indiquant le lien vers l’article.

`findSpaces`

Liste les espaces auxquels vous avez accès. L’assistant peut ainsi comprendre l’organisation de votre plateforme et utiliser les identifiants d’espace pour restreindre une recherche avec findSpecificArticles.

Un filtre facultatif recherche dans le nom des espaces, sans tenir compte des majuscules ni des accents. Les résultats sont classés par nom et limités à 50 espaces par requête, même sans filtre. Si l’espace recherché n’apparaît pas, précisez son nom. Les espaces archivés sont exclus.

Chaque résultat comprend l’identifiant, le nom, le lien et le type de visibilité de l’espace, ainsi que sa description et son groupe d’espaces s’ils sont renseignés. Il précise aussi votre rôle, le nombre de membres et vos droits de création et de publication. Si vous pouvez créer du contenu sans pouvoir le publier directement, une approbation est nécessaire avant publication.

Utile comme première étape avant une recherche ciblée, ou pour des demandes telles que "dans quels espaces puis-je publier ?".

`findTemplates`

Liste les modèles d’article (types d’article) activés pour toute la plateforme ou installés dans des espaces que vous pouvez voir. Chaque résultat comprend l’identifiant du modèle, son nom, son icône si elle est définie et une indication de sa disponibilité dans tous les espaces. Pour un modèle installé dans des espaces précis, seuls les identifiants des espaces visibles pour vous sont renvoyés.

Le filtre facultatif sur le nom fonctionne comme celui de findSpaces. Les résultats sont classés par nom et limités à 50 modèles par requête. Si le modèle recherché n’apparaît pas, précisez son nom.

Cela permet à un assistant de trouver le bon modèle avant de filtrer une recherche, pour des demandes telles que "trouve tous les articles qui utilisent le modèle FAQ".

Rechercher et lire du contenu avec MCP

findRelevantArticles

findSpecificArticles

readArticle

readAsset

findSpaces