QAI
메뉴
다운로드

문서

빠른 시작

자연어 요청을 실행 계획으로 바꾸고, 내용을 검토·승인해 첫 작업을 시작합니다.

1. AGORA에 참여하고 시작

QGIS 툴바에서 QGIS AI 아이콘을 클릭하면 필수 AGORA 참여계약 화면이 열립니다. AGORA에 참여하고 시작을 한 번 누르면 서비스 이용약관과 코드 기여 라이선스를 함께 수락합니다. 거부하면 채팅·설정·스킬을 포함한 QAI 화면은 열리지 않습니다.

2. Google 계정에 참여를 귀속

이어지는 Google OAuth에서 사용할 계정을 선택하세요. 이는 두 번째 동의가 아니라 참여 증빙과 성공 PyQGIS 코드 기여를 현재 계정·기기에 연결하는 필수 본인 확인입니다. 참여 직후 QAI 도크의 설정이 열리며, 귀속이 완료돼야 채팅·스킬이 열립니다. 오류·사용 패턴 진단은 별도 선택 기능으로 새 프로필의 최초 참여에서 ON으로 시작합니다. 설정에서 언제든 끌 수 있고 기존 선택은 유지되며, AGORA 참여 기능 이용 여부와는 무관합니다.

3. 프로젝트 폴더와 AI 모델 연결

설정에서 작업 결과를 저장할 프로젝트 폴더를 선택하고, Gemini · OpenAI · Claude 중 사용할 제공자의 API 키를 하나 이상 등록하세요. 채팅 모델은 이 세 제공자를 지원합니다. Ollama는 선택형 로컬 임베딩에만 사용할 수 있으며 채팅 API 키를 대신하지 않습니다.

4. 지도를 요청해 보세요

채팅 박스에 예를 들어 이렇게 입력해 보세요:

현재 프로젝트의 "Roads" 레이어를 100m 버퍼 처리하고,
결과를 GeoPackage로 저장한 뒤 녹색 30% 투명도로 스타일 지정해 줘.

어시스턴트가 다음 내용을 담은 실행 계획을 먼저 제안합니다:

입력 레이어, 파라미터와 저장 위치를 검토한 뒤 승인하면 계획이 실행됩니다.

재사용 가능한 성공 PyQGIS 코드는 민감 패턴을 정제한 뒤 AGORA 검토 대기열에 기여됩니다.

5. 반복해서 다듬기

모든 응답은 대화의 연속입니다. 변경도 그냥 말하면 됩니다:

버퍼를 250m 로 바꾸고, 색상은 인구 밀도 기준으로 칠해줘.

6. 브라우저 작업 경험 녹화

사이트 계정에서 녹화하기를 누르고 보이는 Playwright 창에서 평소처럼 이동·클릭·타이핑하면 그 순서가 재사용 가능한 절차로 기록됩니다. 입력창의 클릭 위치, 선택·교체 범위, 편집 후 커서 위치도 UTF-16 기준 숫자 오프셋으로 기록됩니다. 선택된 문자열·주변 문자열·실제 입력값은 공유본에 들어가지 않고, 검색어·로그인 값 등은 실행 시 채우는 템플릿 변수로 분리됩니다.

녹화 검토 화면에서 완료 상태를 확인하고 경로별 공유 체크박스를 직접 선택한 경우에만 값 없는 템플릿이 AGORA 검토 대상이 됩니다. 자세한 범위는 브라우저 절차 템플릿 공유 라이선스를 확인하세요.

팁