Dialogflow CX-Einrichtung

In dieser Anleitung werden alle erforderlichen Einrichtungsschritte für die Verwendung von Dialogflow CX erläutert.

Hinweis

Bevor Sie diese Anleitung lesen, sollten Sie Folgendes tun:

  1. Dialogflow CX-Grundlagen
  2. Editionen

Informationen zur Google Cloud Console

Die Google Cloud Console (Dokumentation ansehen, Console öffnen) ist eine Web-UI zur Bereitstellung, Konfiguration, Verwaltung und Überwachung von Systemen, die Google Cloud-Produkte verwenden. Dialogflow-Ressourcen werden in der Google Cloud Console eingerichtet und verwaltet.

Projekt erstellen

Wenn Sie Dienste von Google Cloud nutzen möchten, müssen Sie ein Projekt erstellen. Es dient zur Organisation all Ihrer Google Cloud-Ressourcen. Ein Projekt umfasst Mitarbeiter, aktivierte APIs (und andere Ressourcen), Monitoring-Tools, Zahlungsinformationen sowie Authentifizierungs- und Zugriffssteuerungen. Sie können wahlweise ein Projekt erstellen oder Ihre Google Cloud-Ressourcen durch Erstellen mehrerer Projekte in einer Ressourcenhierarchie organisieren. Notieren Sie sich beim Erstellen eines Projekts die Projekt-ID. Diese ID benötigen Sie für API-Aufrufe. Weitere Informationen zu Projekten finden Sie in der Dokumentation zu Resource Manager.

Wählen Sie in der Cloud Console auf der Seite für die Projektauswahl ein Cloud-Projekt aus oder erstellen Sie eines.

Zur Projektauswahl

Abrechnung aktivieren

In Rechnungskonten ist festgelegt, wer die Nutzungsgebühren für Ressourcen bezahlt. Ein Rechnungskonto kann mit einem oder mehreren Projekten verknüpft sein. Die Gebühren für die Projektnutzung werden dem verknüpften Rechnungskonto belastet. In den meisten Fällen konfigurieren Sie die Abrechnung beim Erstellen eines Projekts. Weitere Informationen finden Sie in der Dokumentation zur Abrechnung.

Die Abrechnung für das Google Cloud-Projekt muss aktiviert sein. So prüfen Sie, ob die Abrechnung für Ihr Projekt aktiviert ist.

API aktivieren

Für Ihr Projekt müssen Sie die Dialogflow API aktivieren. Weitere Informationen zur Aktivierung von APIs finden Sie in der Dokumentation zu Service Usage.

Aktivieren Sie die Dialogflow API.

Aktivieren Sie die API

Authentifizierung einrichten

Wenn Sie vorhaben, die Dialogflow API zu verwenden, müssen Sie die Authentifizierung einrichten. Jede Client-Anwendung, die die API verwendet, muss authentifiziert sein und Zugriff auf die angeforderten Ressourcen haben. In diesem Abschnitt werden wichtige Konzepte der Authentifizierung erklärt und Schritte für die Einrichtung beschrieben. Weitere Informationen finden Sie in der Authentifizierungsübersicht für Google Cloud.

Informationen zu Dienstkonten

Für die Authentifizierung gibt es mehrere Möglichkeiten. Es wird jedoch empfohlen, für die Authentifizierung und die Zugriffssteuerung Dienstkonten zu verwenden. Die Anmeldedaten für ein Dienstkonto werden für Anwendungen vergeben, nicht für Endnutzer. Dienstkonten gehören zu Projekten. Sie können mehrere Dienstkonten für ein Projekt erstellen. Weitere Informationen finden Sie unter Details zu Dienstkonten.

Informationen zu Rollen

Wenn eine Identität eine API aufruft, wird von Google Cloud verlangt, dass die Identität über die entsprechenden Berechtigungen verfügt. Sie können Berechtigungen gewähren durch Zuweisen von Rollen für Dienstkonten. Weitere Informationen finden Sie in der Dokumentation zur Identitäts- und Zugriffsverwaltung (IAM).

Zum Testen der Dialogflow API können Sie in den folgenden Schritten die Rolle Projekt > Inhaber verwenden, mit der dem Dienstkonto vollständiger Zugriff auf das Projekt gewährt wird. Weitere Informationen zu den speziellen Rollen in Dialogflow finden Sie in der Dokumentation zur Zugriffssteuerung in Dialogflow.

Informationen zu Dienstkontoschlüsseln

Dienstkonten sind mit einem oder mehreren öffentlichen/privaten Schlüsselpaaren verbunden. Wenn Sie ein neues Schlüsselpaar erstellen, laden Sie den privaten Schlüssel herunter. Der private Schlüssel wird verwendet, um beim Aufrufen der API Anmeldedaten zu erzeugen. Die Verantwortung für die Sicherheit des privaten Schlüssels und andere Verwaltungsvorgänge wie die Schlüsselrotation liegt bei Ihnen.

Dienstkonto erstellen und Datei mit dem privaten Schlüssel herunterladen

Authentifizierung einrichten:

  1. Wechseln Sie in der Cloud Console zur Seite Dienstkontoschlüssel erstellen.

    Zur Seite "Dienstkontoschlüssel erstellen"
  2. Wählen Sie aus der Liste Dienstkonto die Option Neues Dienstkonto aus.
  3. Geben Sie im Feld Dienstkontoname einen Namen ein.
  4. Wählen Sie in der Liste Rolle die Option Projekt > Inhaber aus.

    Hinweis: Über das Feld Rolle wird Ihr Dienstkonto für den Zugriff auf Ressourcen autorisiert. Sie können dieses Feld später in der Cloud Console aufrufen und ändern. Wenn Sie eine Produktionsanwendung entwickeln, müssen Sie detailliertere Berechtigungen als Projekt > Inhaber angeben. Weitere Informationen finden Sie unter Dienstkonten Rollen zuweisen.
  5. Klicken Sie auf Erstellen. Eine JSON-Datei mit Ihrem Schlüssel wird auf Ihren Computer heruntergeladen.

Schlüsseldatei des Dienstkontos in Ihrer Umgebung verwenden

Die Anmeldedaten zur Authentifizierung für Ihren Anwendungscode geben Sie durch Festlegung der Umgebungsvariable GOOGLE_APPLICATION_CREDENTIALS an. Geben Sie für [PATH] den Dateipfad der JSON-Datei an, die Ihren Dienstkontoschlüssel enthält. Diese Variable gilt nur für Ihre aktuelle Shell-Sitzung. Wenn Sie eine neue Sitzung öffnen, müssen Sie die Variable neu festlegen.

Linux oder macOS

export GOOGLE_APPLICATION_CREDENTIALS="[PATH]"

Beispiel:

export GOOGLE_APPLICATION_CREDENTIALS="/home/user/Downloads/my-key.json"

Windows

Mit PowerShell:

$env:GOOGLE_APPLICATION_CREDENTIALS="[PATH]"

Beispiel:

$env:GOOGLE_APPLICATION_CREDENTIALS="C:\Users\username\Downloads\my-key.json"

Mit Eingabeaufforderung:

set GOOGLE_APPLICATION_CREDENTIALS=[PATH]

Cloud SDK installieren und initialisieren

Wenn Sie vorhaben, die Dialogflow API zu verwenden, müssen Sie das Cloud SDK installieren und initialisieren. Das Cloud SDK umfasst mehrere Tools, mit denen Sie auf Google Cloud gehostete Ressourcen und Anwendungen verwalten können. Dazu gehört auch das gcloud-Befehlszeilentool.

Unter folgendem Link finden Sie eine Anleitung:

Installieren und initialisieren Sie das Cloud SDK.

SDK und Authentifizierung testen

Wenn Sie in den vorangegangenen Schritten die Authentifizierung eingerichtet haben, können Sie Ihre Authentifizierungsumgebung mit dem Tool 'gcloud' testen. Führen Sie folgenden Befehl aus und achten Sie darauf, dass kein Fehler auftritt und Anmeldedaten zurückgegeben werden:

gcloud auth application-default print-access-token

Dieser Befehl wird in allen REST-Beispielen für die Dialogflow-Befehlszeile verwendet, um API-Aufrufe zu authentifizieren.

Dialogflow-Clientbibliothek installieren