Cet article ne s'applique qu'aux Agents IA de type Bot utilisant GAIA (et non une IA tierce partie)

Que permet l'IA Agentique ?

Alcmeon AI intègre les dernières technologies disponibles : l'IA agentique est une IA capable de se connecter à d'autres systèmes (API), de choisir celui à utiliser pour répondre au besoin du client, de lui demander les informations manquantes avant de récupérer les données et de générer une réponse personnalisée. 

Un IA agentique est même plus puissante que cela, puisqu'elle permet non seulement de répondre, mais en plus d'agir ! Les cas d'utilisation possibles sont nombreux : où est ma commande, retours de produits, fidélisation, assistant d'achat, réserver un créneau dans un agenda, etc.

Qu'est-ce qu'une Compétence IA ?

Une Compétence IA est la capacité pour une Agent IA d'obtenir des informations depuis votre CRM (ou n'importe quel autre de vos systèmes), ou au contraire d'en “pousser” afin de mettre à jour vos systèmes d'information.

Par exemple, si l'on souhaite que son agent IA ait la capacité de proposer au client des créneaux dans un agenda et une fois un créneau choisi, le réserve et lui envoie une invitation, alors on pourra configurer dans Alcmeon les Compétences IA suivantes :

1. Une première compétence allant récupérer des créneaux dans un agenda
   1. par défaut, cette compétence peut aller chercher les 3 prochains créneaux disponibles
   2. si le client précise un jour en particulier ou des tranches horaires, alors la compétence pourra en tenir compte
2. Une deuxième compétence faisant la réservation du créneau choisi
   1. cette compétence devra se baser sur le choix de créneau avec la compétence précédente
   2. elle devra aussi demander au client son adresse email si elle ne l'a pas déjà

Autres exemples :

Où est ma commande	Expéditions à l'étranger	Retours d'articles	Fidélité

Comment ajouter une Compétence à mon Agent IA ?

Depuis la section “Paramètres / IA Alcmeon”, cliquez sur l'onglet “Skills de l'Agent IA”.

Cette page vous permet de créer de nouvelles Compétences et liste celles déjà créées avec les informations suivantes :

• Nom : le libellé de la compétence
• Type : une compétence peut être un appel d'API ou l'utilisation d'un MCP
• Agent IA l'utilisant : liste les Agents IA à qui on a donné cette compétence
• Mise à jour le : dernière mise à jour de cette compétence
• Icône permettant de supprimer une Compétence

Note : Dans Alcmeon, une même Compétence IA peut être utilisée par un ou plusieurs Agents IA.

Compétences de type “Appel d'API”

Voici les champs disponibles pour créer une compétence IA qui appelle une API.

Description 

C'est ici que vous devez décrire les cas dans lesquels votre agent IA doit utiliser cette API. Soyez concis et clair afin d'éviter tout malentendu.

Exemple pour une compétence allant récupérer des créneaux dans un agenda :

Permet de trouver des créneaux de réunion avec son interlocuteur.
Par défaut, cherche sur les 3 prochains jours à partir de maintenant.

Si tu as déjà donné des créneaux et que le client spécifie de nouveaux critères, alors refais un appel à l'API pour trouver de nouveaux résultats, car les créneaux peuvent changer rapidement.
Présente toujours les options de manière conviviale : 'Mardi 15 à 10h00' au lieu du format technique.

Données client nécessaires

Ajoutez les données utiles pour appeler l'API définie ci-dessus, et que l'agent IA demandera au client si elles sont absentes de sa requête. Pour chaque donnée, vous préciserez :

• Libellé : nom de la donnée, que vous pourrez ensuite utiliser dans tout autre champ de cette Compétence sous la forme {{label}}. Par exemple pour une donnée de libellé “startDateTime”, on pourra l'utiliser dans l'appel d'API sous la forme “{{startDateTime}}”.
• Type : type de la donnée. Il est possible de choisir parmi String (chaîne de caractères), Integer (nombre entier), Boolean (vrai ou faux) ou Float (nombre réel).
• Obligatoire : précise si cette donnée est obligatoirement à récupérer par l'IA, soit auprès du client, soit en utilisant une autre API.
• Défaut : valeur par défaut si l'IA n'a pas récupéré de donnée.
• Description : Vous devez décrire la nature de cette donnée, à quoi elle sert fonctionnellement, et son format par exemple ; il s'agit d'indiquer à l'IA toute information utile pour qu'elle sache demander au client cette information si elle ne l'a pas déjà.

Exemple de description pour notre compétence de recherche de créneaux, pour une donnée “date de début de recherche de créneaux” :

Heure à partir de laquelle les créneaux disponibles doivent être vérifiés.
Doit être exprimée dans le fuseau horaire UTC sous la forme d'une chaîne de date ISO 8601.
Vous pouvez indiquer une date sans heure, auquel cas la valeur par défaut correspond au début de la journée, ou préciser l'heure : 2024-08-13 (correspondant à 00:00:00, c'est-à-dire au tout début de la date) ; vous pouvez également indiquer l'heure manuellement, par exemple 2024-08-13T09:00:00Z.

Vous pouvez ajouter autant de données que nécessaires à votre compétence.

Appel API

Dans cette section, renseignez les paramètres techniques d'appel à votre API.

• URL de l'API : Saisissez l'URL du point de terminaison de l'API à interroger. Vous pouvez utiliser le {{label}} défini dans « Donnée client requise », comme variable dans ce champ. Exemple : https://api.aaa.com/{{userid}}
• Méthode d'API : Supporte toutes les méthodes http usuelles, à savoir GET, POST, PUT, DELETE, PACTH, OPTIONS, HEAD
• En-têtes http : Ajoutez autant de headers http que nécessaire sous la forme d'un couple libellé / valeur. Par exemple pour de l'authentification de type Bearer token: libellé = “Authorization” et valeur = “Bearer mytoken65sdf65sf1sfd165d65sfd6”
• Corps http : Configurez éventuellement le body http de votre requête. Vous pouvez utiliser le {{label}} défini dans « Donnée client requise », comme variable dans ce champ.

Données récupérées de l'API

Les données brutes récupérées via l'API doivent être formatées pour être comprises par l'agent IA. Utilisez {{$.myJsonPath}} dans votre phrase formatée pour insérer les données récupérées. Exemple : « Le colis numéro {{$.parcel.number}} a le statut suivant : {{$.parcel.status}} ».

Exemple pour notre compétence de recherche de créneaux :

{{#$.data}}Voici jusqu'à 3 créneaux disponibles : {{$.data.*[:3].start}}. Attention les dates sont en GMT, il faudra les convertir dans le fuseau horaire de la zone géographique "Belgique" (UTC+1)
{{/$.data}}
{{^$.data}}
Aucune disponibilités. Il faut humblement s'excuser auprès du client et expliquer qu'il n'y a pas de créneau disponible (en précisant les dates auxquelles tu as cherché), et que le client peut préciser d'autres dates pour refaire une recherche de créneaux.
{{/$.data}}

Compétences de type “Utilisation du MCP”

Le Model Context Protocol (MCP) est un protocole standard ouvert conçu pour connecter des modèles d'intelligence artificielle (IA) (notamment des grands modèles de langage, des grands modèles de raisonnement ou agents conversationnels) à des outils, services et sources de données externes[1]. Il a été introduit par la société américaine Anthropic fin 2024, avec l'objectif de fournir une interface universelle – comparée par certains à un « port USB-C » de l'IA – pour intégrer des données contextuelles et des fonctionnalités externes aux modèles, quel que soit le fournisseur.

Dans Alcmeon, vous pouvez définir une Compétence en lui spécifiant simplement un MCP. Ce dernier comporte alors toutes les informations nécessaires pour qu'un Agent IA l'utilise correctement. C'est l'équivalent de plusieurs compétences Appel d'API réunies en un package parfaitement spécifié.

Vous n'autre donc qu'à saisir l'URL du MCP que vous souhaitez utiliser.

Langage de script Mustache

Tous les champs texte acceptent la syntaxe du langage de script “Mustache” : voir les specifications ou utiliser leur playground pour tester.

Mesurer l'utilisation des Compétences IA

Chaque utilisation d'une Compétence IA déclenche dans Alcmeon un “événement de bot” qui comptabilise ensuite sur la période de temps que vous souhaitez 2 métriques : le nombre d'utilisations, et le nombre de clients uniques.

Chaque événement de bot est intitulé de la manière suivante : "AI - Skill used - $skillName". Par exemple pour une compétence s'appelant “CreneauxCalendrier”, l'événement de bot associé sera nommé "AI - Skill used - CreneauxCalendrier".

Rendez-vous dans la section “Analytics / Volumes / Bots” pour y trouver le dashboard “Evénements de bot”. Vous pourrez alors filtrer en haut de page sur le ou les événements que vous souhaitez suivre.