이 페이지에서는 Google Cloud Data Agent Kit를 사용할 때 Google Cloud 데이터 리소스를 참조하는 방법을 설명합니다. 사용하는 환경과 코딩 에이전트에 따라 명시적 또는 암시적 참조를 사용하여 개발 환경이나 지원되는 코딩 에이전트에서 리소스를 참조할 수 있습니다.
- 명시적 참조 채팅 또는 사용자 인터페이스에서
@RESOURCE_NAME를 입력하거나, 모델 컨텍스트 프로토콜 (MCP) 리소스 메뉴에서 리소스를 선택하거나, 드래그 앤 드롭을 사용하는 등 리소스를 명시적으로 식별합니다. - 암시적 참조 채팅에서 자연어 컨텍스트를 통해 리소스를 참조합니다(예: 열려 있거나 선택된 리소스를 참조하는
"this table"또는"this dataset"입력).
참조 메서드
개발 환경과 코딩 에이전트가 참조를 지원하는 경우 다음과 같은 방법으로 데이터 리소스를 참조할 수 있습니다.
- 채팅 멘션: 지원되는 채팅 인터페이스에서
@를 입력한 다음 리소스 이름 또는 ID (예:@DATASET_NAME)를 입력하여 리소스 컨텍스트를 프롬프트에 명시적으로 첨부합니다. - MCP 리소스 메뉴: IDE의 모델 컨텍스트 프로토콜 (MCP) 리소스 선택기에서 리소스를 직접 선택합니다.
- 드래그 앤 드롭: 탐색기 트리에서 데이터 애셋을 채팅 또는 편집기 창으로 바로 드래그합니다.
- 자연어 참조: 암시적 참조를 지원하는 환경에서는
"this table"또는"this dataset"와 같은 문맥적 문구를 사용하여 에이전트가 활성 리소스를 자동으로 추론하도록 합니다.
다음 표에서는 각 개발 환경 및 코딩 에이전트에서 지원되는 참조 방법을 설명합니다.
| 개발 환경 또는 에이전트 | 채팅 멘션 (@) | MCP 리소스 메뉴 | 드래그 앤 드롭 | 자연어 |
|---|---|---|---|---|
| VS Code (GitHub Copilot), Cursor, Antigravity IDE | 지원됨 | 지원됨 | 지원됨 | 지원됨 |
| Claude Code CLI (독립형) | 지원됨 | 지원되지 않음 | 지원되지 않음 | 지원됨 |
| Antigravity 2.0, Antigravity CLI, Claude Code (VS Code 확장 프로그램) | 지원되지 않음 | 지원되지 않음 | 지원되지 않음 | 지원됨 |
지원되는 리소스
다음 표에서는 서비스 전반에서 지원되는 Google Cloud 리소스의 참조 구문과 자연어 문구를 설명합니다.
|
|||
| 서비스 | 리소스 | 채팅 멘션 구문 (@) | 자연어 참조 |
|---|---|---|---|
| BigQuery | 데이터 세트1 | @DATASET_NAME |
"this dataset" |
| 테이블 | @TABLE_NAME |
"this table" |
|
| 보기 | @VIEW_NAME |
"this view" |
|
| PostgreSQL용 AlloyDB, Cloud SQL, Spanner | 테이블 | @TABLE_NAME |
"this table" |
| 보기 | @VIEW_NAME |
"this view" |
|
| Spark | 클러스터 | @CLUSTER_NAME |
"this cluster" |
| 서버리스 런타임 | @RUNTIME_NAME |
"this runtime" |
|
| 작업 | @JOB_NAME |
"this job" |
|
| 대화형 세션2 | @SESSION_NAME |
"this session" |
|
| Batch3 | @BATCH_NAME |
지원되지 않음 | |