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 capacité est essentielle pour des scénarios tels que :

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

Comment préparer votre tableau pour l'intégration

Pour commencer, allez dans la section des feuilles :

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

Entrez le nom de la feuille et cliquez sur le bouton "Terminé". Ensuite, une nouvelle feuille sera créée dans le projet et apparaîtra dans la section "Feuilles" :

Paramètres de la feuille

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

Vous voyez les paramètres suivants :

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

Lorsque vous cliquez sur le bouton, une fenêtre modale s'ouvre où vous pouvez entrer un nom pour la nouvelle colonne.

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

Maintenant, votre feuille ressemble à ceci.

Copiez (mémorisez) l'ID de la feuille : pour ce faire, cliquez sur la barre d'adresse :

Ensuite, allons configurer les blocs dans le constructeur.

Travailler dans le constructeur de chatbot

Fonction get_records_from_table()

Pour utiliser la fonction get_info_from_table(), vous avez besoin d'un bloc dans le constructeur de chatbot.

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

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 depuis la Calculatrice

project.****record``=``get_records_from_table(1)

  1. project. - est un constructeur pour définir une variable dans la configuration du projet ;
  2. record - nom de la variable ;
  3. get_records_from_table(1) - fonction, où le paramètre est passé comme ID de table.

get_records_from_table(table_id, start_row, count, start_col, end_col) – pour obtenir des enregistrements d'une table

Paramètre Description Note
! table_id ID de la table (paramètre obligatoire)
start_row paramètre optionnel, entier. Spécifie la ligne de début de la plage accepte le numéro de ligne à partir duquel commencer la lecture des valeurs de la table, inclusif. Doit être spécifié sans guillemets
count paramètre optionnel, entier. Spécifie le nombre de lignes à récupérer valeur par défaut : 1000. Maximum : 5000. Doit être spécifié sans guillemets
start_col paramètre optionnel, chaîne. Spécifie la colonne de début de la plage accepte le nom de la colonne à partir duquel commencer la lecture des valeurs de la table, inclusif. Doit être spécifié entre guillemets
end_col paramètre optionnel, chaîne. Spécifie la colonne de fin de la plage accepte le nom de la colonne jusqu'à laquelle lire les valeurs de la table, inclusif. Doit être spécifié entre guillemets

Pour lire toutes les données à partir d'un certain point : Spécifiez uniquement le début de la plage. Pour lire toutes les données jusqu'à un certain point : Spécifiez uniquement la fin de la plage.

Au lieu de #{none}, nous écrirons notre variable dans le message en utilisant la construction #{} pour voir visuellement quelles données ont été écrites dans la variable du projet.

Attention

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

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.

Vous pourriez en avoir besoin : par exemple, si vous avez ajouté d'autres valeurs à la table, lancez simplement le bloc en mode test. Ensuite, les données dans la variable du projet seront mises à jour.

Le nom de la variable peut être n'importe quel nom que vous aimez.

Bloc de transfert de données

Ensuite, nous allons créer un bloc "Chat" pour transférer les données vers la carte du client.

"Ce bloc peut également transmettre un message de clôture du bot, comme : 'Je transmets les informations au responsable ! Le responsable se connectera 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 la commande de test "Block call 11956", où au lieu de l'ID du bloc de l'exemple, vous devez insérer votre ID de bloc.

Veuillez noter

Après les tests, remplacez "Block call 31241050" par la commande "start_block_from_ai 31241050".

La commande "Block call 31241050" est de débogage et aide à comprendre quelles données le bot enregistre (voir la section "Tests").

Pour lancer le bot pour les clients, spécifiez la commande "start_block_from_ai 31241050".

Lecture d'une table

  1. Accédez au mode test du bot.
  2. Lancez le bloc qui contient le déclencheur pour lire les données de la table.

Le bloc a fonctionné correctement. Vous pouvez le voir confirmé par les valeurs désormais stockées dans la variable correspondante dans les paramètres de votre projet.

Pour vérifier manuellement :

  1. Allez dans la section Paramètres du projet.
  2. Localisez la variable pour voir ses données actuelles.

Dans l'onglet "Variables" des paramètres du projet, vous verrez votre variable avec les valeurs ajoutées depuis la table. Ainsi, maintenant, dans votre projet, il y a une variable avec les produits, le coût et tout ce que vous avez spécifié dans la table.

Travailler dans l'assistant IA

Allez dans la section "Assistant IA" et démarrez le chatbot avec les paramètres IA.

Vous devez choisir le rôle "Assistant commercial" :

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

Paramètres de l'assistant IA

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

  1. Le poste et les instructions pour le bot.

  1. 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ù au lieu de N, l'ID du bloc est écrit avec le message final : le bloc Chat transmet les données à la carte du client :

Connaissances du bot

Dans le champ "Connaissances du bot", passez la variable qui a été précédemment mise en cache en tant que bloc avec le déclencheur.

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 disponibles.

Format des données

Dans le format des données transmises, vous spécifiez les données que vous collectez vous-même (par exemple, un produit), puis entrez la phrase avec la "clé" et assignez 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é de produit avec la clé quantity, le montant total de la commande avec la clé total_amount.

Ainsi, lors de l'appel du bloc, des variables seront transmises à la carte du client : vous pouvez ensuite travailler avec les variables, par exemple, dans le constructeur de chatbot :

À ce stade, la configuration de l'assistant IA est terminée.

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

Tester un bot

"Si vous avez déjà des bots en cours d'exécution, spécifiez dans la condition de lancement de l'assistant IA de démarrer uniquement dans la fenêtre de test."

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

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

Maintenant, dans la condition du déclencheur, vous verrez la valeur suivante :

Ainsi, le bot s'exécutera uniquement dans la fenêtre de test et nulle part ailleurs.

Après avoir débogué le bot, supprimez cette condition.

Ce message est envoyé en mode test en raison de la commande "Block call 3124105](/docs/chatbot-ai-assistant#data-transfer-format)

Après avoir testé et débogué le bot, écrivez la commande dans les paramètres du bot "start_block_from_ai 31241050".

Cette approche vous permet de construire n'importe quel type de boutique en ligne et d'exploiter n'importe quelles valeurs de données stockées dans votre table.

La seule vraie limite est votre imagination.