Conversational Analytics API aktivieren

Auf dieser Seite wird beschrieben, wie Sie die Conversational Analytics API (Zugriff über geminidataanalytics.googleapis.com oder regionale Endpunkte) für Ihr Google Cloud Projekt inaktivieren. Die Conversational Analytics API ist die erste Funktion unter der Data Analytics API with Gemini in der Google Cloud Console.

Hinweis

Bevor Sie die Conversational Analytics API verwenden können, benötigen Sie ein Google Cloud Projekt, das auf die Daten zugreifen kann, mit denen Sie arbeiten möchten. Führen Sie die folgenden Schritte aus, um Ihr Projekt einzurichten:

1. Geben Sie die Daten an, die Sie mit der Conversational Analytics API verwenden möchten. Sie können Datenquellen wie BigQuery-Tabellen, Looker-Explores, Data Studio-Berichte und Daten aus AlloyDB for PostgreSQL, GoogleSQL for Spanner, Cloud SQL for MySQL und Cloud SQL for PostgreSQL verwenden.

2. Erstellen Sie in der Google Cloud Console auf der Seite für die Projektauswahl ein Google Cloud Projekt, das auf die Daten zugreifen kann, die Sie mit der Conversational Analytics API verwenden möchten.

   **Hinweis**: Derzeit erfolgt keine Abrechnung für die Conversational Analytics API.

   Zur Projektauswahl

Anforderungen für Looker und Data Studio Pro

Wenn Sie die Conversational Analytics API mit Looker verwenden, muss Ihre Looker-Instanz bestimmte Anforderungen erfüllen:

• Looker (Original)
• Looker (Google Cloud Core)

Wenn Sie die Conversational Analytics API mit Data Studio Pro verwenden möchten, muss sich Ihr Pro-Abo außerhalb eines VPC-SC-Perimeters befinden.

Anforderungen für AlloyDB

Wenn Sie die Conversational Analytics API mit AlloyDB verwenden, muss Ihre AlloyDB-Instanz bestimmte Anforderungen erfüllen. Führen Sie alle Schritte unter Hinweis aus.

Anforderungen für Cloud SQL for MySQL

Wenn Sie die Conversational Analytics API mit Cloud SQL for MySQL verwenden, muss Ihre Cloud SQL-Instanz bestimmte Anforderungen erfüllen. Führen Sie alle Schritte unter Hinweis aus.

Anforderungen für Cloud SQL for PostgreSQL

Wenn Sie die Conversational Analytics API mit Cloud SQL for PostgreSQL verwenden, muss Ihre Cloud SQL-Instanz bestimmte Anforderungen erfüllen. Führen Sie alle Schritte unter Hinweis aus.

Anforderungen für Spanner

Wenn Sie die Conversational Analytics API mit Spanner verwenden, muss Ihre Spanner-Instanz bestimmte Anforderungen erfüllen. Führen Sie alle Schritte unter Hinweis aus.

Erforderliche APIs aktivieren

Wenn Sie die Conversational Analytics API verwenden möchten, müssen Sie eine Reihe von erforderlichen APIs in Ihrem Projekt in Google Cloud aktivieren. Wenn Sie die Conversational Analytics API in einer Colab Enterprise-Umgebung verwenden möchten, müssen Sie auch zusätzliche APIs aktivieren.

Erforderliche APIs

Hinweis: Wenn Sie nicht berechtigt sind, die APIs zu aktivieren, bitten Sie Ihren Projektadministrator, die APIs für Sie über das Dashboard „APIs und Dienste“ zu aktivieren. Alternativ kann Ihr Projektadministrator Ihnen in der Google Cloud Console die Rolle Service Usage Admin (roles/serviceusage.serviceUsageAdmin) zuweisen. Damit können Sie APIs für das aktuelle Projekt aktivieren und deaktivieren.

Console

Aktivieren Sie die folgenden APIs in der Google Cloud Console für das Projekt in Google Cloud , das Sie mit der Conversational Analytics API verwenden.

Gemini Data Analytics API aktivieren

Gemini für Google Cloud API aktivieren

BigQuery API aktivieren

**Tipp**: Wenn Sie eine API aktivieren, müssen Sie die Google Cloud Seite der Console möglicherweise aktualisieren, um zu bestätigen, dass sie aktiviert wurde.

gcloud

Führen Sie mit der Google Cloud CLI die folgenden gcloud services enable-Befehle aus, um die Gemini Data Analytics API, die Gemini for Google Cloud API und die BigQuery API zu aktivieren:

gcloud services enable geminidataanalytics.googleapis.com --project=project_id
gcloud services enable cloudaicompanion.googleapis.com --project=project_id
gcloud services enable bigquery.googleapis.com --project=project_id

Ersetzen Sie in den vorherigen Beispielbefehlen der gcloud CLI project_id durch die Projekt-ID Ihres Projekts in Google Cloud .

**Hinweis**: Aktivieren Sie die BigQuery API nur, wenn Sie BigQuery verwenden.

APIs für Colab Enterprise

Wenn Sie die Conversational Analytics API in einer Colab Enterprise-Umgebung verwenden möchten, aktivieren Sie auch die folgenden APIs:

Dataform API aktivieren

Compute Engine API aktivieren

Vertex AI API aktivieren

Tipp: Wenn Sie eine API aktivieren, müssen Sie die Seite der Google Cloud Console möglicherweise aktualisieren, um zu bestätigen, dass sie aktiviert wurde.

Erforderliche Rollen zuweisen

Wenn Sie die Conversational Analytics API verwenden möchten, benötigen Hauptkonten (z. B. Nutzer oder Dienstkonten) IAM-Rollen (Identity and Access Management), die Zugriff auf die API und die zugrunde liegenden Datenquellen ermöglichen.

So weisen Sie diese Rollen zu: Google Cloud

Zu Rollen

Gemini Data Analytics-Rollen

Damit Hauptkonten Conversational Analytics API-Agenten erstellen und die zustandsorientierte Chatmethode für Unterhaltungen verwenden können, weisen Sie die folgenden IAM-Rollen zu:

• Gemini Data Analytics Data Agent Creator (roles/geminidataanalytics.dataAgentCreator): Erforderlich, um nur in BigQuery, Looker und Data Studio Pro mit dem Erstellen von Agenten zu beginnen.
• Gemini für Google Cloud Nutzer (roles/cloudaicompanion.user): Erforderlich, um die zustandsorientierte Chatmethode für Unterhaltungen zu verwenden.

Außerdem werden Berechtigungen für Aktionen wie das Verwalten von Agenten über Gemini Data Analytics-Rollen gesteuert, wie unter Zugriffssteuerung für die Conversational Analytics API mit IAM beschrieben.

BigQuery-Rollen

Damit Hauptkonten BigQuery-Datenquellen über die Conversational Analytics API abfragen können, weisen Sie die folgenden IAM-Rollen zu:

• BigQuery-Nutzer (roles/bigquery.user): Erforderlich für den Zugriff auf Daten in BigQuery.
• BigQuery Studio-Nutzer (roles/bigquery.studioUser): Erforderlich, wenn Sie BigQuery Studio und Data Canvas verwenden.

Looker-Rollen

Damit Hauptkonten Looker-Datenquellen über die Conversational Analytics API abfragen können, weisen Sie die folgenden IAM-Rollen zu:

• Looker-Instanznutzer (roles/looker.instanceUser): Erforderlich für den Zugriff auf Daten aus einer Looker-Instanz (Google Cloud Core).

Wenn ein Looker-Nutzer die konversationelle Analyse und die Conversational Analytics API verwenden möchte, muss ihm eine Looker-Rolle mit der gemini_in_looker Berechtigung für die Modelle zugewiesen werden, mit denen er interagiert.

Datenbankrollen

Damit Hauptkonten AlloyDB-, Cloud SQL for MySQL-, Cloud SQL for PostgreSQL- oder Spanner-Datenquellen über die Conversational Analytics API abfragen können, weisen Sie die folgenden IAM-Rollen zu:

• AlloyDB Database User (roles/alloydb.databaseUser): Erforderlich für den Zugriff auf Daten aus einer AlloyDB-Instanz.
• Cloud SQL for MySQL- und Cloud SQL for PostgreSQL Studio-Nutzer (roles/cloudsql.studioUser): Erforderlich, um in der Google Cloud Console Cloud SQL for MySQL- und Cloud SQL for PostgreSQL-Instanzen anzusehen und zu verwalten.
• Cloud SQL for MySQL- und Cloud SQL for PostgreSQL-Instanznutzer (roles/cloudsql.instanceUser): Erforderlich, um eine Verbindung zu Cloud SQL for MySQL- und Cloud SQL for PostgreSQL-Instanzen herzustellen.
• Spanner Database Reader (roles/spanner.databaseReader): Erforderlich, um Daten aus einer GoogleSQL for Spanner-Datenbank zu lesen.

Nächste Schritte

• Erfahren Sie mehr über die Zugriffssteuerung für die Conversational Analytics API.
• Erfahren Sie, wie Sie VPC Service Controls für die Conversational Analytics API konfigurieren.

Nächste Schritte

• Erfahren Sie, wie Sie sich bei Ihrer Datenquelle und der API authentifizieren.
• KI-Datenagenten mit dem Python SDK erstellen
• KI-Datenagenten mit HTTP und Python erstellen