Datenbank abfragen

Ihr Webhook verwendet derzeit hartcodierte Daten in der Funktion accountBalanceCheck. In diesem Schritt der Anleitung erstellen Sie eine Spanner-Datenbank, füllen sie mit Daten zu Guthaben auf und aktualisieren Ihre Funktion, um die Datenbank abzufragen.

Projektkonfiguration

Es ist wichtig, dass Ihr Dialogflow-Agent und die Datenbank sich beide im selben Projekt befinden. Dies ist die einfachste Möglichkeit, für den sicheren Zugriff auf Ihre Datenbank. Außerdem müssen Sie die Spanner API aktivieren.

  1. Bevor Sie die Datenbank erstellen, wählen Sie Ihr Projekt in der Google Cloud Console aus.

    Zur Projektauswahl

  2. Aktivieren Sie die Spanner API für das Projekt.

    Spanner API aktivieren

Spanner-Instanz erstellen

Wenn Sie Spanner zum ersten Mal verwenden, müssen Sie eine Instanz erstellen eine Zuordnung von Ressourcen, die von Spanner-Datenbanken in dieser Instanz verwendet werden.

  1. Rufen Sie in der Google Cloud Console die Seite Spanner-Instanzen auf.

    Spanner-Instanzen aufrufen

  2. Klicken Sie auf Instanz erstellen.

  3. Geben Sie als Instanznamen Tutorial Instance ein.

  4. Die Instanz-ID wird automatisch anhand des Instanznamens eingegeben.

  5. Gehen Sie unter Konfiguration auswählen so vor: Behalten Sie die Standardoption Regional bei und wählen Sie dieselbe Region aus. Ort das Sie beim Erstellen der Funktion ausgewählt haben.

  6. Geben Sie unter Rechenkapazität zuweisen den Wert 100 Verarbeitungseinheiten ein. Dies bietet eine minimale Kapazität für die Anleitung.

  7. Klicken Sie auf Erstellen. In der Google Cloud Console wird die Seite Übersicht für die von Ihnen erstellte Instanz angezeigt.

Spanner-Datenbank erstellen

Jetzt haben Sie eine Instanz. müssen Sie eine Datenbank erstellen. So erstellen Sie eine Datenbank:

  1. Klicken Sie auf der Seite Übersicht für die Instanz auf Datenbank erstellen.
  2. Geben Sie als Datenbanknamen tutorial-database ein.
  3. Wählen Sie den Datenbankdialekt Google Standard SQL aus.
  4. Klicken Sie auf Erstellen. In der Google Cloud Console wird die Seite Übersicht für die Datenbank angezeigt. die Sie erstellt haben.

Tabellen für Ihre Datenbank erstellen

Jetzt, wo Sie eine Datenbank haben, müssen Sie Tabellen für die Datenbank erstellen. So erstellen Sie Tabellen:

  1. Gehen Sie auf der Seite Übersicht der Datenbank im Abschnitt „Tabellen“ so vor: Klicken Sie auf Tabelle erstellen.
  2. Geben Sie auf der Seite DDL-Anweisungen schreiben Folgendes ein:

    CREATE TABLE Checking (
      AccountId INT64,
      Balance INT64,
    ) PRIMARY KEY(AccountId);
    
  3. Klicken Sie auf Senden. In der Google Cloud Console wird die Seite Übersicht der Datenbank angezeigt. Dort wird angezeigt, dass Schemaupdates ausgeführt werden. Warten Sie, bis das Update abgeschlossen ist.

  4. Gehen Sie auf der Seite Übersicht der Datenbank im Abschnitt „Tabellen“ so vor: Klicken Sie auf Tabelle erstellen.

  5. Geben Sie auf der Seite DDL-Anweisungen schreiben Folgendes ein:

    CREATE TABLE Savings (
      AccountId INT64,
      Balance INT64,
    ) PRIMARY KEY(AccountId);
    
  6. Klicken Sie auf Senden. Die Google Cloud Console kehrt zur Seite Übersicht der Datenbank zurück und zeigt an, dass Schemaaktualisierungen durchgeführt werden. Warten Sie, bis das Update abgeschlossen ist.

Daten in Tabellen einfügen

Jetzt, da Ihre Datenbank Tabellen enthält, müssen Sie den Tabellen Daten hinzufügen. So fügen Sie Daten hinzu:

  1. Gehen Sie in der Liste der Tabellen auf der Seite Übersicht der Datenbank folgendermaßen vor: klicken Sie auf die Tabelle Girokonto. In der Google Cloud Console wird die Seite Schema der Tabelle angezeigt.
  2. Klicken Sie im linken Navigationsmenü Klicken Sie auf Daten, um die Seite Daten der Tabelle aufzurufen.
  3. Klicken Sie auf Einfügen. In der Google Cloud Console wird die Seite Abfrage der Tabelle mit einem Neuer Abfragetab, der die Anweisungen INSERT und SELECT enthält. Überschreiben Sie diese Anweisungen mit den folgenden:

    INSERT INTO Checking (AccountId, Balance)
    VALUES(1, 1000),
          (2, 2000);
    
  4. Klicken Sie auf Ausführen.

  5. Klicken Sie im linken Navigationsmenü Klicken Sie noch einmal auf Daten, um die Daten der Tabelle aufzurufen. Prüfen Sie, ob die Tabelle die gewünschten Daten enthält.

  6. Klicken Sie auf den Link tutorial-database: Übersicht. um zur Übersichtsseite der Datenbank zurückzukehren.

  7. Klicken Sie in der Liste der Tabellen auf der Seite Übersicht der Datenbank auf die Tabelle „Einsparungen“. In der Google Cloud Console wird die Seite Schema der Tabelle angezeigt.

  8. Klicken Sie im linken Navigationsmenü Klicken Sie auf Daten, um die Seite Daten der Tabelle aufzurufen.

  9. Klicken Sie auf Einfügen. In der Google Cloud Console wird die Seite Abfrage der Tabelle mit einem Neuer Abfragetab, der die Anweisungen INSERT und SELECT enthält. Überschreiben Sie diese Anweisungen mit den folgenden:

    INSERT INTO Savings (AccountId, Balance)
    VALUES(1, 10000),
          (2, 20000);
    
  10. Klicken Sie auf Ausführen.

  11. Klicken Sie im linken Navigationsmenü Klicken Sie noch einmal auf Daten, um die Daten der Tabelle aufzurufen. Prüfen Sie, ob die Tabelle die gewünschten Daten enthält.

Cloud Function für die Abfrage der Datenbank aktualisieren

Die Funktion accountBalanceCheck im Webhook-Code prüft, ob bestimmte Umgebungsvariablen mit Informationen zur Verbindung zur Datenbank festgelegt sind. Wenn diese Umgebungsvariablen nicht festgelegt sind, Die Funktion verwendet einen hartcodierten Kontostand.

Nachdem Sie nun eine Datenbank eingerichtet haben, Aktualisieren Sie die Cloud Functions-Funktion, um die erforderlichen Umgebungsvariablen festzulegen:

  1. Öffnen Sie die Übersichtsseite zu Cloud Functions.

    Zur Cloud Functions-Übersicht

  2. Klicken Sie auf die Funktion tutorial-banking-webhook, um die zugehörige Detailseite aufzurufen.

  3. Klicken Sie auf Bearbeiten.

  4. Öffnen Sie den Bereich Laufzeit-, Build- und Verbindungseinstellungen.

  5. Wählen Sie den Tab Laufzeit aus.

  6. Fügen Sie im Bereich „Laufzeit-Umgebungsvariablen“ die folgenden Variablen hinzu:

    • PROJECT_ID: Ihre Projekt-ID.
    • SPANNER_INSTANCE_ID: Ihre Spanner-Instanz-ID (wahrscheinlich tutorial-instance)
    • SPANNER_DATABASE_ID: Ihre Spanner-Datenbank-ID (wahrscheinlich tutorial-database)
  7. Klicken Sie auf Weiter.

  8. Klicken Sie auf Bereitstellen.

  9. Warten Sie, bis die Statusanzeige anzeigt, dass die Funktion wurde bereitgestellt.

Agent testen

Der Agent kann jetzt verwendet werden. Klicken Sie in der Dialogflow-Konsole auf die Schaltfläche Test Agent (Agent testen). um den Simulator zu öffnen. Versuchen Sie, die folgende Unterhaltung mit dem Kundenservicemitarbeiter zu führen:

Konversationsrunde Ich Agent
1 Hallo! Hallo, vielen Dank, dass Sie sich für die ACME-Bank entschieden haben.
2 Ich möchte meinen Kontostand wissen. Für welches Konto soll das Guthaben angezeigt werden: Sparkonto oder Girokonto?
3 Wird überprüft Dein aktueller Kontostand: 10,00 $

Wenn Sie den Code untersuchen, ist 10 $ nicht der hartcodierte Wert. Das bedeutet, dass der Webhook mit der Datenbank verbunden ist. mit einem Saldo von 10 $.

Fehlerbehebung

Der Webhook-Code enthält Logging-Anweisungen. Wenn Probleme auftreten, sehen Sie sich die Logs für Ihre Cloud Functions-Funktion an.

Wenn Ihre Funktion keine Verbindung zur Datenbank herstellen kann und in den Protokollen ein Berechtigungsfehler angezeigt wird, müssen Sie möglicherweise die Rolle für das Standarddienstkonto korrigieren, das von Ihrer Funktion verwendet wird. Dieses Dienstkonto hat das Format PROJECT_ID@appspot.gserviceaccount.com Sie haben folgende Möglichkeiten, das Problem zu beheben:

Weitere Informationen

Weitere Informationen zu den oben genannten Schritten finden Sie unter: