Earth Engine 코드 편집기의 질문 패널은 Gemini를 사용하여 스크립트 작성, 이해, 디버깅, 최적화를 지원합니다. 지리 공간 분석 및 스크립트 개발을 간소화하기 위해 코드 편집기에 직접 통합된 대화형 AI 어시스턴트 역할을 합니다.
인터페이스 및 도구
AI 어시스턴트 패널은 Earth Engine 코드 편집기의 오른쪽 창에 있습니다. 이 탭을 열려면 인스펙터, 콘솔, 작업 탭 옆에 있는 질문하기 탭을 클릭합니다.
'질문' 창에는 AI와의 상호작용을 관리하는 데 도움이 되는 여러 컨트롤과 도구가 포함되어 있습니다.
버튼 및 컨트롤
- 보내기 / 중지: 프롬프트를 어시스턴트에게 보냅니다. 생성이 진행되는 동안 버튼이 중지 아이콘으로 전환되어 요청을 취소할 수 있습니다.
enter/return키를 사용하여 전송할 수도 있습니다. - 새 채팅: 대화 기록을 지우고 새 세션을 시작합니다.
- 도움말: 기능, 결제, 약관에 관한 정보가 포함된 대화상자가 열립니다.
- 모델 선택: 사용할 Gemini 모델을 선택할 수 있는 드롭다운 메뉴입니다. API 키의 등급에 따라 일부 모델이 작동하지 않을 수 있습니다. 선택한 내용은 다음 세션에 사용되도록 저장됩니다.
- 도구 전환 버튼: 어시스턴트가 사용할 특정 도구를 사용 설정 또는 중지할 수 있는 메뉴입니다. 선택한 내용은 다음 세션에 사용되도록 저장됩니다.
- 복사 (코드 블록): 생성된 코드를 클립보드에 복사합니다.
- 삽입 (코드 블록): 생성된 코드를 스크립트 편집기에 삽입합니다. 편집기가 비어 있지 않으면 검토할 변경사항을 강조 표시하는 차이 대화상자가 표시됩니다.
- 재생성: 프롬프트를 다시 실행하기 위한 재시도 버튼이 마지막 대답 하단에 표시됩니다.
- 토큰 카운터: 현재 대화 세션에서 사용된 토큰 수를 표시합니다. 이를 사용하여 API 키 한도에 대한 사용량을 모니터링합니다.
도구 옵션
다음 도구를 사용 설정하여 어시스턴트의 대답을 개선할 수 있습니다. 도구를 사용 설정하면 요청에 추가 컨텍스트 (예: 문서 또는 검색 결과)가 추가되어 토큰 사용량이 늘어날 수 있습니다.
- Docs: Earth Engine 공개 문서를 검색하여 정확한 코드와 설명을 제공합니다.
- 데이터 세트 검색: Earth Engine 데이터 카탈로그에서 데이터 세트를 검색합니다.
- Google 검색: Google 검색 결과에서 대답을 그라운딩하여 웹의 최신 정보를 제공합니다. Google 검색 도구는 Docs 또는 데이터 세트 검색 도구와 동시에 사용할 수 없습니다. Google 검색을 사용 설정하면 UI에서 다른 도구를 자동으로 사용할 수 없게 됩니다.
기본 요건
모델에 요청을 보내기 위해 이 기능은 자체 Gemini API 키를 사용합니다.
Gemini API 키를 받는 방법
Google AI Studio의 Cloud 프로젝트에서 Gemini API 키를 만들거나 볼 수 있습니다.
- Google AI Studio API 키로 이동합니다.
- API 키 만들기를 클릭하고 키를 만드는 옵션을 선택합니다.
Gemini API 키에 대한 자세한 내용은 Gemini API 키 문서를 참고하세요.
코드 편집기에서 API 키 구성
API 키를 받으면 코드 편집기에 추가해야 합니다.
- '질문' 패널의 채팅 입력 상자에서 키 아이콘을 클릭합니다.
- 표시되는 대화상자에 API 키를 붙여넣습니다.
- 원하는 경우 체크박스를 선택하여 향후 세션에 사용할 키를 저장하고 확인을 클릭합니다.
자동 컨텍스트
관련 도움말을 제공하기 위해 질문하기 기능은 모든 요청에 다음 컨텍스트를 자동으로 포함합니다.
- 편집기에 있는 현재 스크립트의 전체 텍스트입니다.
- 가져온 애셋 및 지오메트리
- 현재 세션의 채팅 기록입니다.
콘솔 오류 문제 해결
AI 어시스턴트는 코드 편집기의 콘솔과 직접 통합되어 런타임 오류를 빠르게 해결할 수 있습니다.
- 스크립트에 오류가 발생하면 콘솔 탭에서 빨간색 오류 카드를 찾습니다.
- 오류 카드에서 문제 해결 버튼을 클릭합니다.
- 이렇게 하면 '질문하기' 패널이 자동으로 열리고 오류 메시지와 스크립트의 관련 컨텍스트가 포함된 자동 생성 프롬프트 메시지가 전송 대기열에 추가됩니다.
프롬프트 예시
채팅 상자에 직접 입력하여 어시스턴트에게 다양한 작업을 요청할 수 있습니다. 다음은 작업별로 분류된 질문의 예입니다.
코드 생성 및 워크플로
- '2023년 동아프리카의 Sentinel-2 이미지를 로드하고, 구름 덮개 10% 미만으로 필터링하고, 중간 NDVI를 계산하고, 흰색에서 녹색으로 시각화 팔레트를 사용하여 지도에 추가하는 스크립트를 작성해 줘.'
- '2024년 여름 중부 유럽의 구름 없는 Landsat 9 컴포짓을 만들어 내 Cloud Storage 버킷으로 내보내 줘.'
Earth Engine 앱
- '2020년과 2024년의 이미지를 나란히 비교하는 Earth Engine 앱 분할 패널 지도를 만드는 코드를 작성해 줘.'
- '왼쪽에 드롭다운 메뉴가 있는 패널을 추가하여 연도를 선택하고 지도를 새로고침하는 버튼을 추가해 줘.'
- '표시된 토지 피복 분류에 맞춤 범례를 지도에 추가해 줘.'
디버깅
- '사용자 메모리 한도가 초과되었습니다' 오류가 표시됩니다. 이 문제를 해결하려면 어떻게 해야 하나요?'
- '지도에 픽셀 값의 차이가 없는 레이어가 표시됩니다. 예상한 결과가 아닙니다. 무엇이 잘못된 것인가요?'
- '이 계산을 실행할 때 'Image.select: Band 'NDVI' not found' 오류가 표시되는 이유는 무엇인가요?'
설명
- '스크립트의 15번째 줄에서
ee.Reducer.mean().combine()이(가) 하는 일을 설명해 줘.' - '
ee.Image.clip()과ee.Image.mask()의 차이점은 무엇인가요?'
최적화
- '이 이미지 컬렉션 맵 작업을 더 효율적으로 실행하도록 최적화해 줘.'
- '시간 초과를 방지하기 위해 여러 다각형과 이미지에 걸쳐 이
reduceRegions작업을 다시 작성하려면 어떻게 해야 하나요?'
청구 및 비용
이 기능을 사용하려면 자체 Gemini API 키가 필요합니다. 비용은 Gemini API 가격 책정 및 키의 할당량 등급에 따라 달라집니다.
- 무료 등급: Gemini API는 무료 등급 (한도 있음)을 제공합니다.
- 유료 등급: 유료 등급 API 키를 사용하는 경우 특정 Earth Engine 프로젝트 등록과 관계없이 요금이 청구됩니다.
자세한 내용은 Gemini API 가격 책정을 참고하세요.
사용량 모니터링 및 비용 관리
AI Studio에서 직접 키를 관리하고 사용량과 비용을 확인할 수 있습니다.
- AI Studio 인터페이스에서 API 키의 등급, 사용량, 한도, 지출을 확인합니다.
- AI Studio의 지출 탭에서 월 지출 한도를 설정합니다.
데이터 및 개인 정보 보호
사용자의 데이터는 Gemini API 서비스 약관에 따라 처리됩니다. 프롬프트 및 생성된 콘텐츠 사용에 관한 내용을 검토하세요.
의견 보내기
서비스 개선에 동참하기 코드 편집기의 오른쪽 상단에 있는 의견 버튼을 클릭하여 언제든지 의견을 공유할 수 있습니다. 코드 편집기 의견 보내기 옵션을 사용합니다. Google은 모델 성능을 개선하고 기능의 우선순위를 정하기 위해 이 의견을 적극적으로 읽습니다.