# Comment travailler avec les feuilles Mavibot

Le **« Sheets »** La section de MaviBot est un outil de stockage et de gestion pratiques des données au sein de la plateforme. Vous n’avez plus besoin de passer d’un service à l’autre : toutes vos feuilles sont désormais disponibles dans un seul projet.

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

**Fonctionnalités :**

* Créez des feuilles avec autant de lignes et de colonnes que vous le souhaitez.
* Stockez et modifiez les données sans outils ni services tiers.
* Saisissez des valeurs, modifiez des lignes et des colonnes, ou supprimez-les directement via le chatbot à l’aide de fonctions.

**Avantages :**

* **Simplifie la gestion des données :** vous pouvez saisir des informations dans un tableau directement depuis le bot.&#x20;
* **Flexible et facile à utiliser :** créez autant de tableaux que nécessaire et adaptez-les à vos tâches professionnelles.

{% hint style="success" %}

#### **Gérez vos tableaux sans quitter Mavibot**

Les tableaux aident les entreprises à structurer leurs données et à accélérer les processus.
{% endhint %}

## Comment créer des feuilles

Pour commencer, allez à la **« Sheets »** section dans le projet requis :

<div data-with-frame="true"><figure><img src="/files/155e67db293a53e5ed941569876f494f36bd5b2f" alt="" width="222"><figcaption></figcaption></figure></div>

Ensuite, vous verrez le **« Créer une feuille »** bouton. Cliquez dessus pour ouvrir une fenêtre modale où vous devez saisir le nom du tableau :

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

Entrez un nom pour le tableau et cliquez sur **« Terminé »**. Le nouveau tableau sera alors créé dans le projet et apparaîtra dans les **« Sheets »** section.

### Paramètres des feuilles

Après avoir créé la feuille, vous devez ajouter des lignes et des colonnes. Pour ce faire, trouvez le bouton « Aller à » sur le tableau souhaité et cliquez dessus :

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

Vous verrez les paramètres suivants :

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

1. Fonction d’ajout de colonnes :

a) pour ajouter des colonnes lettrées

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

Le bouton ajoute au tableau des colonnes libellées de A à Z.

b) pour ajouter des colonnes avec des noms personnalisés

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

Un clic sur le bouton ouvre une fenêtre modale où vous pouvez nommer la nouvelle colonne.

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

Entrez un nom et cliquez sur **« Terminé »** pour ajouter la colonne au tableau.

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

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

2. Bouton pour ajouter des traits :

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

3. Export de la feuille

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

Vous permet d’exporter la feuille au format CSV avec toutes les données et valeurs, par exemple pour déplacer la feuille vers un autre projet Mavibot ou vers un autre service de tableur.

4. Le **Import CSV** la fonctionnalité vous permet de charger des données depuis un service externe.

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

### Autres fonctionnalités

Il existe un menu déroulant qui vous permet de parcourir rapidement les feuilles sans quitter la section principale.

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

Vous pouvez également créer de nouveaux tableaux directement depuis le menu latéral.

Pour supprimer une feuille, rendez-vous dans la section principale :

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

Ensuite, trouvez le **Supprimer** bouton sur la carte du tableau que vous souhaitez retirer.

{% hint style="danger" %}
Attention !

Les tableaux supprimés ne peuvent pas être restaurés.
{% endhint %}

### Comment saisir des valeurs dans la feuille

Vous pouvez saisir des valeurs dans la feuille manuellement :

<div data-with-frame="true"><figure><img src="/files/96af1b44c6c8f6ff0ac6fa0440a8db0209ee5904" alt="" width="513"><figcaption></figcaption></figure></div>

Ou en utilisant des fonctions dans le chatbot.

### **Comment trouver l’ID d’une feuille**

Vous aurez besoin d’un ID de feuille pour utiliser les fonctions du chatbot liées à ce tableau.

1. **Accédez à votre tableau.** Trouvez le tableau souhaité dans la liste et cliquez sur son nom pour l’ouvrir.
2. **Localisez l’ID du tableau dans la barre d’adresse.** Cliquez sur la barre d’adresse de votre navigateur — l’ID du tableau est la chaîne unique de caractères à la fin de l’URL.

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

3. **Exemple :**\
   Dans une URL comme `https://mavibot.ai/projects/11111/table/2`\
   l’ID du tableau est **`2`**.
4. **Copier l’ID**\
   Sélectionnez et copiez ce numéro depuis la barre d’adresse pour l’utiliser dans la configuration de votre chatbot.

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

### Comment créer un nouvel enregistrement dans la feuille

new\_record(table\_id, data) – crée une nouvelle entrée dans le tableau avec les valeurs spécifiées.

table\_id – l’ID du tableau

data – un dictionnaire contenant les données à saisir. Exemple : {"column\_name1": "value1", "column\_name2": "value2"}. Si une colonne n’existe pas, elle sera créée. Réponse : l’ID de la nouvelle entrée

### Exemple

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

### Comment modifier un enregistrement existant dans la feuille

edit\_record(table\_id, record\_id, data)

table\_id – l’ID du tableau

record\_id – l’ID de l’entrée à modifier

data – un dictionnaire contenant les données à mettre à jour. Exemple : {"column\_name1": "value3", "column\_name2": "value4"}. Si une colonne n’existe pas, elle ne sera PAS créée.

Réponse : renvoie les données complètes de l’entrée modifiée au format {"column\_name1": "value3", "column\_name2": "value4"}

### Exemple

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

### Comment supprimer un enregistrement de feuille par son ID

delete\_record(table\_id, record\_id)

table\_id – l’ID du tableau

record\_id – l’ID de l’entrée à supprimer

Réponse :

{'message': 'Entrées supprimées : 1'}

### Comment trouver le premier enregistrement avec la valeur spécifiée dans une feuille

find\_record(table\_id, value, find\_in, return\_from)

table\_id – l’ID du tableau

value – la valeur à rechercher

find\_in – facultatif. Le nom de la colonne dans laquelle effectuer la recherche. Si non spécifié, la recherche sera effectuée dans toutes les colonnes

return\_from – facultatif. Le nom de la colonne à partir de laquelle renvoyer la valeur

Réponse : si return\_from est spécifié, la valeur de la colonne indiquée sera renvoyée (si elle existe dans le tableau). Si return\_from n’est pas spécifié ou si la colonne n’existe pas, les données complètes de l’entrée trouvée seront renvoyées : {"column\_name1": "value3", "column\_name2": "value4"}

### Exemple

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

### Comment obtenir les valeurs de l’enregistrement spécifié

get\_record\_data(table\_id, record\_id, return\_column )&#x20;

table\_id – l’ID du tableau

record\_id – l’ID de l’entrée à partir de laquelle récupérer les valeurs

return\_column – facultatif. Le nom de la colonne à partir de laquelle renvoyer la valeur

Réponse : si l’entrée est trouvée, renvoie un dictionnaire du type {"column\_name1": "value1", "column\_name2": "value2"}. Si return\_column est fourni et que la colonne existe, seule la valeur de cette colonne sera renvoyée.

### Comment récupérer toutes les valeurs lors d’une recherche sur plusieurs colonnes&#x20;

find\_records\_multiple\_cols\_list(table\_id, column\_data, return\_col, with\_index, delimiter, algorithm) – utilisez cette fonction lorsque vous devez rechercher simultanément dans plusieurs colonnes et récupérer une liste de valeurs d’une colonne dans les lignes où toutes les valeurs sont trouvées. (C’est similaire à la fonction sheet\_search\_in\_multiple\_cols\_return\_list pour Google Sheets.)

**table\_id** — l’ID du tableau

**column\_data** — la requête de recherche, c’est-à-dire ce que vous voulez trouver

**return\_col** — le numéro de la colonne à partir de laquelle renvoyer les valeurs

**with\_index** — index ou numérotation dans la liste des valeurs trouvées (0 – numérotation (1, 2, 3,…) ; 1 – index de ligne ; "" – liste de valeurs sur de nouvelles lignes sans index ni numérotation)

**delimiter** — séparateur entre l’index et la valeur

**algorithm** — algorithme de recherche (F – correspondance exacte, K – correspondance par mot-clé, R – expression régulière, 1–100 – pourcentage de similitude (voir détails ci-dessus))

Exemple :

table\_id = 7

data = {"age": "26", "city": "New York"}

return\_col = "name"

with\_index = 1

delimiter = " - "

algorithm = "F"

res = find\_records\_multiple\_cols\_list(table\_id, data, return\_col, with\_index, delimiter, algorithm)

res\_list = res\["list"]

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

Si la requête s’exécute avec succès, la réponse est un dictionnaire contenant le statut et toutes les cellules avec des valeurs :&#x20;

{"status":true,"rows\_index":\[2,3],"quantity":2,"list":"2 - John\n3 - Anna"}

**status** — le résultat de la recherche

**rows\_index** — un tableau contenant les numéros des lignes trouvées

**quantity** — le nombre de lignes trouvées

**list** — une chaîne contenant toutes les valeurs de la colonne sélectionnée

Si une erreur se produit, la réponse sera status: false accompagné d’une description de l’erreur : {"status": false, "error": "Erreur ou description"}

### Comment récupérer la première valeur lors d’une recherche sur plusieurs colonnes

find\_first\_record\_multiple\_cols\_row(table\_id, column\_data, algorithm) – utilisez cette fonction lorsque vous devez rechercher simultanément dans plusieurs colonnes et récupérer la première ligne correspondante. (C’est similaire à la fonction sheet\_search\_in\_multiple\_cols\_return\_row pour Google Sheets.)

**table\_id** — l’ID du tableau

**columns** — la requête de recherche, c’est-à-dire ce que vous voulez trouver

**algorithm** — l’algorithme de recherche (F – correspondance exacte, K – correspondance par mot-clé, R – expression régulière, 1–100 – pourcentage de similitude (voir détails ci-dessus))

Exemple :

table\_id = 7

data = {"age": "26", "city": "New York"}

algorithm = "F"

res = find\_first\_record\_multiple\_cols\_row(table\_id, data, algorithm)

row\_data = res\["row\_data"]

row\_id = row\_data\["ID"]

row\_name = row\_data\["name"]

row\_age = row\_data\["age"]

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

Si la requête s’exécute avec succès, la réponse est un dictionnaire contenant le statut et toutes les cellules avec des valeurs.

{"status":true,"rows\_index":\[2,3],"quantity":2,"row\_data":{"ID":2,"name":"John","age":"26","city":"New York"},"row":2}

**status** — le résultat de la recherche

**rows\_index** — un tableau contenant les numéros des lignes trouvées

**row\_data** — données de la ligne trouvée

**row** — le numéro de la ligne trouvée

Si une erreur se produit, la réponse sera status: false accompagné d’une description de l’erreur : {"status": false, "error": "Erreur ou description"}


---

# 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/sheets/settings.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.