# Assistant IA avec les tableaux MaviBot

En utilisant une fonction dédiée développée par l’équipe MaviBot, votre chatbot IA peut lire intelligemment les valeurs d’une feuille Google et les stocker dans une **variable système dans les paramètres de votre projet**. Cela crée une source de données synchronisée et dynamique pour votre assistant.

#### **Applications pratiques**

Cette fonctionnalité est essentielle pour des scénarios tels que :

* **Assistant de catalogue de produits :** une IA qui conseille les clients sur votre **gamme actuelle de produits, les prix et la disponibilité** en temps réel.
* **Bot de promotion intelligent :** un bot qui **met en avant vos offres** en soulignant dynamiquement des fonctionnalités, des spécifications ou des offres extraites directement de votre feuille.

### **Comment préparer votre tableau pour l’intégration**

Pour commencer, allez dans la section des feuilles :

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

Ensuite, vous verrez le bouton « Ajouter une feuille », qui ouvre une fenêtre modale dans laquelle vous devez saisir le nom de la feuille :

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

Saisissez le nom de la feuille et cliquez sur le bouton « Terminé ». Une nouvelle feuille sera alors créée dans le projet et apparaîtra dans la section « Feuilles » :

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

### Paramètres de la feuille

Après avoir créé la feuille, vous devez ajouter des lignes et des colonnes. Pour cela, trouvez le bouton « Aller à » sur la carte de la feuille souhaitée et cliquez dessus.

Vous voyez ensuite les paramètres suivants :

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

Pour ajouter une colonne avec un nom, cliquez sur le bouton « + » :

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

Lorsque vous cliquez sur le bouton, une fenêtre modale s’ouvrira où vous pourrez saisir un nom pour la nouvelle colonne.

Après avoir saisi le nom de la colonne, cliquez sur le bouton « Terminé » ; la nouvelle colonne sera alors ajoutée à la feuille. Ajoutez le nombre requis de colonnes, puis de lignes.

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

&#x20;Maintenant, votre feuille ressemble à ceci.

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

Copiez (retenez) l’ID de la feuille : pour cela, cliquez sur la barre d’adresse :

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

Ensuite, passons à la configuration des blocs dans le builder.

## Travail dans le builder du chatbot

### Fonction get\_records\_from\_table()

Pour utiliser la fonction get\_info\_from\_table(), vous avez besoin d’un bloc dans le builder du chatbot.&#x20;

Allez dans l’onglet approprié dans Mavibot et créez un bloc avec un déclencheur (bloc de démarrage ou bloc déclencheur) :

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

Définissez une variable (elle sera utilisée pour la connaissance de l’assistant IA) : dans cet exemple, la variable est « record ».

Exemple de code du Calculateur

<mark style="color:green;">`project.`</mark><mark style="color:red;">`record`</mark>` ``=`` `<mark style="color:orange;">`get_records_from_table`</mark>`(1)`

1. <mark style="color:green;">`project. - est un constructeur pour définir une variable dans la configuration du projet ;`</mark>
2. <mark style="color:red;">`record - nom de la variable ;`</mark>
3. <mark style="color:orange;">`get_records_from_table`</mark>`(1) - fonction, où le paramètre est passé comme ID du tableau.`&#x20;

<details>

<summary>En savoir plus sur la fonction get_record_from_table()</summary>

`get_records_from_table(table_id, start_row, count, start_col, end_col)` – pour obtenir des enregistrements depuis un tableau

| Paramètre       | Description                                                             | Remarque                                                                                                                              |
| --------------- | ----------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| **!** table\_id | ID du tableau (paramètre obligatoire)                                   |                                                                                                                                       |
| start\_row      | paramètre facultatif, entier. Spécifie la ligne de départ de la plage   | accepte le numéro de ligne à partir duquel commencer à lire les valeurs du tableau, inclus. Doit être indiqué sans guillemets         |
| count           | paramètre facultatif, entier. Spécifie le nombre de lignes à récupérer  | valeur par défaut : 1000. Maximum : 5000. Doit être indiqué sans guillemets                                                           |
| start\_col      | paramètre facultatif, chaîne. Spécifie la colonne de départ de la plage | accepte le nom de la colonne à partir de laquelle commencer à lire les valeurs du tableau, inclus. Doit être indiqué entre guillemets |
| end\_col        | paramètre facultatif, chaîne. Spécifie la colonne de fin de la plage    | accepte le nom de la colonne jusqu’à laquelle lire les valeurs du tableau, inclus. Doit être indiqué entre guillemets                 |

**Pour lire toutes les données à partir d’un certain point :** Indiquez uniquement le **début** de la plage. **Pour lire toutes les données jusqu’à un certain point :** Indiquez uniquement le **fin** de la plage.

</details>

Au lieu de #{none}, nous écrirons notre variable dans le message à l’aide de la construction #{} afin de voir visuellement quelles données ont été écrites dans la variable du projet.

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

{% hint style="warning" %}

## Attention

La variable intégrée dans le message est nécessaire pour vérifier si le bot lit correctement la fonction. Lorsque vous lancez le bloc en mode test, le bot affichera les valeurs qui seront attribuées à la variable.
{% endhint %}

{% hint style="success" %}

## Veuillez noter

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.&#x20;

Vous pourriez en avoir besoin : par exemple, si vous avez ajouté d’autres valeurs au tableau, lancez simplement le bloc en mode test. Les données de la variable du projet seront alors mises à jour.
{% endhint %}

{% hint style="info" %}
Le nom de la variable peut être celui que vous souhaitez.
{% endhint %}

### Bloc de transfert de données&#x20;

Ensuite, nous créerons un bloc « Chat » pour transférer les données vers la fiche du client.

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

« Ce bloc peut également transmettre un message de clôture du bot, tel que : « Je transmets les informations au responsable ! Le responsable vous contactera dans les 10 minutes. » »

Ensuite, copiez l’ID du bloc. Vous en aurez besoin pour configurer l’assistant IA dans la commande « start\_block\_from\_ai 11956 » et dans la commande de test « Block call 11956 », où, à la place du <mark style="color:red;">ID du bloc</mark> de l’exemple, vous devez insérer l’ID de votre bloc.

{% hint style="success" %}

## Veuillez noter

Après les tests, remplacez « Block call <mark style="color:red;">31241050</mark>par la commande « start\_block\_from\_ai <mark style="color:red;">31241050"</mark>.

La commande « Block call <mark style="color:red;">31241050</mark>est utilisée pour le débogage et aide à comprendre quelles données le bot enregistre (voir la section « Test »).

Pour lancer le bot pour les clients, spécifiez la commande « start\_block\_from\_ai <mark style="color:red;">31241050</mark>".
{% endhint %}

### Lecture d’un tableau

1. Accédez au **mode de test du bot** .
2. Lancez le bloc qui contient le déclencheur de lecture des données du tableau.

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

Le bloc a fonctionné correctement. Vous pouvez le constater grâce aux valeurs désormais stockées dans la variable correspondante dans les paramètres de votre projet.

**Pour vérifier manuellement :**

1. Allez dans l’onglet **Paramètres du projet** section.
2. Repérez la variable pour voir ses données actuelles.

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

Dans l’onglet « Variables » des paramètres du projet, vous verrez votre variable avec les valeurs ajoutées depuis le tableau. Ainsi, maintenant, dans votre projet, il y a une variable avec les articles, les coûts et tout ce que vous avez spécifié dans le tableau.

## Travail dans l’assistant IA

Allez dans la section « Assistant IA » et lancez le chatbot avec les paramètres IA.

Vous devez choisir le rôle « Assistant commercial » :

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

Nous allons également définir des paramètres supplémentaires :

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

### &#x20;Paramètres de l’assistant IA

Dans les paramètres du bot, écrivez les données suivantes :

1. La position et les instructions pour le bot.

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

2. La commande pour appeler le bloc et transférer les variables au système s’écrit comme suit :

`« Si tout est correct, exécutez la commande « start_block_from_ai 11956 »`, où, à la place de N, l’ID du bloc est écrit avec le message final : le bloc Chat transmet les données à la fiche du client :

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

### Connaissances du bot

Dans le champ « Connaissances du bot », transmettez la variable qui a été précédemment mise en cache comme bloc avec le déclencheur.

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

Connaissances du bot.

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

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 indiquez 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é.

`le nom du client avec la clé client_name, le numéro de téléphone du client avec la clé phone_number, la ville et l’adresse avec la clé city_address, le produit choisi avec la clé product, la quantité du produit avec la clé quantity, le montant total de la commande avec la clé total_amount.`

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

Ainsi, lors de l’appel du bloc, les variables seront transmises à la fiche du client : vous pourrez ensuite travailler avec les variables, par exemple, dans le builder du chatbot :

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

À ce stade, la configuration de l’assistant IA est terminée.&#x20;

Les paramètres restants peuvent être définis à votre discrétion :

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

## Tester un bot

« Si vous avez déjà des bots en cours d’exécution, indiquez dans la condition de lancement de l’assistant IA qu’il doit démarrer uniquement dans la fenêtre de test. »

Étape 1. Cliquez sur le builder de déclencheur

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

Étape 2. Sélectionnez l’onglet avec la fenêtre de test et cliquez sur « Ajouter un déclencheur » :

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

Maintenant, dans la condition de déclenchement, vous verrez la valeur suivante :

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

{% hint style="info" %}
Ainsi, le bot s’exécutera uniquement dans la fenêtre de test et nulle part ailleurs.

Après le débogage du bot, supprimez cette condition.
{% endhint %}

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

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

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

Ce message est envoyé en m[ode test en raison de la commande « Block call <mark style="color:red;">**3124105**</mark>](/doc/fr/chatbot/ai/assistant.md#data-transfer-format)

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

Après avoir testé et débogué le bot, écrivez la commande dans les paramètres du bot « start\_block\_from\_ai <mark style="color:red;">**31241050**</mark>".

{% hint style="success" %}
Cette approche vous permet de créer **tout type de boutique en ligne** et d’exploiter **toutes les valeurs de données** stockées dans votre tableau.

La seule véritable limite est votre imagination.
{% 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/tables.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.