> For the complete documentation index, see [llms.txt](https://cleyrop.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cleyrop.gitbook.io/docs/v-4.5/le-druide/utiliser-les-agents-et-les-tools.md).

# Utiliser les Agents et les Tools

Le Druide peut s'appuyer sur deux types de ressources pour étendre ses capacités : les **Agents** et les **Tools**.

**Exemples d’usages**

* “Résume ce document PDF en 5 points clés.”
* “Génère un mail de synthèse à partir de cette note.”
* “Lance une recherche sur les tendances de la décarbonation.”

***

## Consulter les outils d’un Tool

Dans la fiche d’un Tool, un onglet Outils, vous pouvez consulter la **liste des outils** et pour chaque outil disponible :

* **Description** : ce que fait l’outil, et dans quel cas l’utiliser.
* **Paramètres d’entrée** : les champs attendus, leur type et leur rôle.
* **Paramètres de sortie** : la structure des données retournées.

## Utiliser les outils Cleyrop

Cleyrop met à disposition plusieurs tools officiels, testés et maintenus par nos équipes :

<table><thead><tr><th width="298.40625">Tool</th><th>Description</th></tr></thead><tbody><tr><td>🌐 Recherche Internet</td><td>Permet d’effectuer une recherche en ligne sécurisée pour enrichir les réponses.</td></tr><tr><td>📊 <a href="/pages/JDezStmOSm79eaCJIYMJ">Recherche dataset</a></td><td>Interrogation de Dataset et analyse</td></tr><tr><td>🧠 <a href="/pages/xF21cY00Wym4qKjl2ePS">Recherche Corpus</a> - RAG (Retrieval-Augmented Generation)</td><td>Interrogation de Corpus - documents internes pour des réponses contextualisées.</td></tr></tbody></table>

Les tools Recherche Dataset et Recherche Corpus, nécessitent un token d'accès pour fonctionner. Ce token est à générer depuis votre **Espace personnel → Profil & Tokens** et à renseigner dans la configuration du tool via le bouton ⚙️.

Ces outils sont complétés par les Tools développés via **La Fabrique**.

## Configurer des variables utilisateur

Certains Tools nécessitent la **configuration préalable de variables utilisateur** (par exemple : clés API, identifiants ou paramètres personnalisés).

Lorsqu’un outil requiert une configuration, une icône ⚙️ apparaît à côté de son nom dans Le Druide.

<figure><img src="/files/2eBmZaCZsWIIcewyosgV" alt=""><figcaption></figcaption></figure>

Vous pouvez définir ou modifier ces variables :

* directement depuis Le Druide, via le bouton ⚙️ associé à l’outil,
* ou depuis la liste des Apps / la fiche détaillée du Tool.

Une fois les variables renseignées, l’outil devient immédiatement opérationnel pour vos interactions.

## Tester les Tools pour les développeurs

Le Druide n’est pas seulement un outil métier : il sert aussi de client natif de test pour les développeurs.

Dès qu’un nouveau Tool est déployé via **La Fabrique**, il devient **accessible depuis Le Druide**, sans besoin de créer une interface dédiée.

Cela permet de :

* **tester immédiatement** le bon fonctionnement de vos Tools,
* observer les entrées/sorties en conditions réelles,
* valider les **comportements d’appel** (latence, erreurs, logs),
* et collecter du **feedback** utilisateur avant d’intégrer le tool dans un produit métier.

C’est un environnement de test idéal pour l’ingénierie d’apps, sans configuration supplémentaire.

***

## Bonnes pratiques

* Pour un résultat plus précis, n’activer que les Tools nécessaires à votre session.
