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

​
전제 조건

GCP 툴킷을 구성하기 전에 활성 Google Cloud 연결이 필요합니다. 아직 설정하지 않은 경우 설정 → 연결에서 생성하세요.
연결은 설정 → 연결에서 중앙에서 관리됩니다. 서비스 계정 JSON은 암호화되어 저장됩니다. 에이전트에게는 client_email과 프로젝트만 표시됩니다.

​
에이전트에 툴킷 추가

  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 TablesBigQuery 데이터세트의 테이블을 나열합니다.
Get Table Schema열 이름, 유형, 설명 및 테이블 메타데이터를 검사합니다.
Run Query선택적 드라이런, 매개변수 및 행 제한이 포함된 BigQuery에 SQL 쿼리를 실행합니다.
Insert Rows스트리밍 삽입 API를 사용하여 BigQuery 테이블에 행을 스트리밍 삽입합니다.

​
Cloud Run

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

​
Cloud SQL

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

​
일반

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

​
구성 저장

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