Scribble Maps에서 AI 에이전트 사용하기 (Agent Mode)

Agent Mode를 사용하면 AI 에이전트가 Scribble Maps 지도 에디터에서 사용자와 함께 작업할 수 있습니다. 브라우저에서 Claude, ChatGPT 또는 Gemini를 사용하는 경우 도형 그리기, 경계 수정, 레이어 정리 또는 지도 확인을 요청할 수 있으며, 이미 열려 있고 본인 계정으로 로그인된 에디터에서 작업이 수행됩니다.

아무것도 설치되지 않으며, 생성하거나 저장할 API 키도 없습니다. 일반 로그인, 요금제 제한 및 AI 크레딧이 사용자에게 적용되는 것과 동일하게 에이전트에게도 적용됩니다.

먼저 에이전트의 브라우저 접근을 허용하세요

Agent Mode는 Scribble Maps 측의 설정입니다. 나머지 반은 AI 앱에 있습니다. 에이전트에게 브라우저 접근 권한을 부여하기 전까지는 에이전트가 페이지를 건드릴 수 없으며, 이 단계를 놓치는 경우가 많습니다.

In Claude에서는 이것이 브라우저 창(browser pane)이며, 지구본 컨트롤로 켤 수 있습니다. 켜기 전까지 Claude는 사용자가 이미 보고 있는 것처럼 "브라우저 창"에 대해 이야기하지만, 지도에 대해 말하는 어떤 내용도 실제 지도에 도달하지 않습니다. ChatGPT와 Gemini는 각각 고유한 위치에 자체 컨트롤이 있으며, 이러한 앱은 자주 변경되므로 찾을 수 없는 경우 해당 앱의 도움말에서 브라우저 또는 페이지 접근(browser or page access)을 검색해 보세요.

에이전트가 실제로 페이지에 접근하고 있는지 확인하는 빠른 방법은 지도에 무엇이 있는지 물어보는 것입니다. 사용자가 생성한 레이어의 이름을 말할 수 있다면 연결된 것입니다. 지도를 일반적인 용어로 설명한다면 추측하고 있는 것이며, 브라우저 접근이 여전히 꺼져 있는 상태입니다.

Agent Mode 켜기

시작하는 방법은 세 가지가 있습니다:

지도 에디터 하단에서 Enable Agent Mode를 클릭합니다.
에이전트에게 켜달라고 요청합니다. 에이전트의 지도 호출이 발생하면 Agent Mode가 자동으로 켜집니다.
https://www.scribblemaps.com/create/#agentMode에서 에디터를 엽니다. 이 링크는 Agent access 패널을 엽니다. Agent Mode 자체는 에이전트의 첫 번째 작업과 함께 켜집니다.

Agent Mode가 켜지면 지도 하단에 상태 표시줄이 나타납니다. 활성화된 도구와 선택된 항목의 이름이 표시되므로 에이전트가 작업하는 동안 무엇을 하고 있는지 볼 수 있습니다. 툴팁도 왼쪽 하단의 고정된 위치로 이동하여 지도를 가리지 않게 됩니다.

중지하려면 에이전트에게 Agent Mode를 꺼달라고 요청하세요. 에디터를 새로 고침해도 종료됩니다. 에디터는 즉시 정상 상태로 돌아갑니다.

에이전트에게 작업 부여하기

두 가지 방식으로 작업할 수 있으며, 자유롭게 혼합하여 사용할 수 있습니다.

에이전트에게 직접 요청하기. 에이전트의 채팅창에서 지도에 원하는 작업을 말하세요. 예를 들어 "CN 타워 주변에 100미터 원을 그리고 중앙에 마커를 놓아줘"라고 입력합니다. 에이전트가 에디터를 읽고 올바른 도구를 선택하여 그립니다.

Agent access 패널 사용하기. 에디터 하단에서 Agent access를 클릭합니다. 패널에는 요청 상자, Send task 버튼, Cancel task 버튼, 상태 표시줄 및 응답 로그가 있습니다. 또한 에이전트를 위한 간단한 빠른 시작 안내도 표시되며, 이는 숨길 수 있습니다.

이 패널은 두 가지 상황에서 유용합니다. 사용자가 직접 작업을 전달하고 싶을 때와 에이전트가 페이지를 클릭하고 입력할 수는 있지만 JavaScript를 실행할 수 없을 때입니다.

에이전트가 할 수 있는 작업

Agent Mode의 에이전트는 에디터 자체 도구 중 100개 이상을 사용할 수 있습니다. 주요 기능은 다음과 같습니다:

마커, 선, 다각형, 원을 그립니다(Draw). 원은 실제 미터 단위의 반경을 적용합니다. Scribble Maps가 화면 위치와 위도/경도 간의 변환을 처리하므로 도형이 정확한 위치에 배치됩니다.
화면에 표시되는 것과 동일한 이름 및 단축키를 사용하여 라이브 도구 상자에서 도구를 선택합니다(Pick tools).
기존 도형을 편집합니다. 에이전트는 도형을 열고, 편집 핸들을 나열하고, 지정한 핸들을 강조 표시한 다음 해당 핸들을 이동할 수 있습니다. 도형의 스타일과 히스토리는 그대로 유지됩니다.
도형의 스타일을 지정합니다: 색상, 불투명도, 선 두께, 실선/대시선/점선 등.
지도를 읽습니다. 이름, 유형, 샘플링된 좌표와 함께 지도에 있는 항목을 나열하고 현재 뷰를 읽을 수 있습니다.
검색 및 탐색: 장소 찾기, 좌표로 이동, 줌 설정, 베이스맵 변경.
데이터 작업: 파일 가져오기, 속성별 필터링, 버퍼 및 이동 시간 영역 생성, 범례 및 라벨 추가, 이미지 또는 GeoJSON 내보내기.
USA Zip Codes, USA Parcel Boundaries, Traffic Intelligence, Solar Analysis 등의 지도 키트를 추가하고 보고서를 실행합니다(예: 건물의 옥상 태양광 보고서 또는 도로의 일일 교통량). Pro Business가 필요한 키트는 에이전트가 이를 인지하고 직접 결제하는 대신 업그레이드 링크를 제공합니다.
Undo 및 Redo를 수행하여 단계를 확인하고 되돌릴 수 있습니다.

Scribble에 도움 요청하기

Scribble은 에디터에 내장된 지도 어시스턴트입니다. 작업 중 막히거나, 문서가 필요하거나, 기능을 찾을 수 없는 에이전트는 Scribble에 질문을 전달하고 답변을 읽은 다음, 직접 도구를 사용하여 작업을 계속할 수 있습니다.

Scribble에 질문하는 것은 사용자가 직접 Scribble에 질문하는 것과 동일하게 계산됩니다. 원 그리기와 같이 에이전트가 직접 사용하는 도구는 사용자가 직접 클릭할 때와 똑같이 작동합니다.

원하지 않는 작업 실행 취소하기

에이전트가 수행하는 모든 편집은 사용자가 직접 편집한 것과 동일한 실행 취소 히스토리에 기록됩니다. Undo를 한 번 클릭하면 지도가 이전 상태로 돌아갑니다.

사용자가 직접 저장하거나 공유하지 않는 한 아무것도 저장되거나 공유되지 않습니다. 작업이 잘못된 방향으로 진행되는 경우 Agent access 패널에서 Cancel task를 클릭하세요. 취소하면 작업이 중단되지만, 이미 발생한 편집은 되돌리지 않으므로 해당 작업에는 Undo를 사용하세요.

작동하는 에이전트 종류

Claude, ChatGPT, Gemini 모두 작동하며, 브라우저 탭에서 작동할 수 있는 다른 모든 AI 에이전트도 작동합니다. 처음에는 에이전트가 페이지에서 작동하도록 허용해야 할 수 있습니다.

모바일 또는 태블릿에서 사용하는 경우. 휴대폰의 자체 브라우저에서는 Agent Mode를 실행할 수 없습니다. 하지만 에이전트가 자체 브라우저를 제공하는 앱에서는 가능합니다. ChatGPT 모바일 앱에서 Work 모드로 전환하고 원하는 지도를 요청하세요. 에이전트가 로그인되지 않은 자체 브라우저에서 Scribble Maps를 열고 Authorize Scribble Maps 링크를 보여줍니다. 휴대폰에서 링크를 열고, 로그인한 후, 계정과 요청 사항을 확인하고 승인하세요. 링크는 짧은 시간 후 또는 한 번 사용되면 만료되므로, 만료된 경우 새 링크를 요청하세요. 그러면 에이전트가 사용자 계정에 지도를 생성합니다. 에이전트의 채팅창에서 지도를 저장하거나 공유하거나, 나중에 아무 기기에서나 지도를 열 수 있습니다.

일부 브라우저는 사용자가 아무 작업도 하지 않아도 에디터 도구를 에이전트에게 자동으로 제공할 수 있습니다. 이에 대한 지원은 아직 준비 중이므로, 의존하기보다는 보너스 기능으로 생각하세요. 위의 단계는 어느 쪽이든 작동합니다.

좋은 습관

무엇보다 먼저 에이전트 측의 브라우저 접근 권한을 확인하세요. "작동하지 않는다"는 문제의 대부분은 에이전트가 페이지를 볼 수 없기 때문에 발생합니다. 지도에 있는 레이어 이름을 말하지 못하는 에이전트는 연결되지 않은 것입니다.
에이전트가 먼저 Agent Mode를 켜도록 하세요. 이렇게 하면 상태 표시줄이 표시되고 에디터 자체의 팁이 방해되지 않도록 유지됩니다.
확실하지 않은 좌표보다는 장소 이름이나 주소로 요청하세요. 에이전트가 검색할 수 있으며, 에이전트가 임의로 만들어낸 좌표는 도형이 잘못된 위치에 배치되는 가장 흔한 원인입니다.
작업 결과를 확인하도록 요청하세요. 에이전트는 지도를 다시 읽고 뷰를 볼 수 있으므로 "원이 타워 위에 있는지 확인해 줘"와 같은 지시는 합리적인 요청입니다.
작업이 진행되는 동안 에디터 탭을 열어 두세요. 에이전트는 해당 탭에서 작업합니다.
결과가 마음에 들 때만 저장하거나 공유하세요.