문서

FAQ

”AGORA에 참여하고 시작”을 눌러야 QAI를 쓸 수 있나요?

네. 공식 배포본은 서비스 이용약관과 코드 기여 라이선스를 하나의 필수 AGORA 참여계약으로 묶습니다. 최초 화면의 “AGORA에 참여하고 시작” 버튼 한 번으로 두 문서를 함께 수락합니다. 거부하거나 참여를 철회하면 채팅·설정·스킬·사이트 계정과 온라인 기능을 포함한 QAI 전체를 사용할 수 없고, 진행 중인 작업도 취소됩니다.

버튼을 누른 뒤 Google OAuth로 계정을 선택하는 과정은 두 번째 동의가 아니라 참여 증빙과 코드 기여를 현재 계정·기기에 귀속하는 필수 본인 확인 단계입니다. 이 귀속이 끝나기 전에는 채팅·스킬을 시작할 수 없습니다. 개인정보처리방침은 별도 동의 항목이 아니라 계정·인증· 보안 로그 등 개인정보 처리 내용을 알리는 문서입니다. 오류·사용 패턴 진단만 참여계약과 분리된 선택 기능입니다. 새 프로필의 최초 참여에서는 ON으로 시작하지만 설정에서 언제든 끌 수 있고, 기존에 저장한 선택과 참여 철회 후 상태는 자동으로 다시 켜지지 않습니다.

GPL-2.0-or-later가 부여한 플러그인 소스의 실행·연구·수정·재배포 권리는 그대로 유지되지만, 공식 배포본의 QAI 이용 조건과는 구분됩니다. 미동의·철회 상태에서는 QAI 안의 권리 관리 화면도 열리지 않으므로 기존 기여의 열람·신규 배포 철회·서버 원문 삭제는 lloa9000@gmail.com으로 요청할 수 있습니다.

코드 기여 철회와 서버 원문 삭제는 어떻게 다른가요?

기여 철회는 앞으로 다른 사용자에게 제공되는 것만 중단합니다. 서버 원문 삭제는 강한 확인 뒤 코드·작업 템플릿·태그 등 원문을 빈 tombstone으로 덮어쓰고 신규 제공도 중단합니다. 기여 ID, 원본 해시, 동의·라이선스 및 검토·철회·삭제 감사 기록은 남습니다. 이미 제공된 응답이나 사용자 세션의 복사본은 회수할 수 없으며, 암호화된 백업은 보존기간 만료 또는 복구 후 재삭제 절차에 따라 처리됩니다. 참여 중에는 내 코드 기여 관리에서, 참여 철회 후에는 lloa9000@gmail.com으로 요청하세요.

AI API 키가 필요한가요?

네, 필요합니다(BYOK). AGORA 참여 후 열리는 설정 탭에서 Google 계정 귀속을 진행하고 Gemini · OpenAI · Claude 중 하나 이상의 키를 등록해야 합니다. 키는 로컬에 저장되고 모델 호출을 위해 선택한 AI 제공자에게 직접 사용되며, QGIS AI/AGORA 서버에는 전송되지 않습니다. Ollama는 현재 선택형 로컬 임베딩에만 사용할 수 있으며 채팅 모델 API 키를 대신하지 않습니다.

Google 계정 귀속은 AGORA 참여자 확인과 브이월드·공공데이터 프록시·중앙 코드 재사용 API 이용을 위한 것이며, AI 모델 호출을 대신해 주지는 않습니다.

내 데이터가 외부로 나가나요?

프롬프트와 작업 수행에 필요한 도구 실행 결과는 사용자가 선택한 AI 제공자에게 직접 전송될 수 있습니다. 여기에는 선택한 레이어의 메타데이터, 일부 속성값·좌표와 프로젝트 경로 등 도구가 반환한 정보가 포함될 수 있습니다. 원본 GIS 파일이나 사이트 자격 증명을 파일째 자동 업로드하지는 않지만, 민감한 데이터가 있는 작업에서는 실행 계획과 전송될 맥락을 확인해야 합니다. AI API 키는 로컬에 저장되며 QGIS AI/AGORA 서버에는 전송되지 않습니다.

AGORA 참여 후 재사용 가능한 적격 성공 PyQGIS 코드는 경로·비밀정보 패턴을 정제한 뒤 공동 코드 풀의 검토 대기열에 제출되며, 관리자 승인 전까지 다른 참여자에게 제공되지 않습니다.

품질 개선용 오류·사용 패턴 진단은 새 프로필의 최초 참여에서 ON으로 시작하며 플러그인 설정의 **“사용 데이터 전송”**에서 언제든 끌 수 있습니다. 기존에 저장한 OFF와 참여 철회 후 상태는 자동으로 다시 켜지지 않습니다. 이를 꺼도 필수 코드 기여, Google 계정 귀속, 모델 호출, 공공데이터 프록시와 중앙 코드 재사용 통신은 중단되지 않습니다. 진단에는 자연어 원문· 성공 코드·오류 트레이스가 포함되지 않으며, 전송 항목은 개인정보처리방침을 참고하세요.

성공 코드는 AGORA에 기여되나요?

네. 공유 권한이 있는 재사용 가능한 성공 PyQGIS 코드의 기여는 AGORA 참여조건입니다. 참여 버튼을 누르는 즉시 로컬 코드를 긁어가는 것은 아니며, Google 계정 귀속을 마친 뒤 QAI에서 성공한 적격 코드만 경로·비밀정보 패턴을 정제해 제출합니다. 코드 기여를 끄는 별도 체크박스나 두 번째 라이선스 동의는 없습니다. 모든 기여는 서버 검사와 관리자 검토 전까지 격리되며, 승인된 코드도 전체 목록으로 배포하지 않고 정확히 일치하는 요청에 최대 한 건만 API로 제공합니다. 다른 참여자가 받은 코드는 실행 전에 확인·승인해야 합니다.

대시보드의 절감 토큰은 실제 청구액인가요?

아닙니다. 현재 값은 재사용 검색 시 서버가 코드 크기를 기준으로 계산한 보수적 추정치이며, 적용·성공 여부는 클라이언트 보고입니다. 독립 검증이나 결제 정산 수치로 표시하지 않습니다. 실제 모델·가격별 비용은 모델 제공자의 청구 내역과 함께 확인해야 합니다.

어떤 QGIS 버전을 지원하나요?

현재 배포본은 QGIS 3.28~3.99를 지원합니다. QGIS 4.x용 배포본은 아직 제공하지 않습니다.

오프라인에서도 동작하나요?

최초 AGORA 참여 증빙의 계정 귀속에는 인터넷 연결이 필요합니다. 귀속을 마친 뒤에도 Gemini · OpenAI · Claude 채팅 모델 호출, 공식 온라인 기능과 필수 코드 기여에는 인터넷 연결이 필요합니다. Ollama를 이용한 선택형 로컬 임베딩은 오프라인으로 실행할 수 있지만, 채팅 모델을 대체하지 않으므로 QAI 전체를 오프라인으로 사용할 수 있다는 의미는 아닙니다.

누가 만들었나요?

GIS 실무자를 위한 도구를 만드는 독립 개발자입니다. lloa9000@gmail.com 으로 연락 주세요.

플러그인 소스는 공개되어 있나요?

네. 플러그인 코드는 GPL-2.0 으로 배포되며 Keilkim/qgis-releases 에서 모든 소스와 바이너리(Cython .pyd/.so) 대응 원본이 공개됩니다. 다만 서버 API, AI 프롬프트, 코드 레퍼런스 DB 등 운영자가 제공하는 서비스는 독점이며 공개되지 않습니다.