GCP 연결 추가
- 왼쪽 탐색 메뉴에서 설정 → 연결로 이동합니다.
- 클라우드 플랫폼에서 Google Cloud Platform 카드를 클릭합니다.
- + GCP 연결 추가를 클릭합니다.
- 양식을 작성하고 연결 추가를 클릭합니다.
연결 양식
| 필드 | 필수 | 설명 |
|---|---|---|
| 연결 레이블 | 예 | 이 연결의 표시 이름 (예: 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 키를 얻는 방법
- Google Cloud Console → 서비스 계정을 엽니다.
- 서비스 계정을 선택하거나 만들고 필요한 역할을 부여합니다 (예:
BigQuery Data Viewer,Cloud Run Invoker,Cloud SQL Client). - 키 탭을 열고 → 키 추가 → 새 키 만들기 → JSON을 선택합니다.
- 다운로드한 JSON을 서비스 계정 JSON 필드에 붙여넣거나 파일을 직접 업로드합니다.
연결 관리
기존 GCP 연결을 보고, 편집하고, 제거하려면 설정 → 연결로 이동하여 Google Cloud Platform 카드를 클릭합니다. 여기서 추가 연결을 추가하거나 더 이상 필요하지 않은 연결을 삭제할 수 있습니다.에이전트에서 GCP 연결을 사용하려면 에이전트의 도구 모음으로 이동하여 Google Cloud Platform 도구 모음을 추가하고 GCP 연결 선택 드롭다운에서 연결을 선택합니다. 자세한 내용은 Google Cloud Platform 도구 모음을 참조하십시오.