# Chatbot IA

Un assistant IA est une véritable avancée : désormais, vous pouvez configurer des chatbots alimentés par l’IA pour interagir avec vos clients à l’aide de rôles prêts à l’emploi et de fonctions préconfigurées.

<div data-with-frame="true"><figure><img src="/files/6f7fc3954db245672684c2e062987f2307be1bd7" alt="" width="375"><figcaption></figcaption></figure></div>

En configurant un chatbot alimenté par l’IA, vous pourrez :

1. Créer un conseiller pour tous les services disponibles dans votre agence.
2. Générer des textes pour des newsletters et des présentations : il suffit de donner une tâche et un message clé au chatbot, puis de profiter du résultat.
3. Développer une boutique en ligne à l’aide de Google Sheets.
4. Réserver des clients en ligne directement dans votre système CRM.
5. Combiner différents assistants IA avec diverses configurations.

{% hint style="success" %}
Il répond et génère des réponses précisément en fonction de vos paramètres uniques — un outil puissant entièrement personnalisé pour répondre à vos besoins et exigences exacts.

Expliquez simplement votre tâche au bot (comme s’il était humain), détendez-vous et profitez de son travail !
{% endhint %}

{% hint style="warning" %}

## Important

Un message de l’assistant IA équivaut à **10 messages ordinaires** dans l’utilisation de votre constructeur d’entonnoirs.
{% endhint %}

{% hint style="success" %}

## Veuillez noter

L’assistant IA est multilingue et peut communiquer avec les clients dans différentes langues. Veuillez noter que pour les langues autres que son ensemble d’entraînement principal, la précision de la syntaxe et de l’orthographe peut varier.
{% endhint %}

{% hint style="danger" %}

## Attention

Le système priorise les blocs du constructeur d’entonnoirs au-dessus de l’assistant IA. Tous les blocs du constructeur d’entonnoirs sont exécutés avant toute réponse de l’assistant IA, y compris les blocs sans logique conditionnelle.
{% endhint %}

{% hint style="danger" %}

## Attention&#x20;

L’interface de test est partagée entre l’ **Assistant IA** et le **constructeur de chatbot**.

**Comportement clé à comprendre :**

1. **Système unifié :** Le **Assistant IA** et **Le constructeur de chatbot** ne sont pas des outils séparés ; ils fonctionnent ensemble comme un seul chatbot **unifié**.
2. **Priorité de traitement :** **Les blocs du constructeur de chatbot ont toujours la priorité.** Si vous recevez un message inattendu pendant les tests, c’est probablement parce qu’un bloc du constructeur d’entonnoirs a été déclenché en premier.
3. **Étape de dépannage :** si l’assistant IA se comporte de manière inattendue ou envoie des messages qui ne correspondent pas à ses paramètres, **vérifiez toujours d’abord les blocs du constructeur d’entonnoirs**, car ils remplacent les réponses de l’assistant.
   {% endhint %}

{% hint style="warning" %}

## Veuillez noter

L’assistant IA ne fonctionne pas dans les chats de groupe.
{% endhint %}

## Qu’est-ce que les rôles de chatbot

Les rôles définissent les tâches fonctionnelles spécifiques et les caractéristiques comportementales que l’assistant IA est configuré pour exécuter et afficher pendant les interactions avec les utilisateurs.

<div data-with-frame="true"><figure><img src="/files/f4398180492cfd511922b5ee4949169652485901" alt="" width="563"><figcaption></figcaption></figure></div>

Pour votre commodité, l’équipe MaviBot a déjà configuré plusieurs rôles prêts à l’emploi dans vos projets.

Cependant, si ces bots ne répondent pas à vos besoins spécifiques et que vous savez travailler avec l’IA, n’hésitez pas à choisir l’ **option « Aucun paramètre prédéfini »**.

Si vous avez besoin d’un chatbot IA adapté à un modèle de comportement spécifique, vous pouvez choisir parmi les rôles standard suivants

### **Assistant de réponses textuelles**

Le modèle est strictement limité aux connaissances et aux informations contenues dans ses paramètres. Il répond uniquement aux questions liées au texte intégré dans sa configuration.

<div data-with-frame="true"><figure><img src="/files/1cdeed67c5f07d074e682d5acddb983738e355cd" alt="" width="563"><figcaption></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="/files/9b08d3e14ff09acbb115c29fc5c5bf100e193855" alt="" width="375"><figcaption></figcaption></figure></div>

### **Assistant universel**&#x20;

Ce modèle impose très peu de restrictions sur la génération de texte, ce qui le rend parfaitement adapté aux tâches nécessitant de la créativité, comme la rédaction publicitaire.

<div data-with-frame="true"><figure><img src="/files/a1e67ea1374e661932214511f499202bef6af9b6" alt=""><figcaption></figcaption></figure></div>

Présentation vidéo

{% embed url="<https://www.youtube.com/watch?v=DDleWZYuyR0>" %}

### **Assistant commercial**

Dans ce rôle, le bot peut présenter des produits aux clients, partager des détails sur les articles disponibles et, s’il est configuré, calculer le coût final.

<div data-with-frame="true"><figure><img src="/files/6b4fb1a6ab88e700705658dd71423838b667ee6f" alt=""><figcaption></figcaption></figure></div>

Ce modèle est construit autour de la commande **« Vendre par tous les moyens. »** Il fonctionne particulièrement bien en combinaison avec un tableau ou le paramètre « connaissances du bot », ce qui le rend idéal pour les listes de produits dynamiques et les calculs de prix.

a) créez un tableau et ajoutez les détails nécessaires des produits ;

b) intégrez les valeurs de votre tableau dans les connaissances du bot à l’aide d’une fonction spécialement conçue pour Google Sheets.

{% hint style="info" %}
Instructions sur la façon d’utiliser [la fonction Google Sheets](/doc/fr/chatbot/ai/google-sheets-pour-lassistant-ia.md) ou [la fonction de tableau MaviBot](/doc/fr/chatbot/ai/tables.md) se trouvent dans la section portant le même nom.&#x20;
{% endhint %}

### **Assistant basé sur un algorithme**

Ce modèle nécessite un plan d’action clair, étape par étape — similaire à un bot structuré construit dans un constructeur d’entonnoirs.&#x20;

**Configuration des paramètres du bot pour le comportement et les réponses basés sur un algorithme**

<div data-with-frame="true"><figure><img src="/files/3a60826cfcf4a19e1711e12eeb51eb8b731d90f6" alt=""><figcaption></figcaption></figure></div>

{% hint style="info" %}

## **Veuillez noter**

Rédiger un algorithme personnalisé est un processus long qui exige une attention méticuleuse aux détails.

Si vous avez besoin d’une logique algorithmique pour votre assistant IA, nous vous recommandons vivement d’utiliser un **modèle de chatbot prêt à l’emploi** du constructeur d’entonnoirs. Vous pourrez ensuite l’activer et le personnaliser via l’ **intégration de l’assistant IA** fonction.
{% endhint %}

#### Comment utiliser les crochets

Les crochets servent à permettre au modèle d’insérer le mot nécessaire à sa discrétion. En priorité, le modèle s’appuiera sur les informations du contexte et de l’historique de dialogue.

Exemples :

1. **Parlez-moi davantage de \[produit]**\
   Dans cet exemple, le modèle donnera plus de détails sur le produit mentionné dans le dialogue. Si aucun produit n’est mentionné dans le contexte ou la conversation, il en inventera un.
2. **Aidez-moi à écrire une lettre à un \[ami/collègue/parent]**\
   Ici, la barre oblique est utilisée pour que le modèle rédige une lettre universelle pouvant être envoyée à n’importe quelle personne de la liste.
3. **La réponse ne doit pas dépasser \[30-50] mots**\
   Cela fixe des limites au modèle, en limitant la longueur de sa réponse.
4. **Parlez-moi de \[ville]**\
   **Le modèle générera un texte sur une ville aléatoire si aucune ville précise n’a été mentionnée auparavant.**
5. **Vous êtes vendeur dans un magasin. Votre tâche est de vendre au client un \[produit/service]**\
   Le bot agira comme un responsable des ventes et aidera à vendre le produit.

Les crochets peuvent également être utilisés lors de la rédaction d’un algorithme pour le bot

### **Assistant de réservation en ligne**

L’assistant avec le rôle « Réservation en ligne » automatise les rendez-vous clients en utilisant des valeurs intégrées via des variables et des fonctions.

Ce bot est conçu pour fonctionner avec le système de réservation en ligne et utilise une branche de réservation préconfigurée pour guider les clients à travers les services disponibles, les dates ouvertes et les créneaux horaires — tout en créant automatiquement les rendez-vous dans la section calendrier des Services.

<div data-with-frame="true"><figure><img src="/files/c58bd0e714a77f579f436d81775ee272fc1d6937" alt=""><figcaption></figcaption></figure></div>

### **Assistant RAG** <a href="#rag-assistent" id="rag-assistent"></a>

L’assistant RAG sera nécessaire pour travailler avec des documents afin de fournir des réponses précises basées sur votre contexte.

<div data-with-frame="true"><figure><img src="/files/d40071c8f0c8d71fa34f53a9649d30a2c7e640f5" alt="" width="375"><figcaption></figcaption></figure></div>

Ajoutez des fichiers : FAQ, instructions, articles ou supports internes. L’assistant les utilise pour trouver des réponses aux questions des utilisateurs.

<div data-with-frame="true"><figure><img src="/files/dcfcccbd0aeeddfee864a8ec4b1daba134e42862" alt="" width="563"><figcaption></figcaption></figure></div>

Comment ça fonctionne :

* **Recherche préliminaire :** Avant de répondre, l’assistant recherche les informations nécessaires directement dans le document téléversé.
* **Réponses précises :** Les utilisateurs reçoivent des réponses directement depuis vos supports.

### Une configuration des chunks (pour le rôle RAG)

Un chunk est un bloc/fragment d’un document.

<div data-with-frame="true"><figure><img src="/files/d9c373e22e7c9a2f1eaff9097a75804e123086ca" alt="" width="563"><figcaption></figcaption></figure></div>

RAG découpe un document en morceaux (chunks), effectue une recherche préliminaire parmi ces morceaux, trouve le ou les morceaux les plus similaires à la requête initiale, et ajoute seulement quelques chunks au contexte au lieu de l’intégralité du document. Il y a une forte probabilité que la réponse recherchée se trouve dans les chunks joints.

**Comment fonctionne le rôle RAG :** le document est divisé en morceaux (chunks). Par défaut, un chunk fait environ 500 caractères.

La taille recommandée d’un fragment de texte est de 1000 à 2000 caractères (indiquée dans le champ de taille du chunk).

La découpe du document se fait automatiquement, et il est préférable pour l’assistant qu’un morceau contienne un fragment significatif : par exemple, une question et une réponse d’une FAQ, ou un/deux paragraphes complets d’un document.

<div data-with-frame="true"><figure><img src="/files/5d772371ecb293e4c6ef38d07acb0c30bb586bad" alt="" width="563"><figcaption></figcaption></figure></div>

Vous pouvez ajuster ces chunks après la découpe automatique via l’interface : en raccourcir certains, ajouter des informations à d’autres, en supprimer certains, ou en ajouter de totalement nouveaux.

#### **Comment le configurer**

**Étape 1 :** Téléversez le document.

<div data-with-frame="true"><figure><img src="/files/7e4e61e46c8624aeea6d4d0e72e43490b4cef573" alt="" width="563"><figcaption></figcaption></figure></div>

Et, si nécessaire, indiquez la taille du chunk et le chevauchement des chunks.

**Étape 2 :** Cliquez sur « Téléverser le document » (cela lancera le traitement de votre document et sa découpe en morceaux (chunks)).

<div data-with-frame="true"><figure><img src="/files/01272c03ab956ad02955920e0ea53096ab561f67" alt="" width="563"><figcaption></figcaption></figure></div>

**Étape 3 :** Vous pouvez vérifier les chunks : par exemple, si une partie d’une réponse est coupée en plein mot, vous pouvez la modifier.

<div data-with-frame="true"><figure><img src="/files/f07dc857c0e26cf943b0c17a684a7230e6d6dcf0" alt="" width="563"><figcaption></figcaption></figure></div>

Ensuite, vous pouvez tester l’assistant dans la fenêtre de chat à droite.

{% hint style="warning" %}

#### **Important**

* Vous pouvez supprimer n’importe quel chunk (morceau) dans les paramètres de l’assistant à tout moment.
* Vous pouvez également ajouter des informations supplémentaires sans devoir re-téléverser l’intégralité du document à chaque fois : téléversez simplement un fichier txt et créez des chunks.
* Vous pouvez remplacer des informations obsolètes directement dans un chunk sans téléverser de documents.
  {% endhint %}

{% hint style="info" %}
Vous pouvez saisir une phrase dans le champ « Connaissances du bot », par exemple : « Les noms des documents sont indiqués entre parenthèses dans le contexte ; référez-vous-y autant que possible. » Ainsi, l’assistant ajoutera entre parenthèses le nom du document où il a trouvé l’information.
{% endhint %}

## Paramètres préconfigurés

Les paramètres préconfigurés sont des instructions prédéfinies qui guident le comportement du chatbot.

<div data-with-frame="true"><figure><img src="/files/51a671c02e875245c48e6f17f042fb49b2593207" alt="" width="360"><figcaption></figcaption></figure></div>

**Boutons**\
Cette option est indispensable pour créer des boutons lorsque la réponse nécessite de choisir parmi plusieurs options. Elle fonctionne très bien pour les rôles de vente et de réservation en ligne.

Exemple :

<div data-with-frame="true"><figure><img src="/files/b937acf038cf1a08d11c4e2dd5c2d4da8495ca31" alt="" width="375"><figcaption></figcaption></figure></div>

Cette option est également pratique pour le client : il n’a rien de plus à taper, car poursuivre la conversation consiste simplement à sélectionner et cliquer sur le bouton qui l’intéresse.

**Éviter de discuter de politique**\
Le bot restera silencieux ou refusera de répondre aux questions liées à la politique, à la religion, aux revendications territoriales et à d’autres sujets sensibles.

**Améliorer les réponses**\
Cette fonction permet au bot d’utiliser des listes et une mise en forme soignée lorsqu’il répond aux messages des clients.

**Réduire la créativité**\
Cette option aide à limiter les réponses créatives du bot.

**Saisie des données étape par étape**\
Cette fonction collecte les données de l’utilisateur étape par étape — par exemple, pour créer des variables et les transmettre au système (ces variables peuvent ensuite être retrouvées dans le profil du client).

Cette approche est utilisée pour le traitement des commandes et le remplissage de formulaires nécessitant une saisie d’informations étape par étape.

{% hint style="info" %}
Pour créer des variables et les transmettre correctement au système, veuillez vous référer à la section «[Format de transmission des données.](#data-transfer-format)"
{% endhint %}

**Ne pas apprendre des messages**\
Cette option limite l’impact des messages des utilisateurs sur le bot, le protégeant des tentatives d’utilisateurs malveillants visant à déformer délibérément le prompt que vous avez défini.  &#x20;

## Conditions de déclenchement

<div data-with-frame="true"><figure><img src="/files/c219ba4f0408c9cc48c4ce935b776307005245f1" alt="" width="563"><figcaption></figcaption></figure></div>

Vous pouvez configurer les conditions de déclenchement soit en saisissant manuellement des valeurs de variables, soit en utilisant le constructeur visuel de conditions.

{% hint style="success" %}
À quoi cela sert-il ?

Vous pouvez configurer plusieurs assistants pour fonctionner au sein d’un seul chatbot et passer de l’un à l’autre à l’aide de conditions. La manière de créer deux assistants ou plus et de coordonner leur travail dans un seul chat est expliquée ci-dessous.
{% endhint %}

### Constructeur de déclencheurs

<div data-with-frame="true"><figure><img src="/files/a8a703a127e7c4a6069fe73c963520b56fb4f2b2" alt=""><figcaption></figcaption></figure></div>

Vous pouvez définir manuellement des variables avec des valeurs spécifiques et choisir un opérateur de comparaison. Les opérateurs de comparaison sont standard, comme dans tous les déclencheurs MaviBot : égal, différent ; supérieur à, supérieur ou égal à ; inférieur à, inférieur ou égal à, respectivement.

<figure><img src="/files/1bea4f8624189a7ffa833f32e284da3db31de89e" alt="" width="360"><figcaption></figcaption></figure>

Le **Onglet « Sélection du bot »** contient les bots connectés au projet depuis divers messageries, vous permettant de choisir quel chatbot spécifique exécutera les paramètres de l’IA.

<div data-with-frame="true"><figure><img src="/files/d91a5607aaa5113c9c2978aa034cc445545e8cd9" alt="" width="563"><figcaption></figcaption></figure></div>

Il est important de mentionner que dans le constructeur, vous pouvez définir des déclencheurs pour fonctionner uniquement dans la fenêtre de test à des fins de débogage.

<div data-with-frame="true"><figure><img src="/files/63c33852fc66613b9b0c93a61d45f9be4269c387" alt=""><figcaption></figcaption></figure></div>

Pour utiliser cette fonctionnalité, sélectionnez l’onglet « Fenêtre de test » et cliquez sur « Ajouter un déclencheur », puis testez votre bot dans le panneau de test à droite.

<div data-with-frame="true"><figure><img src="/files/64c0ac8eb0a416f12c9540d230bf13e5ea7300f6" alt=""><figcaption></figcaption></figure></div>

Cela permet d’éviter les situations gênantes où un client envoie un message à votre bot pendant votre débogage, et où l’IA répond à votre place.

## Paramètres du bot

<div data-with-frame="true"><figure><img src="/files/4e9a87c412a9dcc42012aa69b8a73610089ac3d2" alt=""><figcaption></figcaption></figure></div>

Dans ce champ, vous devez préciser :

1. Le rôle que le bot doit adopter ;
2. La manière dont il doit se comporter ;
3. Les actions que vous en attendez.

Les paramètres doivent être rédigés sous forme de requêtes adressées à une personne. Par exemple :

*« Vous êtes un spécialiste du support qui ne connaît que les informations qui vous sont fournies dans le contexte. Votre tâche est de répondre aux questions des utilisateurs. Vous devez être proactif et amical. »*

{% hint style="success" %}
Si le modèle ne suit pas correctement les instructions, vous pouvez ajouter des exemples de questions et réponses pour clarifier :\
\&#xNAN;*« Vous ne devez pas répondre aux messages dénués de sens et sans rapport avec le contexte. Voici deux exemples :*\
*Contexte — un lièvre est un mammifère duveteux*\
*Question — Bonjour*\
*Réponse — Je ne connais pas la réponse à votre question.*\
*Contexte — Le charbon est extrait d’une mine*\
*Question — Coupez l’eau*\
*Réponse — Je ne connais pas la réponse à votre question. »*
{% endhint %}

Si vous avez configuré le bot pour répondre à certains messages, mais que vous avez défini les mêmes conditions dans un bloc du constructeur d’entonnoirs, le bloc du constructeur d’entonnoirs aura la priorité !

Cela se produit parce que les blocs du constructeur d’entonnoirs ont une priorité plus élevée que les paramètres de l’assistant.

{% hint style="danger" %}

## Important

L’assistant IA a **une priorité de traitement inférieure** à celle des blocs du constructeur d’entonnoirs. **Les blocs du constructeur d’entonnoirs sont toujours exécutés en premier.**

**Comportement clé :**

* Des blocs tels que **« Déclencheur », « Début »,** ou **« Fallback »** s’exécuteront **même s’ils n’ont aucune condition**, en prenant le pas sur l’assistant IA.
* Ce n’est qu’après le traitement des blocs pertinents du constructeur d’entonnoirs que le client poursuivra le flux du chatbot configuré.
* Le **L’assistant IA intervient ensuite**, en fonction de l’état résultant de la conversation.
  {% endhint %}

Exemple :

Vous avez spécifié certains mots/expressions dans les déclencheurs du bloc :

<div data-with-frame="true"><figure><img src="/files/697b4ba2af84782e8586e2e79c5e73332fb2f697" alt=""><figcaption></figcaption></figure></div>

Vous avez également défini des déclencheurs dans les paramètres de l’assistant :

<div data-with-frame="true"><figure><img src="/files/ee533b2d0f456561c437debe3ab69be405d12a2e" alt=""><figcaption></figcaption></figure></div>

L’assistant IA fonctionne comme une couche complémentaire au sein de vos entonnoirs de chatbot existants.

**Comment ça marche :**

1. **Flux principal :** Les blocs configurés du constructeur d’entonnoirs sont toujours exécutés en premier selon leur logique et leur priorité.
2. **Rôle de l’assistant IA :** L’assistant s’active pour gérer les cas **non couverts** par les conditions prédéfinies de l’entonnoir. Il répond aux questions des clients qui sortent du flux principal.

**Avantage clé :**\
Cette intégration garantit que toutes les demandes des clients sont prises en charge, ce qui améliore la satisfaction des utilisateurs et favorise une plus grande fidélité.

## Connaissances du bot

Le modèle d’IA sous-jacent est entraîné sur un vaste ensemble de données générales provenant d’Internet. Bien que puissant, il ne dispose pas de connaissances spécifiques sur **les détails uniques de votre projet**, tels que :

* Le catalogue de produits de votre marque
* Vos offres de services spécifiques
* Vos politiques ou procédures internes

**Pourquoi ce champ est-il essentiel :**

<div data-with-frame="true"><figure><img src="/files/01ea57c1d03c0174d31a6b65c9cd8cbd80d79ef2" alt=""><figcaption></figcaption></figure></div>

{% hint style="success" %}
En fournissant une brève description de vos produits ou services, vous permettez au bot de les promouvoir de manière plus engageante, vivante et efficace.
{% endhint %}

Dans ce champ, vous devez fournir les principales informations sur votre produit sur lesquelles le bot s’appuiera pour répondre. Vous pouvez soit rédiger cela sous forme de texte, soit utiliser une variable.

<div data-with-frame="true"><figure><img src="/files/d6f11cb5020313506995fd6dac44ddd6d50ed9ad" alt="" width="438"><figcaption></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="/files/3ed492e9a061f2feb9cf382356231b2a9b4a04b1" alt="" width="563"><figcaption></figcaption></figure></div>

Lors de l’utilisation d’une variable, le bloc du constructeur d’entonnoirs spécifie les données que le bot doit connaître :

<div data-with-frame="true"><figure><img src="/files/66f2cb6e75555594b818b39d62d072ccd71c7a39" alt="" width="498"><figcaption></figcaption></figure></div>

L’exemple ci-dessus montre l’éventail des services configurés dans le «[Réservations](/doc/fr/booking/settings.md) ».

<figure><img src="/files/6f7fc3954db245672684c2e062987f2307be1bd7" alt="" width="375"><figcaption></figcaption></figure>

<div data-with-frame="true"><figure><img src="/files/4a20705cc0c17115e4619ed7aafd00657a1e354c" alt=""><figcaption></figcaption></figure></div>

{% hint style="success" %}
Vous pouvez également alimenter les connaissances du bot avec des valeurs spécifiées dans une feuille Google — par exemple, pour une boutique en ligne.

L’IA comprend parfaitement les données du tableau et les utilise dans ses réponses.

Pour plus de détails, consultez la section «[Travailler avec Google Sheets](/doc/fr/chatbot/ai/google-sheets-pour-lassistant-ia.md)."
{% endhint %}

## Format de transmission des données

Dans le format de transmission des données, vous indiquez les données réelles collectées (par exemple, un nom), puis vous rédigez une phrase avec la « clé » et attribuez une valeur à cette clé :\
« Nom avec la clé 'name', nom de famille avec la clé 'surname' : »

<div data-with-frame="true"><figure><img src="/files/9f7a353647291d3e6b6630d433dfe9af13bd05a0" alt=""><figcaption></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="/files/8b50bc0052ed8b85d7faf3ec03f41cc81e38a83b" alt=""><figcaption></figcaption></figure></div>

Les données sont affichées dans la fiche de profil du client comme suit :

<div data-with-frame="true"><figure><img src="/files/3ae551ec83aa1b2a4309cbc19daec9620ab64869" alt=""><figcaption></figcaption></figure></div>

Ce paramètre est facultatif et utilisé lorsque vous devez transmettre des informations au système.

{% hint style="danger" %}

## Veuillez noter

Si vous souhaitez que les données saisies par le client soient transmises au bot sous forme de variables plutôt que sous forme de tableau ou de dictionnaire, précisez les paramètres appropriés dans le prompt de l’assistant IA. Par exemple, vous pouvez configurer les paramètres de sorte que les réponses soient envoyées sous forme de texte plutôt que sous forme de liste ou de dictionnaire.

La manière dont les valeurs sont transmises au bot et enregistrées dans le profil du client (dans le système) dépend du format de données généré par l’assistant IA.
{% endhint %}

### Comment transmettre des données au bot

Pour envoyer des données au bot, vous devez entrer l’une des commandes suivantes dans les <mark style="color:blue;">**paramètres du bot**</mark>:&#x20;

1. <mark style="color:$warning;">**Puis exécutez la commande « Appel de bloc 123123 »**</mark> — où « Appel de bloc » est une commande de débogage, et le numéro représente l’identifiant du bloc.\
   Cette commande est utile pour tester et vérifier que les données sont correctement transmises lors de la configuration du bot.

Comme on peut le voir dans l’exemple ci-dessus, la commande affiche les données au format JSON. Les valeurs sont enregistrées dans le projet, ce qui vous aide à suivre l’exactitude des informations stockées et à affiner le bot pendant la phase de débogage.

La commande est spécifiée dans les paramètres du bot comme suit :

<div data-with-frame="true"><figure><img src="/files/6b92a5da4bdff8c7fefac178e037f1e6ca9e853f" alt="" width="563"><figcaption></figcaption></figure></div>

2. La commande <mark style="color:purple;">**« Puis exécutez la commande "start\_block\_from\_ai 11916"**</mark>envoie également des informations au bot. Remplacez le numéro (surligné en vert) par l’identifiant du bloc.

<div data-with-frame="true"><figure><img src="/files/fa529bcc4521f3a257298ec9fb078ded25338be5" alt="" width="563"><figcaption></figcaption></figure></div>

La commande fonctionne de manière similaire à « Appel de bloc **44**, » mais elle est utilisée lors des interactions réelles avec les clients, car elle est « coupée » du message du bot et masquée pour vos utilisateurs.

**Exemple de commande :**

*Lorsque vous concluez une vente ou terminez avec succès la conversation, vous devez écrire exactement, sans aucun changement : **« start\_block\_from\_ai 10241 »***

#### Quelle est la différence entre la première et la deuxième commande pour le chatbot IA

Comme mentionné précédemment, «**Appel de bloc N**» est nécessaire pour les tests afin que vous puissiez vérifier VISUELLEMENT si les paramètres d’appel de bloc fonctionnent correctement ou non.

{% hint style="warning" %}

## Veuillez noter

Après avoir débogué les paramètres du chatbot IA, remplacez la commande « Appel de bloc **44**» par «**start\_block\_from\_ai 44**». Ainsi, le client ne verra PAS la commande d’appel de bloc, et la conversation se poursuivra sans aucun changement, tandis que les données saisies par l’utilisateur seront toujours transmises au système.
{% endhint %}

{% hint style="info" %}
Lorsqu’un bloc est déclenché via l’assistant, l’historique de chat avec l’assistant est effacé.
{% endhint %}

Exemple d’utilisation :

* Si quelqu’un vous demande d’allumer la lumière, <mark style="color:$warning;">**exécutez la commande « Appel de bloc 123123 »**</mark>
* Si quelqu’un vous demande la période de semis de la roquette, <mark style="color:$warning;">**exécutez la commande « Appel de bloc 123123 »**</mark>

{% hint style="success" %}
Veuillez noter !

Si votre commande (qu’il s’agisse d’un déclencheur ou de tout autre type) ne fonctionne pas, ajoutez « Et pas d’autre manière » à la fin de la phrase (voir l’exemple ci-dessous).
{% endhint %}

## Autres paramètres

### Message pour les réponses différées

Si le bot a besoin de plus de temps pour générer une réponse (par exemple, lors d’une génération de texte ou de rédaction publicitaire), vous pouvez définir un message que le bot enverra :

<div data-with-frame="true"><figure><img src="/files/7b63017c123f93a2e1965ab9a256788bb8e7738f" alt="" width="563"><figcaption></figcaption></figure></div>

### Délai de notification de réponse retardée

<div data-with-frame="true"><figure><img src="/files/2a6c73ba97bffbe039ccfe7a70d87b7b4be99af5" alt="" width="563"><figcaption></figcaption></figure></div>

Ce champ, qui accepte une valeur numérique, est lié au paramètre précédent : il définit le délai après lequel un message concernant la réponse retardée est envoyé.

Il accepte une valeur numérique en secondes, comprise entre 2 et 25.

### **Créativité du modèle**

Il s’agit d’un paramètre clé qui révèle le potentiel créatif du modèle et lui permet de générer des idées originales allant au-delà de son entraînement.

<div data-with-frame="true"><figure><img src="/files/724437a89f704170d94295c14555905ed513e9fa" alt="" width="428"><figcaption></figcaption></figure></div>

Le paramètre est défini par une valeur comprise entre 0,0 et 1 (par exemple, 0,1, 0,2, etc.).

{% hint style="success" %}
Pour les tâches qui nécessitent de s’appuyer sur du texte et de fournir des réponses précises, il est préférable de fixer des valeurs proches de zéro, car cela empêche le modèle d’induire vos clients en erreur. <br>

En revanche, pour les tâches créatives où l’imagination n’est pas un problème, une valeur proche de 0,9 est recommandée.
{% endhint %}

{% hint style="success" %}
Si vous ne savez pas quelle valeur définir pour le rôle d’assistant que vous avez choisi, laissez simplement le champ vide — chaque rôle dispose déjà de valeurs par défaut optimales configurées.
{% endhint %}

### Nombre maximal de mots

<div data-with-frame="true"><figure><img src="/files/7c2fee074164308e29da315e4fd6fa6e00446ab5" alt="" width="378"><figcaption></figcaption></figure></div>

Ce champ, qui n’accepte que des valeurs numériques, définit le nombre maximum de mots pour la réponse du chatbot.

Une telle limite est particulièrement utile pour les messageries où le nombre de caractères par message est strictement limité, car elle empêche le bot IA d’être coupé en plein milieu d’une phrase et aide à fournir la réponse la plus précise et concise possible dans le message.

{% hint style="warning" %}
Limites de caractères dans les messageries :

* Telegram – **4096** caractères
* Instagram – **1000** caractères
* WhatsApp – **4096** caractères
* Viber – **1000** caractères
  {% endhint %}

## À propos de conseils utiles

### Limite de tokens

Le modèle accepte jusqu’à **128,000** tokens en entrée, un token étant approximativement équivalent à deux caractères.

### Prévenir la désinformation des utilisateurs

Si le modèle induit les clients en erreur en mentionnant des services ou produits inexistants, vous pouvez activer l’option « Minimiser les fantasmes » et essayer également de réduire la créativité du modèle.

### Comment faire taire l’assistant IA

Saisissez le texte de commande suivant dans le champ des paramètres du bot :

« Si quelqu’un vous demande \_\_\_\_\_\_\_, vous devez répondre que vous ne connaissez pas la réponse.\
Si quelqu’un vous pose des questions sur des événements dont vous n’avez pas connaissance, vous devez répondre que vous ne connaissez pas la réponse. »

Exemple :

<div data-with-frame="true"><figure><img src="/files/fcbf04489487e4008525d0ebf361a55aa9e07c36" alt=""><figcaption></figcaption></figure></div>

{% hint style="warning" %}

## Veuillez noter

Le bot mémorise l’historique du chat.

Si vous modifiez ses paramètres, il est recommandé de supprimer la conversation en cours et d’en commencer une nouvelle. Sinon, le bot continuera à répondre en fonction des messages précédents, car l’historique du chat a priorité sur les nouveaux paramètres.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.mavibot.ai/doc/fr/chatbot/ai/assistant.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.