이 문서에서는 에이전트 컨텍스트 파일을 사용하여 Spanner 스튜디오에서 데이터 에이전트를 만드는 방법을 설명합니다. 데이터 에이전트는 단일 에이전트 컨텍스트 파일과 연결됩니다.
데이터 에이전트에 대한 자세한 내용은 데이터 에이전트 개요를 참조하세요.시작하기 전에
에이전트를 만들기 전에 다음 기본 요건을 완료하세요.
필수 서비스 사용 설정
프로젝트에 대해 다음 서비스를 사용 설정합니다.Spanner 인스턴스 준비
- Spanner 인스턴스를 사용할 수 있는지 확인합니다. 자세한 내용은 인스턴스 만들기를 참조하세요.
- 테이블을 만들 인스턴스에서 데이터베이스를 만드는지 확인합니다. 자세한 내용은 Spanner 인스턴스에서 데이터베이스 만들기를 참조하세요.
필수 역할 및 권한
- 클러스터에 IAM 사용자 또는 서비스 계정을 추가합니다. 자세한 내용은 IAM 역할 적용을 참조하세요.
- 프로젝트 수준에서 IAM 사용자에게
spanner.databaseReader역할을 부여합니다. 자세한 내용은 프로젝트에 IAM 정책 바인딩 추가를 참조하세요. - 역할 및 권한을 부여합니다. 필요한 데이터베이스에 대해 프로젝트 수준에서 IAM 사용자에게
데이터 에이전트 만들기
데이터 에이전트를 만들려면 다음 단계를 따르세요.
콘솔에서 Spanner 페이지로 이동합니다. Google Cloud
목록에서 인스턴스를 선택한 후 데이터베이스를 선택합니다.
탐색 메뉴에서 Spanner 스튜디오 를 클릭합니다.
탐색기 창의 데이터 에이전트 옆에 있는 작업 보기를 클릭합니다.
에이전트 만들기 를 클릭합니다.
에이전트 이름에 고유한 에이전트 이름을 입력합니다. 에이전트 이름은 대소문자를 구분하며 문자, 숫자, 하이픈, 밑줄을 포함할 수 있습니다.
선택사항입니다. 에이전트 설명에 에이전트 설명을 추가합니다.
선택사항입니다. 고급 옵션 표시를 클릭하고 위치 선택에서 에이전트 컨텍스트를 저장할 리전을 선택합니다. 지원되는 리전 목록에서 다음을 선택할 수 있습니다.
us-central1us-east1europe-west4asia-southeast1
만들기 를 클릭합니다.
에이전트 컨텍스트 빌드
에이전트를 만든 후 Gemini CLI를 사용하여 컨텍스트 빌드의 단계에 따라 에이전트 컨텍스트 파일을 만듭니다. 그런 다음 에이전트를 수정하여 컨텍스트 파일을 업로드할 수 있습니다.
에이전트 수정
데이터 에이전트를 수정하려면 다음 단계를 따르세요.
콘솔에서 Spanner 페이지로 이동합니다. Google Cloud
목록에서 인스턴스를 선택한 후 데이터베이스를 선택합니다.
탐색 메뉴에서 Spanner 스튜디오 를 클릭합니다.
탐색기 창의 데이터 에이전트 옆에 있는 작업 보기를 클릭합니다.
에이전트 수정 을 클릭합니다.
선택사항: 에이전트 설명 을 수정합니다.
에이전트 컨텍스트 파일 업로드 섹션에서 찾아보기 를 클릭하고 에이전트 컨텍스트 파일을 선택합니다.
저장 을 클릭합니다.
데이터 에이전트 삭제
데이터 에이전트를 삭제하려면 다음 단계를 따르세요.
콘솔에서 Spanner 페이지로 이동합니다. Google Cloud
목록에서 인스턴스를 선택한 후 데이터베이스를 선택합니다.
탐색 메뉴에서 Spanner 스튜디오 를 클릭합니다.
탐색기 창의 데이터 에이전트 옆에 있는 작업 보기를 클릭합니다.
에이전트 삭제 를 클릭합니다.
에이전트 삭제 확인 대화상자에 에이전트 이름을 입력합니다.
확인 을 클릭하여 에이전트를 삭제합니다.
다음 단계
- 데이터 에이전트에 대해 자세히 알아보세요.
- 데이터 에이전트를 검사하고 호출하는 방법을 알아보세요.