Google Cloud Platform 툴킷

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

​

전제 조건

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

​

에이전트에 툴킷 추가

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

​

Cloud Run

​

Cloud SQL

​

일반

​

구성 저장

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