Mit einer speziellen, vom MaviBot-Team entwickelten Funktion kann Ihr KI-Chatbot intelligent Werte aus einem Google Sheet auslesen und in einer Systemvariable in Ihren Projekteinstellungen speichern. Dies schafft eine synchronisierte, dynamische Datenquelle für Ihren Assistenten.

Praktische Anwendungen

Diese Fähigkeit ist für Szenarien wie die folgenden unerlässlich:

  • Produktkatalog-Assistent: Ein KI, die Kunden in Echtzeit zu Ihrem aktuellen Produktsortiment, Preisen und Verfügbarkeit berät.
  • Intelligenter Werbe-Bot: Ein Bot, der Ihre Angebote bewirbt, indem er dynamisch Funktionen, Spezifikationen oder Deals hervorhebt, die direkt aus Ihrem Sheet gezogen werden.

So bereiten Sie Ihre Tabelle für die Integration vor

Um zu beginnen, gehen Sie zum Tabellenbereich:

Als nächstes sehen Sie die Schaltfläche "Tabelle hinzufügen", die ein modales Fenster öffnet, in das Sie den Namen der Tabelle eingeben müssen:

Geben Sie den Namen für die Tabelle ein und klicken Sie auf die Schaltfläche "Fertig". Dann wird eine neue Tabelle im Projekt erstellt und im Bereich "Tabellen" angezeigt:

Tabelleneinstellungen

Nach dem Erstellen der Tabelle müssen Sie Zeilen und Spalten hinzufügen. Suchen Sie dazu die Schaltfläche "Gehe zu" auf der Karte der gewünschten Tabelle und klicken Sie darauf.

Sie sehen die folgenden Einstellungen:

Um eine Spalte mit einem Namen hinzuzufügen, klicken Sie auf die Schaltfläche "+":

Wenn Sie auf die Schaltfläche klicken, öffnet sich ein modales Fenster, in das Sie einen Namen für die neue Spalte eingeben können.

Nachdem Sie den Spaltennamen eingegeben haben, klicken Sie auf die Schaltfläche "Fertig", dann wird die neue Spalte zur Tabelle hinzugefügt. Fügen Sie die erforderliche Anzahl von Spalten und dann Zeilen hinzu.

Jetzt sieht Ihre Tabelle so aus.

Kopieren (merken) Sie die Tabellen-ID: Klicken Sie dazu auf die Adressleiste:

Als nächstes konfigurieren wir die Blöcke im Builder.

Arbeiten im Chatbot-Builder

Funktion get_records_from_table()

Um die Funktion get_info_from_table() zu verwenden, benötigen Sie einen Block im Chatbot-Builder.

Gehen Sie zum entsprechenden Tab in Mavibot und erstellen Sie einen Block mit einem Trigger (Start-Block oder Trigger-Block):

Definieren Sie eine Variable (sie wird für das Wissen des KI-Assistenten verwendet): In diesem Beispiel ist die Variable 'record'.

Beispielcode aus dem Rechner

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

  1. project. - ist ein Konstruktor zum Setzen einer Variable in der Projektkonfiguration;
  2. record - Name der Variable;
  3. get_records_from_table(1) - Funktion, bei der der Parameter als Tabellen-ID übergeben wird.

get_records_from_table(table_id, start_row, count, start_col, end_col) – zum Abrufen von Datensätzen aus einer Tabelle

Parameter Beschreibung Hinweis
! table_id Tabellen-ID (erforderlicher Parameter)
start_row optionaler Parameter, Ganzzahl. Gibt die Startzeile des Bereichs an akzeptiert die Zeilennummer, ab der die Tabellenwerte gelesen werden sollen, inklusive. Muss ohne Anführungszeichen angegeben werden
count optionaler Parameter, Ganzzahl. Gibt die Anzahl der abzurufenden Zeilen an Standardwert: 1000. Maximum: 5000. Muss ohne Anführungszeichen angegeben werden
start_col optionaler Parameter, Zeichenfolge. Gibt die Startspalte des Bereichs an akzeptiert den Spaltennamen, ab dem die Tabellenwerte gelesen werden sollen, inklusive. Muss in Anführungszeichen angegeben werden
end_col optionaler Parameter, Zeichenfolge. Gibt die Endspalte des Bereichs an akzeptiert den Spaltennamen, bis zu dem die Tabellenwerte gelesen werden sollen, inklusive. Muss in Anführungszeichen angegeben werden

Um alle Daten ab einem bestimmten Punkt zu lesen: Geben Sie nur den Start des Bereichs an. Um alle Daten bis zu einem bestimmten Punkt zu lesen: Geben Sie nur das Ende des Bereichs an.

Anstelle von #{none} schreiben wir unsere Variable in die Nachricht mit der #{} Konstruktion, um visuell zu sehen, welche Daten in die Projektvariable geschrieben wurden.

Achtung

Die in die Nachricht eingebettete Variable wird benötigt, um zu überprüfen, ob der Bot die Funktion korrekt liest. Wenn Sie den Block im Testmodus ausführen, zeigt der Bot die Werte an, die der Variable zugewiesen werden.

Bitte beachten

Löschen Sie diesen Block nicht, nachdem Sie den Blockaufruf im Testmodus konfiguriert und die Variable in den Projekteinstellungen gespeichert haben.

Sie könnten ihn benötigen: Wenn Sie beispielsweise weitere Werte zur Tabelle hinzugefügt haben, starten Sie einfach den Block im Testmodus. Dann werden die Daten in der Projektvariable aktualisiert.

Der Variablenname kann ein beliebiger Name sein, der Ihnen gefällt.

Datenübergabeblock

Als nächstes erstellen wir einen "Chat"-Block zur Übergabe von Daten an die Kundenkarte.

"Dieser Block kann auch eine Abschlussnachricht vom Bot übermitteln, wie zum Beispiel: 'Ich leite die Informationen an den Manager weiter! Der Manager wird sich innerhalb von 10 Minuten verbinden.'"

Kopieren Sie als nächstes die Block-ID. Sie benötigen sie, um den KI-Assistenten im Befehl "start_block_from_ai 11956" und den Testbefehl "Blockaufruf 11956" zu konfigurieren, wobei Sie anstelle der Block-ID aus dem Beispiel Ihre Block-ID einfügen müssen.

Bitte beachten

Ersetzen Sie nach dem Testen "Blockaufruf 31241050" durch den Befehl "start_block_from_ai 31241050".

Der Befehl "Blockaufruf 31241050" dient dem Debugging und hilft zu verstehen, welche Daten der Bot aufzeichnet (siehe Abschnitt "Testen").

Um den Bot für Kunden zu starten, geben Sie den Befehl "start_block_from_ai 31241050" an.

Eine Tabelle lesen

  1. Navigieren Sie zum Bot-Testmodus.
  2. Starten Sie den Block, der den Trigger zum Lesen der Tabellendaten enthält.

Der Block hat korrekt funktioniert. Sie können dies bestätigt sehen durch die Werte, die jetzt in der entsprechenden Variable in Ihren Projekteinstellungen gespeichert sind.

Zur manuellen Überprüfung:

  1. Gehen Sie zum Bereich Projekteinstellungen.
  2. Suchen Sie die Variable, um ihre aktuellen Daten anzuzeigen.

Im Tab "Variablen" in den Projekteinstellungen sehen Sie Ihre Variable mit den darin aus der Tabelle hinzugefügten Werten. In Ihrem Projekt befindet sich jetzt also eine Variable mit Waren, Kosten und allem, was Sie in der Tabelle angegeben haben.

Arbeiten im KI-Assistenten

Gehen Sie zum Bereich "KI-Assistent" und starten Sie den Chatbot mit KI-Einstellungen.

Sie müssen die Rolle "Verkaufsassistent" auswählen:

Wir werden auch zusätzliche Einstellungen vornehmen:

KI-Assistent-Einstellungen

Schreiben Sie in den Bot-Einstellungen die folgenden Daten:

  1. Die Position und Anweisungen für den Bot.

  1. Der Befehl zum Aufrufen des Blocks und zum Übertragen von Variablen an das System wird wie folgt geschrieben:

"Wenn alles korrekt ist, führen Sie den Befehl "start_block_from_ai 11956" aus, wobei anstelle von N die Block-ID mit der endgültigen Nachricht geschrieben wird: Der Chat-Block überträgt Daten an die Kundenkarte:

Bot-Wissen

Übergeben Sie im Feld "Bot-Wissen" die Variable, die zuvor als Block mit dem Trigger zwischengespeichert wurde.

Bot-Wissen.

Auf diese Weise entnimmt der Bot Informationen aus einer Variable in den Projekteinstellungen und berät Ihre Kunden über das verfügbare Produktsortiment.

Datenformat

Im Format der übertragenen Daten geben Sie die Daten an, die Sie selbst sammeln (z. B. ein Produkt), geben dann die Phrase mit dem "Schlüssel" ein und weisen dem Schlüssel einen Wert zu.

der Kundenname mit Schlüssel client_name, die Telefonnummer des Kunden mit Schlüssel phone_number, die Stadt und die Adresse mit Schlüssel city_address, das ausgewählte Produkt mit Schlüssel product, die Produktmenge mit Schlüssel quantity, der Gesamtbestellbetrag mit Schlüssel total_amount.

Auf diese Weise werden beim Aufruf des Blocks Variablen an die Kundenkarte übergeben: Dann können Sie mit den Variablen arbeiten, z. B. im Chatbot-Builder:

An diesem Punkt ist die Einrichtung des KI-Assistenten abgeschlossen.

Die restlichen Parameter können Sie nach eigenem Ermessen einstellen:

Testen eines Bots

"Wenn Sie bereits laufende Bots haben, geben Sie in der Startbedingung des KI-Assistenten an, dass er nur im Testfenster starten soll."

Schritt 1. Klicken Sie auf den Trigger-Builder

Schritt 2. Wählen Sie den Tab mit dem Testfenster aus und klicken Sie auf "Trigger hinzufügen":

Jetzt sehen Sie in der Trigger-Bedingung den folgenden Wert:

Auf diese Weise läuft der Bot nur im Testfenster und nirgendwo anders.

Entfernen Sie diese Bedingung nach dem Debuggen des Bots.

Diese Nachricht wird im Testmodus aufgrund des Befehls "Blockaufruf 3124105 gesendet.

Schreiben Sie nach dem Testen und Debuggen des Bots den Befehl in die Einstellungen des Bots "start_block_from_ai 31241050".

Dieser Ansatz ermöglicht es Ihnen, jede Art von Online-Shop zu erstellen und beliebige Datenwerte zu nutzen, die in Ihrer Tabelle gespeichert sind.

Die einzige wirkliche Grenze ist Ihre Vorstellungskraft.