> 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/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.”

***

## Créer un Agent depuis Le Druide

Créez vos propres agents directement depuis Le Druide, sans passer par le Studio AI. Un agent créé ici est personnel et n'est pas partageable avec d'autres utilisateurs. Il peut être rattaché à un projet pour être réutilisé dans ce cadre.

1. Depuis Le Druide, ouvrez le formulaire de création d'agent.
2. Renseignez les **champs obligatoires** de l'agent.
3. Validez la création.

<figure><img src="/files/DeLB7sKY1knURVfisLQa" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
L'étape d'ajout d'un dataset n'apparaît que si le tool **Cleyrop Dataset** est coché.

Les agents créés depuis Le Druide sont personnels et non partageables. Pour un agent partagé à l'échelle d'un projet ou d'une organisation, passez par le Studio AI.
{% endhint %}

## 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>🌐 Cleyrop 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">Cleyrop Dataset</a></td><td>Interrogation de Dataset et analyse</td></tr><tr><td>🧠 <a href="/pages/xF21cY00Wym4qKjl2ePS">Cleyrop Corpus</a> - RAG (Retrieval-Augmented Generation)</td><td>Interrogation de Corpus - documents internes pour des réponses contextualisées.</td></tr><tr><td>MCP La Fabrique</td><td>Déploiement d'applications depuis un agent IA : créer, builder et déployer une app Cleyrop sans passer par l'interface web.</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 ⚙️ depuis Le Druide ou depuis la fiche du Tool pour le modifier.&#x20;

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.
