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 Projekt inGoogle Cloud aktivieren. 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 CloudProjekt, das auf die Daten zugreifen kann, mit denen Sie arbeiten möchten. So richten Sie Ihr Projekt ein:

  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.

    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:

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.

AlloyDB-Anforderungen

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

Cloud SQL for MySQL-Anforderungen

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 Vorbereitung aus.

Cloud SQL for PostgreSQL-Anforderungen

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 Vorbereitung aus.

Cloud Spanner-Anforderungen

Wenn Sie die Conversational Analytics API mit Spanner verwenden, muss Ihre Spanner-Instanz bestimmte Anforderungen erfüllen. Führen Sie alle Schritte unter Vorbereitung 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

Console

Aktivieren Sie die folgenden APIs für das Projekt inGoogle Cloud , das Sie mit der Conversational Analytics API verwenden, falls sie noch nicht aktiviert sind.

Gemini Data Analytics API aktivieren

Gemini für Google Cloud API aktivieren

BigQuery API aktivieren

gcloud

Führen Sie mit der Google Cloud CLI die folgenden gcloud services enable-Befehle aus, um die Gemini Data Analytics API, die Gemini forGoogle 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 .

APIs für Colab Enterprise

Wenn Sie die Conversational Analytics API in einer Colab Enterprise-Umgebung verwenden möchten, prüfen Sie auch, ob die folgenden APIs aktiviert sind:

Dataform API aktivieren

Compute Engine API aktivieren

Vertex AI API aktivieren

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 über die Google Cloud Console zu:

Zu Rollen

Gemini Data Analytics-Rollen

Wenn Sie Hauptkonten die Möglichkeit geben möchten, Conversational Analytics API-Agents zu erstellen und die Methode für zustandsbehaftete Chats für Unterhaltungen zu verwenden, weisen Sie die folgenden IAM-Rollen zu:

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

BigQuery-Rollen

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

Looker-Rollen

Wenn Sie Hauptkonten ermöglichen möchten, Looker-Datenquellen über die Conversational Analytics API abzufragen, weisen Sie die folgenden IAM-Rollen zu:

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

Datenbankrollen

Damit Principals AlloyDB-, Cloud SQL for MySQL-, Cloud SQL for PostgreSQL- oder Spanner-Datenquellen über die Conversational Analytics API abfragen können, müssen Sie die folgenden IAM-Rollen zuweisen:

Nächste Schritte

Nächste Schritte