설정 및 구성

이 문서에서는 Visual Studio Code용 Google Cloud 데이터 에이전트 키트 확장 프로그램을 설치한 후 초기 설정을 구성하는 방법을 설명합니다.

시작하기 전에

시작하기 전에 확장 프로그램 설치의 단계를 완료하세요.

Google Cloud 프로젝트 및 리전 구성

프로젝트와 리전을 구성하지 않은 경우 다음 단계를 따르세요.

  1. Data Cloud 설정 편집기를 열려면 활동 표시줄에서 Google Cloud 데이터 에이전트 키트 아이콘을 클릭합니다.
  2. 설정을 펼친 다음 설정을 클릭합니다.
  3. Common(일반)을 선택합니다.
  4. 프로젝트 ID와 리전을 선택합니다. 프로젝트 ID는 gcloud CLI에서 지정한 프로젝트 ID와 일치해야 합니다.
  5. 저장을 클릭합니다.

필요한 역할 검토

  1. Data Cloud 설정 편집기를 열려면 활동 표시줄에서 Google Cloud 데이터 에이전트 키트 아이콘을 클릭합니다.
  2. 설정을 펼친 다음 설정을 클릭합니다.

  3. Common > Required Permissions로 이동합니다.

    액세스 열은 필수 역할의 주 구성원인지 여부를 나타냅니다.

  4. VS Code용 데이터 에이전트 키트 확장 프로그램을 사용하는 데 필요한 권한이 누락된 경우 관리자에게 프로젝트에 대한 해당 Identity and Access Management (IAM) 역할을 부여해 달라고 요청하세요. 역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참고하세요.

BigQuery 리전 구성

  1. Data Cloud 설정 편집기를 열려면 활동 표시줄에서 Google Cloud 데이터 에이전트 키트 아이콘을 클릭합니다.
  2. 설정을 펼친 다음 설정을 클릭합니다.
  3. BigQuery를 선택합니다.
  4. BigQuery 리전을 선택합니다.
  5. 저장을 클릭합니다.

Apache Spark용 서버리스 런타임 보기

  1. Data Cloud 설정 편집기를 열려면 활동 표시줄에서 Google Cloud 데이터 에이전트 키트 아이콘을 클릭합니다.
  2. 설정을 펼친 다음 설정을 클릭합니다.
  3. Apache Spark을 선택합니다. 프로젝트의 모든 서버리스 런타임이 표시됩니다.
  4. 서버리스 런타임 구성을 보려면 이름을 클릭합니다.

Apache Spark용 서버리스 런타임 만들기

  1. Data Cloud 설정 편집기를 열려면 활동 표시줄에서 Google Cloud 데이터 에이전트 키트 아이콘을 클릭합니다.
  2. 설정을 펼친 다음 설정을 클릭합니다.
  3. Apache Spark을 선택합니다.
  4. 만들기를 클릭합니다.
  5. 필드를 작성한 후 저장을 클릭합니다.

Apache Spark용 서버리스 런타임 삭제

  1. Data Cloud 설정 편집기를 열려면 활동 표시줄에서 Google Cloud 데이터 에이전트 키트 아이콘을 클릭합니다.
  2. 설정을 펼친 다음 설정을 클릭합니다.
  3. Apache Spark을 선택합니다.
  4. 삭제할 서버리스 런타임에서 작업을 클릭한 다음 삭제를 클릭합니다.

스케줄러 설정

  1. Google Cloud 데이터 에이전트 키트 설정 편집기를 열려면 활동 표시줄에서 Google Cloud 데이터 에이전트 키트 아이콘을 클릭합니다.
  2. 설정을 펼친 다음 설정을 클릭합니다.
  3. 스케줄러를 클릭합니다.
  4. 프로젝트와 리전을 선택합니다. 프로젝트와 리전은 '일반' 탭에서 선택한 프로젝트 및 리전과 일치하지 않아도 됩니다.
  5. 워크플로를 설정할 Managed Service for Apache Airflow 환경을 선택합니다.
  6. 저장을 클릭합니다.

상담사 기술 검토

VS Code용 데이터 에이전트 키트 확장 프로그램에는 워크플로에서 사용할 수 있는 에이전트 기술이 함께 제공됩니다.

  1. Data Cloud 설정 편집기를 열려면 활동 표시줄에서 Google Cloud 데이터 에이전트 키트 아이콘을 클릭합니다.
  2. 설정을 펼친 다음 설정을 클릭합니다.
  3. 기술을 클릭합니다.
  4. 스킬을 정의하는 마크다운을 읽으려면 스킬 제목을 클릭합니다.

종속 항목 설치

일부 Google Cloud 데이터 에이전트 키트 작업에서는 확장 프로그램을 설치한 후 추가 소프트웨어를 설치해야 합니다. 경우에 따라 자동 설치에 동의하라는 메시지가 표시됩니다. 다른 경우에는 소프트웨어를 수동으로 설치해야 합니다.

오케스트레이션 파이프라인

IDE에서 오케스트레이션 파이프라인을 사용하려면 다음을 설치하세요.

Notebooks

다음이 필요한 작업을 시도하면 IDE에서 동의를 요청한 후 소프트웨어를 설치합니다.

  • BigQuery DataFrames (버전 2.36 이상)
  • Anywidget
  • BigQuery ML

에이전트가 노트북에서 코드 셀을 실행하도록 허용하려면 IDE 설정에서 google.datacloud.executeCellToolForNotebookMCP 설정을 사용 설정하면 됩니다. 이 설정은 노트북 모델 컨텍스트 프로토콜 (MCP)에 대해 execute_cell 도구를 사용 설정합니다.

문제 해결

문제가 발생하면 Google Cloud Data Agent Kit 및 gcloud CLI에서 로그아웃한 후 다시 로그인해 보세요. 구성 오류를 진단하고 해결하는 추가 방법을 알아보려면 VS Code용 데이터 에이전트 키 확장 프로그램 문제 해결을 참고하세요.

문제 신고

문제를 신고하려면 다음 단계를 따르세요.

  1. 작업 표시줄의 Google Cloud Data Agent Kit 메뉴에서 버그 신고를 클릭합니다.
  2. 열리는 양식에 문제를 기록하고 제출을 클릭합니다.

다음 단계