Diese Seite wurde von der Cloud Translation API übersetzt.
Switch to English

Kurzanleitung: Einrichtung

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

Hinweis

Bevor Sie diese Anleitung lesen, sollten Sie mit Folgendem vertraut sein:

  1. Grundlagen von Dialogflow
  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.

Beim Erstellen eines Agents können Sie optional ein grundlegendes Projekt von der Dialogflow-Konsole (Dokumentation aufrufen, Konsole öffnen) erstellen lassen. Wenn Sie Ihr Projekt für mehr als nur den einfachen Zugriff auf eine kostenlose Version verwenden möchten oder planen, die API zu verwenden, sollten Sie ein Projekt mit der Google Cloud Console wie unten beschrieben erstellen.

Wir empfehlen Ihnen, zum Experimentieren, zum Testen und für die Produktion separate Projekte zu erstellen. Pro Projekt können Sie nur einen Dialogflow Agent erstellen. Wenn Sie mehrere Agents benötigen, erstellen Sie mehrere Projekte.

Wählen Sie in der Google Cloud Console auf der Seite der Projektauswahl ein Google 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 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

  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

Sie haben drei Möglichkeiten, die API aufzurufen: Über von Google unterstützte Clientbibliotheken, REST und gRPC. Die Clientbibliotheken sind für mehrere gängige Sprachen verfügbar. Das ist die empfohlene Option. So installieren Sie eine Clientbibliothek:

C#

Installieren Sie das Paket Google.Cloud.Dialogflow.V2 von NuGet. Fügen Sie es wie gewohnt zu Ihrem Projekt hinzu (z. B. indem Sie mit der rechten Maustaste auf das Projekt in Visual Studio klicken und "NuGet-Pakete verwalten…" auswählen). Aktivieren Sie Vorabversionspakete (beispielsweise in der Benutzeroberfläche von Visual Studio NuGet mithilfe des Kästchens "Vorabversion einbeziehen").

Alternativ können Sie die NuGet-Befehlszeilenschnittstelle verwenden:

nuget install Google.Cloud.Dialogflow.V2 -PreRelease

Go

go get cloud.google.com/go/dialogflow/apiv2

Java

Wenn Sie Maven verwenden, fügen Sie Ihrer Datei pom.xml den folgenden Code hinzu. Weitere Informationen zu BOMs finden Sie unter The Google Cloud Platform Libraries BOM.

<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>com.google.cloud</groupId>
      <artifactId>libraries-bom</artifactId>
      <version>18.0.0</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>

<dependencies>
  <dependency>
    <groupId>com.google.cloud</groupId>
    <artifactId>google-cloud-dialogflow</artifactId>
  </dependency>

Wenn Sie Gradle verwenden, fügen Sie den Abhängigkeiten Folgendes hinzu:

implementation platform('com.google.cloud:libraries-bom:16.4.0')

compile 'com.google.cloud:google-cloud-dialogflow'

Wenn Sie sbt nutzen, fügen Sie den Abhängigkeiten Folgendes hinzu:

libraryDependencies += "com.google.cloud" % "google-cloud-dialogflow" % "2.4.6"

Bei Verwendung von IntelliJ oder Eclipse können Sie Ihrem Projekt mithilfe der folgenden IDE-Plug-ins Clientbibliotheken hinzufügen:

Diese Plug-ins bieten zusätzliche Funktionen wie die Schlüsselverwaltung für Dienstkonten. Einzelheiten finden Sie in der Dokumentation der einzelnen Plug-ins.

Node.js

npm install @google-cloud/dialogflow

PHP

  1. Installieren Sie den bevorzugten Abhängigkeitsmanager für PHP (Composer).
  2. Installieren Sie die Dialogflow-Komponente der Google Cloud-Clientbibliotheken:
    composer require google/cloud-dialogflow
  3. Diese Komponente unterstützt sowohl REST über HTTP/1.1 als auch gRPC. Folgen Sie der Anleitung im gRPC-Installationshandbuch, um die Vorteile von gRPC zu nutzen (z. B. Streaming-Methoden).

Python

pip install google-cloud-dialogflow

Ruby

gem install google-cloud-dialogflow