Earth Engine 코드 편집기의 'Ask' 패널은 Gemini를 사용하여 스크립트 작성, 이해, 디버깅, 최적화를 지원합니다. 코드 편집기에 직접 통합된 대화형 AI 어시스턴트 역할을 하여 지리공간 분석 및 스크립트 개발을 간소화합니다.
인터페이스 및 도구
AI 어시스턴트 패널은 Earth Engine 코드 편집기의 오른쪽 창에 있습니다. 이 패널을 열려면 Inspector, Console, 및 Tasks 탭 옆에 있는 Ask 탭을 클릭합니다.
'Ask' 창에는 AI와의 상호작용을 관리하는 데 도움이 되는 여러 컨트롤과 도구가 포함되어 있습니다.
버튼 및 컨트롤
- 보내기 / 중지: 어시스턴트에 프롬프트를 보냅니다. 생성이 진행되는 동안 버튼이 중지 아이콘으로 전환되어 요청을 취소할 수 있습니다.
enter/return키를 사용하여 보낼 수도 있습니다. - 새로운 채팅: 대화 기록을 지우고 새 세션을 시작합니다.
- 도움말: 기능, 청구, 약관에 관한 정보가 포함된 대화상자를 엽니다.
- 모델 선택: 사용할 Gemini 모델을 선택할 수 있는 드롭다운 메뉴입니다. 일부 모델은 API 키의 등급에 따라 작동하지 않을 수 있습니다. 선택사항은 다음 세션에 저장됩니다.
- 도구 전환: 어시스턴트가 사용할 특정 도구를 사용 설정 또는 중지할 수 있는 메뉴입니다. 선택사항은 다음 세션에 저장됩니다.
- Copy (code blocks): 생성된 코드를 클립보드에 복사합니다.
- Insert (code blocks): 생성된 코드를 스크립트 편집기에 삽입합니다. 편집기가 비어 있지 않으면 검토를 위해 변경사항을 강조 표시하는 차이점 대화상자가 표시됩니다.
- 다시 생성: 프롬프트를 다시 실행하기 위해 마지막 응답 하단에 재시도 버튼이 표시됩니다.
- 토큰 카운터: 현재 대화 세션에서 사용된 토큰 수를 표시합니다. 이를 사용하여 API 키 한도에 대한 사용량을 모니터링합니다.
도구 옵션
다음 도구를 사용 설정하여 어시스턴트의 응답을 개선할 수 있습니다. 도구를 사용 설정하면 요청에 문서 또는 검색 결과와 같은 추가 컨텍스트가 추가되어 토큰 사용량이 늘어날 수 있습니다.
- 문서: Earth Engine 공개 문서 를 검색하여 정확한 코드와 설명을 제공합니다.
- 데이터 세트 검색: Earth Engine 데이터 카탈로그에서 데이터 세트를 검색합니다.
- Google Search: 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 키가 있으면 코드 편집기에 추가해야 합니다.
- 'Ask' 패널의 채팅 입력 상자에서 키 아이콘을 클릭합니다.
- 표시되는 대화상자에 API 키를 붙여넣습니다.
- 선택적으로 체크박스를 선택하여 향후 세션을 위해 키를 저장하고 확인 을 클릭합니다.
자동 컨텍스트
관련 지원을 제공하기 위해 'Ask' 기능은 모든 요청에 다음 컨텍스트를 자동으로 포함합니다.
- 편집기의 현재 스크립트 전체 텍스트
- 가져온 애셋 및 도형
- 현재 세션의 채팅 기록
콘솔 오류 문제 해결
AI 어시스턴트는 코드 편집기의 콘솔과 직접 통합되어 런타임 오류를 빠르게 해결할 수 있도록 지원합니다.
- 스크립트에 오류가 발생하면 Console 탭에서 빨간색 오류 카드를 찾습니다.
- 오류 카드에서 Troubleshoot 버튼을 클릭합니다.
- 그러면 'Ask' 패널이 자동으로 열리고 스크립트의 오류 메시지와 관련 컨텍스트가 포함된 자동 생성된 프롬프트 메시지가 전송 대기열에 추가됩니다.
프롬프트 예시
채팅 상자에 직접 입력하여 어시스턴트에게 다양한 작업을 요청할 수 있습니다. 다음은 작업별로 분류된 요청 예시입니다.
코드 생성 및 워크플로
- '동아프리카의 2023년 Sentinel-2 이미지를 로드하고, 10% 미만의 구름 덮개를 필터링하고, 중간 NDVI를 계산하고, 흰색에서 녹색으로 시각화 팔레트를 사용하여 지도에 추가하는 스크립트를 작성합니다.'
- '중부 유럽의 2024년 여름에 구름이 없는 Landsat 9 합성 이미지를 만들고 내 클라우드 스토리지 버킷으로 내보냅니다.'
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 서비스 약관에 따라 처리됩니다. 프롬프트 및 생성된 콘텐츠 사용과 관련하여 약관을 검토하세요.
의견
의견을 주시면 서비스 개선에 도움이 됩니다. 코드 편집기 오른쪽 상단의 의견 보내기 버튼을 클릭하여 언제든지 의견을 공유해 주세요. Send Code Editor feedback(코드 편집기 의견 보내기) 옵션을 사용합니다. Google에서는 모델 성능을 개선하고 기능의 우선순위를 지정하기 위해 이 의견을 적극적으로 읽고 있습니다.