Conversational Analytics API 사용 설정

이 페이지에서는 Google Cloud 프로젝트에 대화형 분석 API(geminidataanalytics.googleapis.com을 통해 액세스)를 사용 설정하는 단계를 설명합니다. 대화형 분석 API는 Google Cloud 콘솔의 Gemini 기반 Data Analytics API에 속하는 첫 번째 기능입니다.

시작하기 전에

Conversational Analytics API를 사용하려면 작업하려는 데이터에 액세스할 수 있는 Google Cloud 프로젝트가 있어야 합니다. 프로젝트를 설정하려면 다음 단계를 완료하세요.

  1. 대화형 분석 API와 함께 사용할 데이터를 식별합니다. BigQuery 테이블, Looker Explore, Looker Studio 보고서와 같은 데이터 소스를 사용할 수 있습니다.

  2. Google Cloud 콘솔의 프로젝트 선택기 페이지에서 Conversational Analytics API와 함께 사용하려는 데이터에 액세스할 수 있는 Google Cloud 프로젝트를 만듭니다.

    프로젝트 선택기로 이동

필요한 API 사용 설정

Conversational Analytics API를 사용하려면 Google Cloud 프로젝트에서 필수 API를 사용 설정해야 합니다. Colab Enterprise 환경에서 대화형 분석 API를 사용하려면 추가 API도 사용 설정해야 합니다.

필수 API

콘솔

Conversational Analytics API로 사용할 Google Cloud 프로젝트의 Google Cloud 콘솔에서 다음 API를 사용 설정합니다.

Gemini 데이터 분석 API 사용 설정

Gemini for Google Cloud API 사용 설정

BigQuery API 사용 설정

gcloud

Google Cloud CLI를 사용하여 다음 gcloud services enable 명령어를 실행하여 Gemini Data Analytics API, Gemini for Google Cloud API, BigQuery API를 각각 사용 설정합니다.

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

이전 샘플 gcloud CLI 명령어에서 project_id를 Google Cloud 프로젝트 ID로 바꿉니다.

Colab Enterprise용 API

Colab Enterprise 환경에서 대화형 분석 API를 사용하려면 다음 API도 사용 설정합니다.

Dataform API 사용 설정

Compute Engine API 사용 설정

Vertex AI API 사용 설정

필요한 역할 부여

Conversational Analytics API를 사용하려면 Google Cloud 콘솔에서 다음 Identity and Access Management(IAM) 역할을 API와 상호작용해야 하는 주 구성원(예: 사용자 또는 서비스 계정)에 부여합니다.

역할로 이동

또한 에이전트 관리와 같은 작업에 대한 권한은 Conversational Analytics API IAM 역할 및 권한 부여에 설명된 대로 Gemini 데이터 분석 역할로 제어됩니다.

VPC 서비스 제어 추가 구성

조직 또는 사용 중인 Google Cloud 프로젝트에 VPC 서비스 제어가 사용 설정된 경우 Conversational Analytics API에서 사용하는 다음 API를 허용 목록에 추가합니다.