# Google Sheets pour l’assistant IA Grâce à une fonctionnalité développée par l’équipe Mavibot, le chatbot IA interprète avec précision les valeurs saisies dans la feuille, puis les enregistre dans une variable système dans les paramètres du projet. Par exemple, vous pouvez en avoir besoin pour un assistant IA qui conseillera vos clients sur la gamme de produits disponible dans votre boutique en ligne, ainsi que pour mettre en avant vos capacités avec un bot intelligent. La manière exacte d’utiliser un bot pour lire une feuille Google dépend de vous, et nous, de notre côté, vous montrerons comment créer une feuille et configurer le bot pour qu’il fonctionne avec elle. ## Préparation de la feuille Google ### Création et remplissage Ouvrez l’éditeur de feuille :

Vous devez remplir les lignes avec les catégories de colonnes :

Comme l’IA peut lire les données, elle utilisera la fonction pour écrire les valeurs de la feuille dans une variable dans les paramètres du projet. Nous recommandons donc d’ajouter des noms de catégories de colonnes concis et compréhensibles, pour votre confort et pour mieux comprendre la logique du bot. Ensuite, spécifiez les noms nécessaires dans les colonnes :

Voyons la catégorie de colonne « Unité de mesure » :

L’unité de mesure peut inclure : 1. Un indicateur quantitatif sous forme de pièces/unités (une unité de marchandise, deux unités de marchandise, une pièce, etc.) :

2. Unités de mesure des grandeurs : litres, kilogrammes, grammes, mètres :

{% hint style="success" %} Le bot comprendra parfaitement ce que vous vouliez dire et utilisera les valeurs intégrées dans les emplacements. {% endhint %} La dernière étape du remplissage de la feuille Google consistera à saisir le prix par unité de mesure.

À ce stade, la feuille Google est complète. ### Paramètres d’accès Pour que le bot IA puisse prendre des valeurs depuis la feuille, vous devez ouvrir les paramètres d’accès :

Cliquez sur les paramètres, et la fenêtre suivante s’ouvrira :

Ici, vous devez modifier le réglage de « L’accès est restreint » à « Toute personne disposant du lien » :

### ID de la feuille Pour utiliser la fonction get\_info\_from\_table(!sheet\_id, number\_sheet, sheet\_json\_keys), nous aurons besoin de l’ID de la feuille, car la fonction prend sheet\_id comme paramètre obligatoire. Pour obtenir l’ID, cliquez simplement sur la barre d’adresse :

Vous verrez une ligne avec l’adresse de la page :

Nous aurons besoin d’une suite de symboles et de lettres, qui n’est autre que l’ID de la feuille :

Cela conclut le travail avec la feuille et sa configuration. ## Travail dans le constructeur d’entonnoir ### Utilisation de la fonction get\_info\_from\_table() Pour utiliser la fonction get\_info\_from\_table(), vous aurez besoin d’un bloc dans le constructeur d’entonnoir. Allez dans l’onglet approprié dans Mavibot et créez un bloc de vérification de condition primaire :

Au lieu de #{none}, nous écrirons dans le message une notification pour le mode test après le lancement de ce bloc ainsi qu’une variable intégrée via la construction #{} :

{% hint style="warning" %} Attention ! La variable intégrée dans le message est nécessaire pour vérifier que le bot lit bien la fonction. Lors de l’exécution du bloc en mode test, le bot affichera les valeurs qui seront imbriquées dans la variable. {% endhint %} {% hint style="success" %} Attention ! Après avoir configuré l’appel du bloc en mode test et enregistré la variable dans les paramètres du projet, ne supprimez pas ce bloc. Cela peut vous être utile : par exemple, si vous avez ajouté d’autres valeurs au tableau, il suffit d’exécuter le bloc en mode test. Ensuite, les données de la variable du projet seront mises à jour. {% endhint %} {% hint style="info" %} Le nom de la variable peut être n’importe lequel qui vous convient. {% endhint %} Ensuite, nous avons besoin de la fonction get\_info\_from\_table(sheet\_id, number\_sheet, sheet\_json\_keys), une fonction conçue pour lire des données à partir d’un tableau.

paramètres	description
! sheet_id	ID de la feuille Google
number_sheet	Numéro de la feuille dans le tableau ; par défaut = 1
sheet_json_keys	Paramètre facultatif, clé d’accès aux données du tableau

Ouvrez la calculatrice et saisissez l’ID du tableau, en l’enveloppant dans une variable (par exemple, sheet) :

Ensuite, attribuez la variable spécifiée dans le message du bloc et donnez-lui une valeur sous la forme de la fonction get\_info\_from\_table() avec le paramètre requis sheet\_id (à la place duquel insérez la variable sheet, où se trouve l’ID du tableau) :

**Attention !** Avant la variable product\_pay\_info dans la calculatrice, écrivez project. Cela est nécessaire afin que la VARIABLE et les VALEURS du tableau soient enregistrées dans les paramètres du projet (mises en cache) :

Maintenant, écrivez n’importe quel mot/nombre dans la condition du bloc :

### Bloc de transmission des données Ensuite, créez un second bloc Status :

Ce bloc Status sera nécessaire pour transférer les variables vers la fiche du client. Vous pouvez également envoyer un message final du bot dans ce bloc, par exemple : « Merci pour votre commande ! J’envoie les données au responsable des communications ! » :

Ensuite, copiez l’ID du bloc - vous en aurez besoin pour configurer l’assistant IA dans la commande "start\_block\_from\_ai 31241050", où, à la place de l’ID de l’exemple, vous devez insérer l’ID de votre bloc. ### Lecture de la feuille Lancez maintenant le bloc dans la version de test afin que le chatbot lise les valeurs de la feuille et les place dans votre variable dans les paramètres du projet :

Ainsi, le bloc a fonctionné correctement : vous voyez les valeurs que vous avez lues et qui se trouvent dans la variable des paramètres du projet. Vous pouvez vérifier cela en allant dans la section appropriée :

Ensuite, vous verrez votre variable avec les valeurs intégrées provenant du tableau :

Ainsi, maintenant, à l’intérieur de votre projet, il existe une variable avec les produits, le coût et tout ce que vous avez indiqué dans la feuille. ## Travail en tant qu’assistant IA Accédez à la section « Assistant IA » et commencez à configurer l’intelligence artificielle. Rôle de l’assistant : vendeur

Nous allons également définir les options « Boutons » et « Saisie de données étape par étape » :

Nous aurons besoin de boutons pour des réponses visuellement élaborées du bot, ainsi que pour le confort du client (ainsi, votre utilisateur n’a pas besoin de saisir manuellement des mots dans le dialogue) ; la saisie de données étape par étape sert à ce que le bot enquête sur la commande en cours de création. ### Paramètres de l’assistant IA Dans les paramètres du bot, nous écrivons les données suivantes : 1. La position et les instructions pour le bot. Exemple : \

2. La commande pour appeler le bloc et transférer les variables au système s’écrit comme suit : \, où, à la place de N, l’ID du bloc est écrit avec le message final : le bloc Status transmet les données à la fiche du client :

Les commandes dans les paramètres de l’assistant IA ressemblent à ceci :

### Connaissances du bot Dans le champ "Bot Knowledge", transmettez la variable qui a été précédemment mise en cache par le bloc de Vérification primaire de la condition :

Connaissances du bot :

Ainsi, le bot prendra les informations d’une variable dans les paramètres du projet et conseillera vos clients sur la gamme de produits disponible. ### Format des données Dans le format des données transmises, vous spécifiez vous-même les données que vous collectez (par exemple, un produit), puis vous saisissez la phrase avec la « clé » et attribuez une valeur à la clé :

#### Explication Ligne 1 : « Le format des données transmises : produit avec la clé product, unité de mesure avec la clé thing, prix avec la clé count, coût total de tous les produits sélectionnés avec la clé result » - indique clairement au bot quelles données et avec quelle valeur doivent être transmises au système. Ces variables seront affichées dans la fiche du client :

2. Si vous avez besoin que chaque produit sélectionné par le client s’affiche séparément, ajoutez une deuxième ligne : « Si le client a sélectionné plusieurs produits, ajoutez alors le premier produit avec la clé product1, le deuxième produit avec la clé product2, le troisième produit avec la clé product3, et ainsi de suite ». Cela conclut la configuration de l’assistant IA. Les paramètres restants peuvent être définis à votre discrétion :

## Test du bot Utilisez le constructeur de condition pour ajouter le fonctionnement du bot dans la fenêtre de test : Étape 1. Cliquez sur le constructeur de condition

Étape 2. Sélectionnez l’onglet avec la zone de texte et cliquez sur « Ajouter » :

Maintenant, dans la condition de démarrage, vous voyez la valeur suivante :

{% hint style="info" %} De cette façon, le bot se lancera uniquement dans la fenêtre de test et nulle part ailleurs. Après le débogage du bot, supprimez cette condition. {% endhint %} Maintenant, testons le bot : 1. Posons au bot une question de sécurité sur la gamme de produits :

Le bot a affiché une variété de produits qui avaient été saisis dans la feuille Google, en capturant les valeurs d’une variable contenue dans les paramètres du projet. 2. Ensuite, nous allons sélectionner le produit et parler au bot intelligent :

3. Choisissons un autre produit :

Le bot s’affiche également correctement, montrant au client les catégories de produits pour une sélection ultérieure. 4. Le client a sélectionné plusieurs produits et a indiqué leur quantité :

Le bot a calculé le coût des articles sélectionnés et a calculé le coût total. 5. Envoi des données au système :

Résultat : après que le bot a dupliqué la commande et que le client a répondu que la commande était correcte, le chatbot, sur la base des paramètres, a appelé le bloc « Statut de la conversation » :

Après cela, les données générées par le bot dans le dialogue avec le client ont été envoyées à la fiche du client :

Le bot a tout traité correctement. {% hint style="success" %} De cette façon, vous pouvez créer une boutique en ligne de n’importe quel type et utiliser toutes les valeurs nécessaires à l’intérieur du tableau. La principale limite, c’est seulement votre imagination ! {% endhint %} ## Guide vidéo {% embed url="" %} --- # 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/google-sheets-pour-lassistant-ia.md?ask= ``` 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.