Einrichten und bereinigen

In dieser Anleitung werden alle erforderlichen Einrichtungsschritte für die Verwendung von Konversations-Agents (Dialogflow CX) erläutert. Er enthält auch Hinweise zu möglichen Bereinigungsschritten. nachdem Sie Conversational Agents (Dialogflow CX) ausprobiert oder getestet haben.

Hinweise

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

1. Grundlagen von Abläufen
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.

Hinweis: Mit den folgenden Schritten wird ein Projekt mithilfe der Google Cloud Console erstellt. Die Dialogflow CX-Konsole (Dokumentation ansehen, Konsole öffnen) kann optional ein Projekt für Sie erstellen.

Warnung: Wenn ein Projekt gelöscht wird, die Agents für Konversations-Agents (Dialogflow CX) die mit dem Projekt verknüpft sind, können nicht wiederhergestellt werden.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Go to project selector

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.

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.

Enable the Dialogflow API.

Enable the API

Wenn Sie die generativen Funktionen von Vertex AI-Agents verwenden möchten, müssen Sie auch den Vertex AI Agent Builder-Dienst aktivieren.

Installieren und initialisieren Sie die Google Cloud CLI.

Hinweis: Wenn Sie die API nicht verwenden, können Sie diesen Schritt überspringen.

Wenn Sie die Dialogflow API verwenden möchten, müssen Sie die Google Cloud CLI installieren und initialisieren. Die gcloud CLI umfasst mehrere Tools, mit denen Sie auf Google Cloud gehostete Ressourcen und Anwendungen verwalten können.

Unter folgendem Link finden Sie eine Anleitung:

Install the Google Cloud CLI, then initialize it by running the following command:

gcloud init

Authentifizierung und Zugriffssteuerung einrichten

Hinweis: Wenn Sie die API nicht verwenden, können Sie diesen Schritt überspringen.

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.

Mit Nutzerkonten authentifizieren

Nutzerkonten sind die beste Authentifizierungsoption, wenn Sie die Dialogflow API oder die lokale Entwicklung verwenden. Sie können Ihr Nutzerkonto für die Authentifizierung der Ausführung über REST-Befehlszeilen oder Clientbibliotheken verwenden.

Authentifizierung von Nutzerkonten über die REST-Befehlszeile

Hinweis: Wenn Sie Cloud Shell verwenden, werden Sie automatisch in gcloud angemeldet. Sie müssen gcloud auth login also nicht ausführen.

Zur Authentifizierung für REST-Befehlszeilenaufrufe verwenden Sie die gcloud CLI. Mit dem Befehl gcloud auth login werden Sie mit Ihrem Nutzerkonto in gcloud angemeldet. Dies sollte vor dem Aufrufen der API erfolgen. Der Befehl gcloud auth print-access-token wird in allen Dokumentationen der REST-Befehlszeilen in dieser Dokumentation verwendet, um REST-Aufrufe zu authentifizieren.

So erstellen Sie Nutzeranmeldedaten für Ihre lokale Umgebung:

gcloud auth login

Authentifizierung des Nutzerkontos in der Clientbibliothek

Zur Authentifizierung bei Aufrufen der Clientbibliothek verwenden Sie die gcloud CLI. Mit dem Befehl gcloud auth application-default login werden Sie mit dem Nutzerkonto bei gcloud zur Standardanmeldedaten für Anwendungen angemeldet. Diese sollte vor dem Aufruf der API erfolgen. Mit dem Befehl gcloud auth application-default set-quota-project können Sie Ihr Projekt für die Abrechnung und die Kontingente im Zusammenhang mit API-Aufrufen festlegen. Normalerweise ist dies dasselbe Projekt, das von Ihrem Agent verwendet wird. Sie geben die Projekt-ID des Projekts an, das Sie in den Schritten oben erstellt haben.

Die Umgebungsvariable GOOGLE_APPLICATION_CREDENTIALS darf nicht festgelegt werden, damit die Standardanmeldedaten für Anwendungen von Clientbibliotheken verwendet werden können.

So erstellen Sie Standardanmeldedaten für Anwendungen für Ihre lokale Umgebung:

gcloud auth application-default login
gcloud auth application-default set-quota-project PROJECT_ID

Authentifizierung bei Dienstkonten

Dienstkonten sind eine weitere Authentifizierungsoption, die nur in sicheren Umgebungen wie Produktion oder Staging verwendet werden sollten. 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:

• Übersicht über das Dienstkonto
• Best Practices für Dienstkonten
• Dienstkonten erstellen und verwalten
• Dienstkontoschlüssel erstellen und verwalten
• Mit Dienstkontoschlüsseln authentifizieren

Zugriffssteuerung mit Rollen

Wenn ein Hauptkonto (Nutzerkonto, Dienstkonto usw.) eine API aufruft, erfordert Google Cloud, dass das Hauptkonto die entsprechenden Berechtigungen hat. Sie können Berechtigungen gewähren, indem Sie einem Hauptkonto Rollen zuweisen. Weitere Informationen finden Sie in der Rollenübersicht.

Wenn Sie Ihr Projekt mit Ihrem Nutzerkonto erstellt haben, hat Ihr Nutzerkonto die einfache Rolle "Inhaber" für das Projekt. Diese Rolle ermöglicht das Aufrufen einer beliebigen API für das Projekt. Wenn das Projekt jedoch von einem anderen Konto erstellt wurde, müssen Ihrem Nutzerkonto möglicherweise Rollen zugewiesen werden, bevor Sie die API aufrufen können. Eine Anleitung finden Sie in der Anleitung zur Zugriffssteuerung in Dialogflow.

Clientbibliothek für Conversational Agents (Dialogflow CX) installieren

Hinweis: Wenn Sie die API nicht verwenden, können Sie diesen Schritt überspringen.

Sie haben drei Möglichkeiten, die API aufzurufen: Über von Google unterstützte Clientbibliotheken, REST und gRPC.

Clientbibliotheken sind für mehrere gängige Sprachen verfügbar. Installationsanleitungen findest du in der von dir gewünschten Sprache unter Clientbibliotheken.

Bereinigen

Nach der Einrichtung und dem Ausprobieren oder Testen von Dialogflow können Sie die von Ihnen erstellten Ressourcen löschen:

• Sie können Ihren Agenten löschen.
• Sie können Ihr Projekt herunterfahren.
• Wenn Sie gcloud auth login aufgerufen haben, werden die Anmeldedaten in Ihrem Nutzerverzeichnis auf dem Computer gespeichert. Sie können diese Anmeldedaten mit dem folgenden Befehl löschen:

  gcloud auth revoke

• Wenn Sie gcloud auth application-default login aufgerufen haben, werden die Anmeldedaten in Ihrem Nutzerverzeichnis auf dem Computer gespeichert. Sie können diese Anmeldedaten mit dem folgenden Befehl löschen:

  gcloud auth application-default revoke