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 :
Ensuite, vous verrez le bouton « Ajouter une feuille », qui ouvre une fenêtre modale dans laquelle vous devez saisir le nom de la feuille :
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 » :
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 :
Pour ajouter une colonne avec un nom, cliquez sur le bouton « + » :
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.
Maintenant, votre feuille ressemble à ceci.
Copiez (retenez) l’ID de la feuille : pour cela, cliquez sur la barre d’adresse :
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.
Allez dans l’onglet approprié dans Mavibot et créez un bloc avec un déclencheur (bloc de démarrage ou bloc 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 du Calculateur
project.record = get_records_from_table(1)
project. - est un constructeur pour définir une variable dans la configuration du projet ;record - nom de la variable ;get_records_from_table(1) - fonction, où le paramètre est passé comme ID du tableau.
En savoir plus sur la fonction get_record_from_table()
get_records_from_table(table_id, start_row, count, start_col, end_col) – pour obtenir des enregistrements depuis un tableau
! 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.
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.
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.
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 au tableau, lancez simplement le bloc en mode test. Les données de la variable du projet seront alors mises à jour.
Le nom de la variable peut être celui que vous souhaitez.
Bloc de transfert de données
Ensuite, nous créerons un bloc « Chat » pour transférer les données vers la fiche du client.
« 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 ID du bloc de l’exemple, vous devez insérer l’ID de votre bloc.
Veuillez noter
Après les tests, remplacez « Block call 31241050par la commande « start_block_from_ai 31241050".
La commande « Block call 31241050est 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 31241050".
Lecture d’un tableau
Accédez au mode de test du bot .
Lancez le bloc qui contient le déclencheur de lecture des données du tableau.
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 :
Allez dans l’onglet Paramètres du projet section.
Repérez 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 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 » :
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 :
La position et les instructions pour le bot.
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 :
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.
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 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.
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 :
À 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, 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
Étape 2. Sélectionnez l’onglet avec la fenêtre de test et cliquez sur « Ajouter un déclencheur » :
Maintenant, dans la condition de déclenchement, vous verrez la valeur suivante :
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.
Ce message est envoyé en mode test en raison de la commande « Block call 3124105
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 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.
Mis à jour