> ## Documentation Index
> Fetch the complete documentation index at: https://ai-kb.automationanywhere.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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`).                        |

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

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

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

## 연결 관리

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

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