Diese Seite wurde von der Cloud Translation API übersetzt.

Datenbank abfragen

Der Webhook verwendet derzeit hartcodierte Daten in der Funktion accountBalanceCheck. In diesem Schritt der Anleitung erstellen Sie eine Spanner-Datenbank, füllen diese mit Kontostanddaten und aktualisieren die Funktion zum Abfragen der Datenbank.

Projektkonfiguration

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

Wählen Sie Ihr Projekt in der Google Cloud Console aus, bevor Sie die Datenbank erstellen.

Zur Projektauswahl
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. Dabei handelt es sich um eine Zuordnung von Ressourcen, die von Spanner-Datenbanken in dieser Instanz verwendet werden.

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

Spanner-Instanzen aufrufen
Klicken Sie auf Instanz erstellen.
Geben Sie als Instanznamen Tutorial Instance ein.
Die Instanz-ID wird anhand des Instanznamens automatisch eingegeben.
Behalten Sie unter Konfiguration auswählen die Standardoption Regional bei und wählen Sie denselben Standort für die Region aus, den Sie beim Erstellen der Funktion ausgewählt haben.
Geben Sie unter Rechenkapazität zuweisen 100 Verarbeitungseinheiten ein. Dies bietet eine minimale Kapazität für die Anleitung.
Klicken Sie auf Erstellen. In der Google Cloud Console wird die Seite Übersicht für die von Ihnen erstellte Instanz angezeigt.

Spanner-Datenbank erstellen

Da Sie nun eine Instanz haben, müssen Sie eine Datenbank erstellen. So erstellen Sie eine Datenbank:

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

Tabellen für die Datenbank erstellen

Da Sie nun eine Datenbank haben, müssen Sie Tabellen für sie erstellen. So erstellen Sie Tabellen:

Klicken Sie auf der Seite Übersicht der Datenbank im Abschnitt „Tabellen“ auf Tabelle erstellen.

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

CREATE TABLE Checking (
  AccountId INT64,
  Balance INT64,
) PRIMARY KEY(AccountId);

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.
Klicken Sie auf der Seite Übersicht der Datenbank im Abschnitt „Tabellen“ auf Tabelle erstellen.

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

CREATE TABLE Savings (
  AccountId INT64,
  Balance INT64,
) PRIMARY KEY(AccountId);

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

Nun, da Ihre Datenbank Tabellen enthält, fügen Sie den Tabellen Daten hinzu. So fügen Sie Daten hinzu:

Klicken Sie auf der Seite Übersicht der Datenbank in der Liste der Tabellen auf die Tabelle „Wird geprüft“. In der Google Cloud Console wird die Seite Schema der Tabelle angezeigt.
Klicken Sie im linken Navigationsmenü auf Daten, um die Seite Daten der Tabelle aufzurufen.
Klicken Sie auf Einfügen. In der Google Cloud Console wird die Seite Abfrage der Tabelle mit einem neuen Abfragetab angezeigt, der die Anweisungen INSERT und SELECT enthält. Überschreiben Sie diese Anweisungen mit Folgendem:
```
INSERT INTO Checking (AccountId, Balance)
VALUES(1, 1000),
      (2, 2000);
```
Klicken Sie auf Ausführen.
Klicken Sie im linken Navigationsmenü noch einmal auf Daten, um die Daten der Tabelle aufzurufen. Vergewissern Sie sich, dass die Tabelle die gewünschten Daten enthält.
Klicken Sie auf den Link tutorial-database: Übersicht, um zur Übersichtsseite der Datenbank zurückzukehren.
Klicken Sie auf der Seite Übersicht der Datenbank in der Liste der Tabellen auf die Tabelle „Einsparungen“. In der Google Cloud Console wird die Seite Schema der Tabelle angezeigt.
Klicken Sie im linken Navigationsmenü auf Daten, um die Seite Daten der Tabelle aufzurufen.
Klicken Sie auf Einfügen. In der Google Cloud Console wird die Seite Abfrage der Tabelle mit einem neuen Abfragetab angezeigt, der die Anweisungen INSERT und SELECT enthält. Überschreiben Sie diese Anweisungen mit Folgendem:
```
INSERT INTO Savings (AccountId, Balance)
VALUES(1, 10000),
      (2, 20000);
```
Klicken Sie auf Ausführen.
Klicken Sie im linken Navigationsmenü noch einmal auf Daten, um die Daten der Tabelle aufzurufen. Vergewissern Sie sich, dass die Tabelle die gewünschten Daten enthält.

Cloud Functions-Funktion zum Abfragen der Datenbank aktualisieren

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

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

Öffnen Sie die Übersichtsseite zu Cloud Functions.

Zur Cloud Functions-Übersicht
Klicken Sie auf die Funktion „tutorial-banking-webhook“, um die zugehörige Detailseite aufzurufen.
Klicken Sie auf Bearbeiten.
Öffnen Sie den Bereich Laufzeit-, Build- und Verbindungseinstellungen.
Wählen Sie den Tab Laufzeit aus.
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)
Klicken Sie auf Next (Weiter).
Klicken Sie auf Bereitstellen.
Warten Sie, bis die Statusanzeige anzeigt, dass die Funktion erfolgreich bereitgestellt wurde.

Agent testen

Der Agent kann jetzt ausprobiert 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:

Gesprächsführung	Sie	Agent
1	Guten Tag,	Hallo, vielen Dank, dass Sie sich für die ACME Bank entschieden haben.
2	Ich möchte meinen Kontostand wissen	Für welches Konto möchten Sie das Guthaben erhalten: Spar- oder Girokonto?
3	Wird überprüft	Hier ist dein aktueller Kontostand: 10,00 $

Wenn Sie den Code prüfen, ist 10 $ nicht der hartcodierte Wert. Das bedeutet, dass der Webhook eine Verbindung zur Datenbank hergestellt hat, die noch ein Guthaben von 10 $aufweist.

Fehlerbehebung

Der Webhook-Code enthält Logging-Anweisungen. Wenn Probleme auftreten, können Sie die Logs für Ihre Cloud Functions-Funktion aufrufen.

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

Wenn das Standarddienstkonto auf der IAM-Hauptseite angezeigt wird, ändern Sie die Berechtigungen für das Dienstkonto. Die Rolle Bearbeiter funktioniert, in einem Produktionsszenario benötigen Sie jedoch eine detailliertere Rolle.

Zur IAM-Hauptseite
Wenn ein Standarddienstkonto nicht auf der IAM-Hauptseite angezeigt wird, gewähren Sie die erforderliche Rolle. Fügen Sie dazu das Dienstkonto als neues Hauptkonto hinzu.
Alternativ können Sie ein selbst erstelltes Dienstkonto verwenden.

Weitere Informationen

Weitere Informationen zu den oben genannten Schritten finden Sie hier:

Zurück

Webhook-Dienst erstellen

Weiter

Agent hosten