Google Cloud Platform 연결

BigQuery, Cloud Run, Cloud SQL 접근을 위한 GCP 서비스 계정을 연결합니다.

Google Cloud Platform 연결을 통해 에이전트가 서비스 계정 JSON 키를 사용하여 GCP 서비스에 인증할 수 있습니다. 연결되면 에이전트는 서비스 계정에 부여된 IAM 역할을 기반으로 BigQuery, Cloud Run, Cloud SQL에 접근할 수 있습니다.

​

GCP 연결 추가

1. 왼쪽 탐색 메뉴에서 설정 → 연결로 이동합니다.
2. 클라우드 플랫폼에서 Google Cloud Platform 카드를 클릭합니다.
3. + GCP 연결 추가를 클릭합니다.
4. 양식을 작성하고 연결 추가를 클릭합니다.

​

연결 양식

필드	필수	설명
연결 레이블	예	이 연결의 표시 이름 (예: Production GCP).
서비스 계정 JSON	예	서비스 계정 JSON 키의 내용을 붙여넣거나 .json 파일 업로드를 클릭하여 직접 업로드합니다.
GCP 프로젝트 ID	아니오	GCP 프로젝트 ID입니다. 비워두면 서비스 계정 JSON의 project_id가 기본값으로 사용됩니다.
기본 리전	아니오	Cloud Run 및 Cloud SQL 작업의 기본 리전 (예: us-central1).
BigQuery 위치	아니오	BigQuery 데이터세트/작업 위치 (예: US, EU).

자격 증명은 저장 전에 Google IAM에 대해 테스트되며, 키는 통합 테이블에 암호화되어 저장됩니다. 에이전트에게는 client_email과 프로젝트만 노출됩니다.

​

서비스 계정 JSON 키를 얻는 방법

1. Google Cloud Console → 서비스 계정을 엽니다.
2. 서비스 계정을 선택하거나 만들고 필요한 역할을 부여합니다 (예: BigQuery Data Viewer, Cloud Run Invoker, Cloud SQL Client).
3. 키 탭을 열고 → 키 추가 → 새 키 만들기 → JSON을 선택합니다.
4. 다운로드한 JSON을 서비스 계정 JSON 필드에 붙여넣거나 파일을 직접 업로드합니다.

​

연결 관리

기존 GCP 연결을 보고, 편집하고, 제거하려면 설정 → 연결로 이동하여 Google Cloud Platform 카드를 클릭합니다. 여기서 추가 연결을 추가하거나 더 이상 필요하지 않은 연결을 삭제할 수 있습니다.

에이전트에서 GCP 연결을 사용하려면 에이전트의 도구 모음으로 이동하여 Google Cloud Platform 도구 모음을 추가하고 GCP 연결 선택 드롭다운에서 연결을 선택합니다. 자세한 내용은 Google Cloud Platform 도구 모음을 참조하십시오.