# Agents IA & MCP

Sur Cards vous avez 2 possibilités pour utiliser des IA sous forme d'agent. Soit vous créez des agents utilisables directement dans l'interface de Cards, soit vous utilisez notre connecteur MCP pour connecter votre propre logiciel IA (Mistral, Claude, ou autres outils compatibles) à Cards.

Dans le cas des agents IA directement intégrés dans Cards, c'est OpenAI qui est utilisé comme moteur. L'utilisation de ces agents consomme vos crédits IA, alors que les MCP non (puisque c'est votre IA qui fait le traitement).

{% hint style="info" %}
[Contactez-nous](https://www.cards-microlearning.com/contact) pour activer l'intégration Agents IA & MCP.
{% endhint %}

### Liste des agents et MCP

<figure><img src="https://1899807099-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAsW3Pbi7E5c7rFM4FYSg%2Fuploads%2FsmZDQ9IEjfYFyCjdwJOS%2Fai-agents-list.jpg?alt=media&#x26;token=a493bc1a-7981-487b-ab80-a19a2ba612ea" alt=""><figcaption><p>Liste des agents</p></figcaption></figure>

La liste des agents IA et MCP est disponible depuis la page "App et intégrations", puis "Agents IA et connecteurs MCP". Les onglets vous permettent de voir le listing des Agents IA, ou des connecteurs MCP.

Dans le listing des agents IA, vous trouverez un 1er bloc qui liste vos agents (ceux que vous avez créés), et un 2ème bloc qui liste les agents créés par les autres membres de votre équipe.

### Que peut faire un agent ?

Un agent IA a accès à une liste d'outils, lui permettant d'interagir directement avec le contenu de votre espace Cards. Ces outils sont les mêmes pour les connecteurs MCP.

Les outils sont les suivants :&#x20;

* Trainings Tool : lui permet d'accéder aux formations, d'en créer et d'en éditer
* Chapters Tool : accéder aux chapitres, créer des chapitres, les modifier et les supprimer
* Cards Tool : accéder aux cartes de contenus, créer des contenus, les modifier et les supprimer
* Categories Tool : accéder, créer et éditer des catégories de formation
* Routines Tool : accéder, créer, éditer des routines (et lister les catégories de routines)
* Steps Tool : accéder, créer, éditer et supprimer des étapes de routines
* Giphy Search Tool : rechercher des gifs sur Giphy
* Unsplash Search Tool : rechercher des images sur Unsplash
* Youtube Search Tool : rechercher des vidéos sur Youtube
* Image Upload Tool : charger une image dans vos médias depuis une url.

Les agents dans Cards ont accès à l'ensemble de ces outils.

Pour les connecteurs MCP, vous pouvez en général décider d'activer ou non ces outils dans votre logiciel IA.

Pour un contrôle des permissions plus poussé, vous pouvez créer un rôle personnalisé spécifique à votre agent IA ou votre connecteur. Ce contrôle de permissions s'appliquant côté Cards, aucun connecteur ou agent ne pourra l'outrepasser.

Pour en savoir plus, rendez-vous sur la documentation "[Rôles personnalisés](https://doc.cards-microlearning.com/mon-espace/roles-personnalises)".

### Agents IA

#### Créer un agent

<figure><img src="https://1899807099-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAsW3Pbi7E5c7rFM4FYSg%2Fuploads%2FGI64VuqGnoH6ymCUpfe8%2Fai-agents-edit.jpg?alt=media&#x26;token=1fa0ef8a-fc47-4be4-9ca3-117170aa725a" alt=""><figcaption><p>Création et édition d'un agent IA</p></figcaption></figure>

Quand vous créez un agent IA, vous lui donnez un prénom, un nom et un rôle.

Les contenus créés par cet agent seront donc facilement identifiables dans les listings de vos contenus (la colonne "auteur" affichera le prénom et nom de l'agent).

Le rôle à choisir doit être un rôle personnalisé. Pour en savoir plus, rendez-vous sur la documentation "[Rôles personnalisés](https://doc.cards-microlearning.com/mon-espace/roles-personnalises)". En lui attribuant un rôle personnalisé, vous avez la possibilité de limiter ses actions sur vos contenus (par exemple pour lui autoriser seulement l'édition sur ses propres formations, et pas celles des autres éditeurs).

Plusieurs paramètres de configuration sont disponibles dans la colonne de droite :&#x20;

* Type d'agent : permet de choisir le comportement de l'agent
* Instructions personnalisées : vous permet de "prompter" l'agent en lui donnant des instructions qui s'appliqueront lorsque vous ferez appel à lui
* Disponibilité :&#x20;
  * privé : vous seul pouvez utiliser l'agent
  * public : l'agent pourra être utilisé par les autres éditeurs de votre espace.

#### Utiliser un agent

<figure><img src="https://1899807099-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAsW3Pbi7E5c7rFM4FYSg%2Fuploads%2FaCBCqDUVjJgelThPJWaC%2Fdemo-agents.gif?alt=media&#x26;token=22fc2dec-8937-4c99-9cf2-f12bfb2b5073" alt=""><figcaption><p>Utilisation d'un agent</p></figcaption></figure>

Pour utiliser un agent IA, cliquez sur la bulle "IA" en bas à droite. Un panel s'ouvrira sur le côté, vous permettant de sélectionner l'agent à utiliser.

Une fois l'agent sélectionné, un système de chat apparaît, et vous pouvez directement discuter avec l'agent IA. Dans ce chat, en haut à droite, vous pouvez afficher vos anciennes discussions, et donc reprendre une conversation là où vous l'aviez laissée.

L'agent connaît votre prénom et nom, ce qui lui permet de savoir quels contenus vous avez créés. En revanche, actuellement, il ne "voit" pas sur quelle page vous êtes : il faut donc lui préciser le nom de la formation ou son ID si vous souhaitez que l'agent interagisse avec.

### Connecteur MCP

<figure><img src="https://1899807099-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAsW3Pbi7E5c7rFM4FYSg%2Fuploads%2FzDrZ07IWru6GGtsMv2Iz%2Fmcp-edit.jpg?alt=media&#x26;token=3b214b69-a9b9-48cd-b323-4032b51c8557" alt=""><figcaption><p>Création et édition d'un connecteur MCP</p></figcaption></figure>

Pour créer un connecteur, vous devez, comme pour les agents, choisir un prénom, nom et rôle.

Une fois le connecteur créé, une fenêtre s'affiche avec votre jeton d'identification. Ce jeton n'est affiché qu'une fois. Copiez-le, vous en aurez besoin dans votre logiciel IA (Mistral ou Claude par exemple).

Sur la page d'édition d'un MCP, vous pouvez si besoin regénérer un jeton. L'ancien jeton sera supprimé et ne pourra donc plus être utilisé.

### Utilisation avec Mistral

Pour utiliser le MCP Cards dans Mistral, rendez-vous sur Le Chat (<https://chat.mistral.ai/chat>), puis utilisez le menu "Intelligence" > "Connecteurs".

<figure><img src="https://1899807099-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAsW3Pbi7E5c7rFM4FYSg%2Fuploads%2FwrTwQIS185yaV0B80x5o%2Fmistral-connectors.jpg?alt=media&#x26;token=3c7d9453-9195-4339-99ec-e527fecfad1b" alt=""><figcaption><p>Liste des connecteurs Mistral</p></figcaption></figure>

Sur cette page, cliquez sur le bouton "Ajouter un connecteur". Une modal s'ouvre pour ajouter un connecteur. Cliquez sur l'onglet "Connecteur MCP personnalisé".

Vous pouvez alors renseigner les informations du MCP :&#x20;

* Nom : Cards
* Serveur du connecteur : <https://api.cards-microlearning.com/mcp/cards>

<figure><img src="https://1899807099-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAsW3Pbi7E5c7rFM4FYSg%2Fuploads%2FTlyEAqD7JUTnGeMh54jQ%2Fmistral-add-connector.jpg?alt=media&#x26;token=ec4a9321-2c68-41e8-89ff-c11a516a49f4" alt=""><figcaption><p>Ajout du connecteur</p></figcaption></figure>

Mistral va alors détecter la méthode d'identification automatiquement :&#x20;

* "Authentification par token API"
* Nom de l'en-tête : Authorization
* Type d'en-tête : Bearer

Vous pouvez maintenant cliquer sur "Créer".

Votre connecteur apparaîtra maintenant dans votre listing. Vous pouvez cliquer dessus pour renseigner votre jeton d'identification :&#x20;

<figure><img src="https://1899807099-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAsW3Pbi7E5c7rFM4FYSg%2Fuploads%2Fnx5NpR0RhvpOSuCREmRW%2Fmistral-connector-config.jpg?alt=media&#x26;token=b12da74e-dcc7-420e-a052-e90d92b480f1" alt=""><figcaption><p>Configuration du token d'identification</p></figcaption></figure>

Une fois la configuration terminée, le MCP est prêt à être utilisé dans Le Chat.

Quand vous démarrez une nouvelle conversation, vous avez la possibilité de choisir Cards comme outil. Cliquez sur le "+" en bas à gauche, vous pourrez sélectionner Cards comme connecteur :&#x20;

<figure><img src="https://1899807099-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAsW3Pbi7E5c7rFM4FYSg%2Fuploads%2FwvzSoyi8TOYYA7BZCMjJ%2Fmistral-use-connector.jpg?alt=media&#x26;token=9b651a38-0d35-4181-85f3-09c8cbf3677d" alt=""><figcaption><p>Sélection du MCP Cards dans Le Chat</p></figcaption></figure>

Le Chat a maintenant accès à votre espace Cards.