> ## 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에 연결합니다.

**Google Cloud Platform(GCP) 툴킷**은 에이전트가 BigQuery, Cloud Run(서비스 및 HTTP 트리거 함수) 및 Cloud SQL과 상호작용할 수 있게 합니다. 인증은 연결로 저장된 서비스 계정 JSON 키를 통해 처리됩니다 — 에이전트는 서비스 계정으로 작동하고 그 IAM 역할을 상속합니다.

## 전제 조건

GCP 툴킷을 구성하기 전에 활성 Google Cloud 연결이 필요합니다. 아직 설정하지 않은 경우 **설정 → 연결**에서 생성하세요.

<Info>
  연결은 설정 → 연결에서 중앙에서 관리됩니다. 서비스 계정 JSON은 암호화되어 저장됩니다. 에이전트에게는 `client_email`과 프로젝트만 표시됩니다.
</Info>

## 에이전트에 툴킷 추가

1. 에이전트를 열고 **툴킷**으로 이동합니다.
2. **Google Cloud Platform**을 찾고 **에이전트에 추가**를 클릭합니다.
3. **구성**을 클릭하여 구성 패널을 엽니다.

## 구성

### 연결

**GCP 연결 선택** 드롭다운을 사용하여 에이전트가 사용할 서비스 계정 연결을 선택합니다. 연결을 관리하거나 생성하려면 오른쪽 상단의 **연결 관리**를 클릭합니다.

### Google Cloud 통합 정보

툴킷을 구성할 때 다음을 염두에 두세요:

* 에이전트는 서비스 계정의 IAM 역할을 상속합니다 — 필요한 역할만 부여하세요 (예: `BigQuery Data Viewer`, `Cloud Run Invoker`, `Cloud SQL Client`).
* Cloud Run / Cloud Functions 호출은 서비스 계정이 서명한 OIDC ID 토큰을 사용합니다. 서비스가 프라이빗인 경우 `roles/run.Invoker`를 서비스 계정으로 제한하세요.
* 아래에서 활성화한 도구만 에이전트에서 사용 가능합니다.

## 도구 선택

**모두 선택** 또는 **모두 선택 해제**를 사용하여 도구를 일괄 관리하거나 개별적으로 활성화할 수 있습니다. 도구별 **확인 필요**를 토글하여 에이전트가 해당 작업을 실행하기 전에 사용자에게 확인을 요청할 수도 있습니다.

4개 카테고리에서 총 13개의 도구를 사용할 수 있습니다.

### BigQuery

| 도구                   | 설명                                                  |
| -------------------- | --------------------------------------------------- |
| **List Datasets**    | 연결된 서비스 계정이 접근할 수 있는 BigQuery 데이터세트를 나열합니다.         |
| **List Tables**      | BigQuery 데이터세트의 테이블을 나열합니다.                         |
| **Get Table Schema** | 열 이름, 유형, 설명 및 테이블 메타데이터를 검사합니다.                    |
| **Run Query**        | 선택적 드라이런, 매개변수 및 행 제한이 포함된 BigQuery에 SQL 쿼리를 실행합니다. |
| **Insert Rows**      | 스트리밍 삽입 API를 사용하여 BigQuery 테이블에 행을 스트리밍 삽입합니다.      |

### Cloud Run

| 도구                  | 설명                                                                 |
| ------------------- | ------------------------------------------------------------------ |
| **List Services**   | 리전의 Cloud Run 서비스(Gen 2)를 나열합니다.                                   |
| **Get Service**     | URL과 이미지를 포함한 Cloud Run 서비스 정의를 가져옵니다.                             |
| **Invoke Service**  | 서비스 계정이 서명한 OIDC ID 토큰으로 Cloud Run 서비스의 HTTP 엔드포인트를 호출합니다.         |
| **Invoke Function** | OIDC ID 토큰으로 HTTP 트리거 Cloud Run / Cloud Functions Gen 2 함수를 호출합니다. |

### Cloud SQL

| 도구                 | 설명                                                        |
| ------------------ | --------------------------------------------------------- |
| **List Instances** | 프로젝트의 Cloud SQL 인스턴스(Postgres, MySQL, SQL Server)를 나열합니다. |
| **Get Instance**   | 특정 Cloud SQL 인스턴스의 메타데이터(엔진, IP, 버전)를 가져옵니다.              |
| **Execute Query**  | Python 커넥터를 통해 Cloud SQL 인스턴스에 SQL 쿼리를 실행합니다.             |

### 일반

| 도구                  | 설명                                                                    |
| ------------------- | --------------------------------------------------------------------- |
| **Custom API Call** | 모든 Google Cloud REST API에 인증된 요청을 합니다. 필요한 작업에 대한 전용 도구가 없는 경우 사용합니다. |

## 구성 저장

**저장**을 클릭하여 구성을 적용하거나, **기본값으로 설정**을 클릭하여 이 구성을 새 에이전트의 기본값으로 만듭니다. 에이전트에서 툴킷을 완전히 제거하려면 **툴킷 제거**를 클릭합니다.