Google Cloud Data Agent Kit를 사용하면 선호하는 IDE 또는 에이전트형 코딩 환경에서 Google Cloud 데이터 리소스를 사용할 수 있습니다. 설정에 따라 IDE 확장 프로그램 또는 플러그인을 설치합니다.
Data Agent Kit는 다음 Google Cloud서비스와 함께 사전 설치되어 제공됩니다.
- Cloud Shell
- Cloud Workstations
시작하기 전에
Data Agent Kit를 설치하기 전에 다음을 수행하세요.
로컬 환경 설정
로컬 머신에 원하는 IDE 또는 코딩 에이전트와 Node.js를 설치합니다.
- IDE, 에이전트 CLI 또는 코딩 에이전트를 설치하고 설정합니다. 이미 설치되어 있다면 최신 버전으로 업데이트합니다.
- Node.js를 설치합니다.
Google Cloud설정
- 아직 프로젝트가 없으면 Google Cloud 프로젝트를 만듭니다.
- 결제 사용 설정
필요한 역할
작업을 완료하는 데 추가 권한이 필요한 경우 Data Agent Kit에서 알림을 보냅니다. 사용하는 서비스에 대한 권한만 있으면 됩니다. 데이터 에이전트 키트의 각 서비스에 필요한 권한 및 API의 전체 목록은 권한을 참고하세요.
확장 프로그램 또는 플러그인 설치
설치 프로세스는 사용하는 IDE 또는 코딩 에이전트에 따라 다릅니다.
VS Code
VS Code에서 Data Agent Kit을 사용하려면 확장 프로그램을 설치하세요.
- IDE에서 확장 프로그램을 클릭하거나
Ctrl/Cmd+Shift+X을 누릅니다. Google Cloud Data Agent Kit을 검색합니다.- 설치를 클릭합니다.
- 메시지가 표시되면 IDE를 다시 시작합니다. 확장 프로그램이 설치되면 Google Cloud 데이터 에이전트 키트 아이콘이 작업 표시줄에 추가됩니다.
Visual Studio Marketplace에서 확장 프로그램을 설치할 수도 있습니다.
Antigravity
사용 중인 Antigravity 도구의 안내를 펼치려면 클릭하세요.
Antigravity IDE를 사용해
Antigravity IDE에서 Data Agent Kit을 사용하려면 확장 프로그램을 설치하세요.
- IDE에서 확장 프로그램을 클릭하거나
Ctrl/Cmd+Shift+X을 누릅니다. Google Cloud Data Agent Kit을 검색합니다.- 설치를 클릭합니다.
- 메시지가 표시되면 IDE를 다시 시작합니다. 확장 프로그램이 설치되면 Google Cloud 데이터 에이전트 키트 아이콘이 작업 표시줄에 추가됩니다.
Antigravity CLI
Antigravity CLI와 함께 Data Agent Kit를 사용하려면 플러그인을 설치하세요. 터미널에서 다음 명령어를 실행합니다.
agy plugin install https://github.com/GoogleCloudPlatform/data-agent-kit-plugin
Antigravity 2.0
Antigravity CLI와 함께 Data Agent Kit를 사용하려면 플러그인을 설치하세요.
- 설정을 클릭합니다.
- 설정 창에서 맞춤설정을 클릭합니다.
- Build with Google Plugins를 찾아 Customize(맞춤설정)를 클릭합니다.
- 목록에서 Google Cloud Data Agent Kit를 찾아 다운로드를 클릭합니다.
VS Code용 Antigravity 확장 프로그램
VS Code용 Antigravity 확장 프로그램을 사용할 때 VS Code에서 Data Agent Kit을 사용하려면 다음 단계를 따르세요.
- VS Code 상태 표시줄에서 Antigravity - Settings를 클릭합니다.
- 설정 창에서 맞춤설정을 클릭합니다.
- Build with Google Plugins를 찾아 Customize(맞춤설정)를 클릭합니다.
- 목록에서 Google Cloud Data Agent Kit를 찾아 다운로드를 클릭합니다.
Claude Code CLI
Claude Code CLI와 함께 Data Agent Kit를 사용하려면 플러그인을 설치하세요. 터미널에서 다음 명령어를 실행합니다.
claude plugin install data-agent-kit-starter-pack@claude-plugins-official
Codex CLI
Codex CLI와 함께 Data Agent Kit를 사용하려면 플러그인을 설치하세요. 터미널에서 다음 명령어를 실행합니다.
codex plugin marketplace add GoogleCloudPlatform/data-agent-kit-plugin
codex plugin add dak@dak-marketplace
커서
Cursor에서 Data Agent Kit를 사용하려면 확장 프로그램을 설치하세요.
- IDE에서 확장 프로그램을 클릭하거나
Ctrl/Cmd+Shift+X을 누릅니다. Google Cloud Data Agent Kit을 검색합니다.- 설치를 클릭합니다.
- 메시지가 표시되면 IDE를 다시 시작합니다. 확장 프로그램이 설치되면 Google Cloud 데이터 에이전트 키트 아이콘이 작업 표시줄에 추가됩니다.
VS Code 기반 IDE
VS Code를 기반으로 하는 다른 모든 IDE에서 Data Agent Kit을 사용하려면 확장 프로그램을 설치하세요.
- IDE에서 확장 프로그램을 클릭하거나
Ctrl/Cmd+Shift+X을 누릅니다. Google Cloud Data Agent Kit을 검색합니다.- 설치를 클릭합니다.
- 메시지가 표시되면 IDE를 다시 시작합니다. 확장 프로그램이 설치되면 Google Cloud 데이터 에이전트 키트 아이콘이 작업 표시줄에 추가됩니다.
Data Agent Kit에 로그인
확장 프로그램 또는 플러그인을 설치한 후 로그인해야 합니다.
확장 프로그램 로그인
IDE 확장 프로그램을 설치한 경우 Google Cloud Data Agent Kit에 인증해야 합니다.
로그인 대화상자가 자동으로 열리지 않으면 IDE 창 하단의 상태 표시줄에서 Google Cloud Data Agent Kit 로그인 링크를 찾아 클릭합니다.
또는
Ctrl/Cmd+Shift+P키를 눌러 명령어 팔레트를 열고 Google Cloud Data Agent Kit: 로그인을 검색하여 선택할 수 있습니다.안내에 따라 로그인을 완료합니다.
인증이 완료되었음을 확인하는 웹페이지가 표시됩니다.
페이지를 닫고 IDE로 돌아갑니다.
플러그인 로그인
Google Cloud CLI를 설치하고 로그인합니다. Data Agent Kit 플러그인은 gcloud CLI 사용자 인증 정보와 애플리케이션 기본 사용자 인증 정보 (ADC)의 사용자 인증 정보를 모두 사용합니다.
- 로컬 머신 또는 IDE에서 터미널을 엽니다.
- 이전에 gcloud CLI를 설치하지 않은 경우 gcloud CLI 설치의 단계에 따라 gcloud CLI를 다운로드하고 설치합니다.
- 터미널에서
gcloud init를 실행하여 gcloud CLI를 초기화합니다.gcloud init
- 다음 명령어를 실행하고 안내에 따라 인증하고 애플리케이션 기본 사용자 인증 정보를 설정합니다.
gcloud auth login && gcloud auth application-default login
- gcloud CLI를 최신 버전으로 업데이트합니다.
gcloud components update
문제 해결
문제가 발생하면 로그아웃한 후 다시 로그인해 보세요. 설치 오류를 진단하고 해결하는 추가 방법을 알아보려면 문제 해결을 참고하세요.