> 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/projet-data-and-ia/studio-ai/agents.md).

# Agents

Les Agents sont des configurations prêtes à l'emploi qui définissent le comportement d'une intelligence artificielle pour un usage particulier. Chaque Agent regroupe un prompt structuré, une sélection d'Apps issus de La Fabrique. Cette approche permet de créer des capacités IA spécialisées, tout en facilitant leur réutilisation et leur partage au sein de votre organisation.

Les Agents s'utilisent directement dans Le Druide et peuvent être partagés avec d'autres utilisateurs.

## Créer un Agent

**Objectif** : Définir une capacité IA réutilisable adaptée à un besoin métier spécifique.

**Étapes de création**

1. Accédez au Studio IA de votre projet
2. Cliquez sur l'onglet **Agent**
3. Cliquez sur **Créer un Agent**
4. Renseignez les métadonnées :
   * **Nom** : choisissez un nom explicite (obligatoire)
   * **Description** : décrivez l'objectif de l'Agent (optionnel)
   * **Icône** : sélectionnez une icône pour faciliter l'identification
5. Configurez les **Instructions** :
   * Rédigez le prompt qui définira le comportement de l'IA
   * Utilisez l'exemple pré-rempli comme point de départ
6. Sélectionnez les **Apps** :
   * Choisissez un ou plusieurs outils depuis La Fabrique
   * Seuls les outils déployés sont disponibles
7. Ajoutez un périmètre de connaissance :
   * Uploadez un ou plusieurs fichiers comme sources de connaissance
   * Ces fichiers sont conservés dans l'Agent et accessibles à tous les membres du projet ayant accès à l'Agent
   * Formats supportés : `.txt`, `.pdf`, `.docx`, `.pptx`
8. Cliquez sur **Sauvegarder** ou **Publier** selon vos besoins

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

**Bon à savoir**

* Un Agen sauvegardé sans publication est créé avec le statut **Test** et reste utilisable par tous les membres du projet
* L'Agent est automatiquement rattaché au projet courant
* Aucun assistant dédié n'est créé lors de la création d'un Agent

## Utiliser un Agent

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

### **Depuis le projet**

Tous les membres du projet peuvent utiliser les Agents disponibles, qu'ils soient en statut Test ou Published.

1. Accédez au Druide
2. Sélectionnez l'Agent souhaité depuis la liste des agents disponibles
3. Démarrez votre conversation

{% hint style="info" %}
Un seul Agent peut être actif à la fois. Son activation désactive le contexte générique du Druide. Les Apps associés sont activés par défaut. Pour revenir au comportement générique du Druide, quittez l'Agent actif.
{% endhint %}

### **Depuis Mes Apps**

Si un Agent vous a été partagé par un autre projet :

1. Accédez à **Mes Apps**
2. Identifiez l'Agent dans le listing
3. Cliquez sur **Utiliser** pour ouvrir Le Druide avec l'agent activé

### **Ajouter des pièces jointes**

Lors d'une conversation avec un Agent actif, vous pouvez enrichir ponctuellement votre échange en ajoutant des fichiers via le bouton **Pièces jointes**.

* Les fichiers sont utilisés par l'IA pour la conversation en cours uniquement
* Ils ne modifient pas la configuration de l'Agent et ne sont pas visibles par les autres utilisateurs
* Formats supportés : `.txt`, `.pdf`, `.docx`, `.pptx`
* 5 Mo max par fichier

{% hint style="info" %}
Les pièces jointes sont différentes du périmètre de connaissance : elles sont temporaires et limitées à la conversation en cours. Pour enrichir durablement un Agents, ajoutez des fichiers via le périmètre de connaissance à la création.
{% endhint %}

### **Historique de conversations**

Chaque Agent dispose de son propre historique de conversations, isolé du contexte générique du Druide et des autres Agents.

* Les conversations démarrées dans un Agent sont uniquement visibles depuis cet agent
* Le changement d'Agent crée automatiquement une nouvelle conversation, il n'est pas possible de reprendre une conversation existante lors d'un changement d'agent
* La suppression d'un Agent rend ses conversations inaccessibles
* La révocation d'un partage empêche l'accès aux conversations associées à l'Agent

{% hint style="info" %}
Le passage d'un Agent du statut Test à Published ne modifie pas les conversations existantes.
{% endhint %}

### **Consulter le détail d'un Agent**

Pour mieux comprendre les capacités d'un Agent :

1. Depuis le Studio IA ou Mes Apps, cliquez sur le bouton **Informations** de la carte Agent. Depuis une conversation avec un Agent actif, cliquez sur **Ouvrir le panneau d'information** à côté du nom de l'Agent.
2. Consultez les onglets disponibles :
   * **Informations** : nom, description, responsable, instructions
   * **Tools** : liste des outils associés et leur statut
   * **Partage** : utilisateurs ayant accès à l'Agent

{% hint style="info" %}
Si un Agent utilise des Tools nécessitant des variables d'environnement (clés API, tokens), vous devez les configurer dans La Fabrique avant de pouvoir utiliser ces outils. Pour les utilisateurs n'ayant accès qu'au Druide, la configuration des variables d'environnement est disponible directement depuis l'interface via la liste des Tools.
{% endhint %}

## Gérer les Agents

### Modifier un Agent

Seul le responsable de l'Agent peut le modifier.

1. Depuis le Studio IA, accédez au détail de l'Agent
2. Cliquez sur **Modifier**
3. Modifiez les éléments souhaités (nom, description, instructions, Tools)
4. Cliquez sur **Sauvegarder** pour appliquer les changements

{% hint style="info" %}
Les modifications n'affectent pas les conversations en cours mais s'appliquent aux **nouveaux messages** des conversations reprises.
{% endhint %}

## Publier un Agent

La publication indique que l'Agent a été testé et validé, et qu'il peut être utilisé en confiance.

1. Depuis le Studio IA, accédez au détail de l'Agent en statut Test
2. Cliquez sur **Publier**
3. Confirmez la publication

Le statut passe à **Published** mais les règles d'accès et le comportement de l'Agent restent inchangés.

## Supprimer un Agent

Seul le responsable peut supprimer un Agent. Cette action est irréversible.

1. Depuis le Studio IA, accédez au détail de l'Agent
2. Cliquez sur **Supprimer**
3. Confirmez la suppression

{% hint style="warning" %}
La suppression rend l'Agent immédiatement inaccessible pour tous les utilisateurs et supprime l'accès aux conversations associées
{% endhint %}

## Partager un Agent

#### Partager avec des membres hors projet

Les membres du projet peuvent partager un Agent avec d'autres utilisateurs Cleyrop ne faisant pas partie du projet.

1. Depuis le Studio IA, cliquez sur l'action **Partager** sur la carte de l'Agent
2. Sélectionnez un ou plusieurs membres Cleyrop
3. Confirmez le partage

Les utilisateurs sélectionnés pourront :

* Voir l'Agent dans **Mes Apps**
* L'utiliser dans leur Druide
* Consulter ses informations en lecture seule

Ils ne pourront pas le modifier, le republier ou le partager à leur tour.

#### Retirer un partage

1. Accédez au détail de l'Agent
2. Dans l'onglet **Partage**, identifiez l'utilisateur concerné
3. Cliquez sur **Retirer l'accès**
4. Confirmez la révocation

L'Agent disparaît immédiatement de l'espace **Mes Apps** de l'utilisateur et ne peut plus être utilisé.

## Droits et responsabilités

#### Responsable de l'Agent

Le créateur d'un Agent en devient automatiquement le responsable. Il peut :

* Modifier l'Agent
* Publier ou dépublier l'Agent
* Partager l'Agent avec d'autres utilisateurs
* Supprimer l'Agent

#### Membres du projet

Les membres du projet (PM, Data Worker) peuvent :

* Consulter tous les Agents du projet
* Utiliser tous les Agents (Test ou Published)
* Partager les Agents avec des membres hors projet

#### Utilisateurs hors projet

Les utilisateurs avec qui un Agent a été partagé peuvent :

* Consulter les informations de l'Agent en lecture seule
* Utiliser l'Agent dans leur Druide

#### Transfert de responsabilité

Le responsable d'un Agent ou le responsable du projet peut modifier le responsable de l'Agent.

1. Accédez au détail de l'Agent
2. Cliquez sur **Modifier le responsable** (à côté du nom du responsable actuel)
3. Sélectionnez un nouveau responsable parmi les membres du projet
4. Confirmez le transfert

Le nouveau responsable dispose immédiatement de tous les droits de gestion. L'ancien responsable conserve les droits liés à son rôle projet.

**Bon à savoir** : lors de la suppression ou désactivation d'un utilisateur responsable d'Agents, ceux-ci sont automatiquement transférés au responsable du projet.

***

### Bonnes pratiques

* **Nommez explicitement vos Agents** : utilisez des noms qui reflètent clairement l'usage métier (ex : "Analyse de tickets support", "Génération de rapports financiers")
* **Documentez vos instructions** : rédigez des prompts précis et structurés pour garantir un comportement cohérent
* **Testez avant de publier** : utilisez le statut Test pour valider le comportement de l'Agent avant de le marquer comme Published
* **Limitez le nombre Tools** : sélectionnez uniquement les outils nécessaires pour éviter la complexité inutile
* **Partagez de manière ciblée** : ne partagez les agents qu'avec les utilisateurs qui en ont réellement besoin
* **Vérifiez les variables d'environnement** : assurez-vous que les utilisateurs disposent des clés API requises avant de partager un Agent utilisant des tools externes