CLAWPOD ENGINEERING

ClawPod Cloud에서 목록 화면 업무 맡기기 — 대상을 지정하고 결과를 확인하는 법

ClawPod Cloud에서 같은 버튼이 줄줄이 반복되는 목록 화면의 업무를 맡길 때, 대상을 지정하는 문장과 결과에서 반드시 받아야 할 세 가지를 짚습니다.

똑같이 생긴 서랍 손잡이가 벽면 가득 늘어서 있고 그중 하나에만 표가 붙어 있는 실사풍 AI 생성 이미지
같은 모양이 반복되는 목록에서 하나를 지정하는 일을 비유한 AI 생성 이미지이며 실제 제품 화면이 아닙니다.

같은 ‘처리’ 버튼이 반복되는 목록에서 중요한 것은 클릭 속도가 아니라 어느 항목을 가리키는지입니다. 이 글은 ClawPod Cloud에서 Agent에게 목록 확인을 맡기는 실무자를 위한 안내입니다. 브라우저를 사용할 수 있는 Agent와 대상 사이트 접근 권한이 있다는 전제에서, 읽기 요청의 범위를 정하고 결과를 대조하는 방법을 설명합니다. 로그인 설정이나 실제 상태 변경 절차는 다루지 않습니다.

핵심은 주소·계정 범위·항목 식별값을 함께 적고, 건수뿐 아니라 항목 자체를 대조하는 것입니다. 요청에 쓴 제한은 업무 지시이며, 사이트의 접근 제어나 자동 차단 장치를 대신하지 않습니다.

열 수 있는 페이지와 맡겨도 되는 일은 다릅니다

Agent는 요청을 받아 도구로 작업하는 실행 주체입니다. ClawPod Guide는 브라우저를 사용할 수 있는 Agent에게 페이지 읽기·탐색·입력·화면 확인을 요청할 수 있다고 안내합니다. 데스크톱이 없는 경량 Agent는 GUI 브라우저 작업을 지원하지 않습니다. 준비 상태가 확인되지 않으면 대상 Agent와 필요한 업무를 관리자에게 알려 주세요.

사이트를 열 수 있다는 사실은 그 계정으로 모든 업무를 해도 된다는 뜻이 아닙니다. 대상 사이트 접근 권한, 사용할 계정 범위, 이번 요청에서 허용한 동작을 각각 정해야 합니다. 저장된 로그인 정보가 있거나 어떤 기능을 실행할 도구가 있다는 이유만으로 계정 사용·제출·전송이 승인된 것은 아닙니다.

또한 자신의 브라우저에서 로그인했다고 Agent도 같은 로그인 상태를 쓴다고 가정하지 마세요. Agent용으로 분리된 브라우저와 사용자의 기존 로그인 브라우저는 구분해서 확인해야 합니다. 이 글은 특정 연결 방식의 제공 여부나 현재 로그인 상태를 보장하지 않습니다. Guide는 ClawPod Cloud가 전용 브라우저 프로필의 생성·선택·회수 수명 주기를 제공하지 않는다고 명시합니다. 여기서 프로필은 쿠키 등 브라우저 상태를 구분하는 단위입니다. 개인 일상 브라우저 프로필이나 비밀번호 관리자를 공유하지 마세요.

주소만으로 목록을 확정하지 마세요

URL은 웹 페이지 주소입니다. 어떤 사이트는 주소에 검색어·기간·페이지 번호를 넣지만, 어떤 사이트는 화면의 필터 상태를 주소에 남기지 않습니다. 따라서 출처 URL만 같아도 같은 목록을 봤다고 단정할 수 없습니다.

요청에는 주소와 함께 기간, 상태, 조직 또는 계정의 업무 범위를 적으세요. 날짜는 ‘지난달’보다 ‘2026-08-01부터 2026-08-31까지, 사이트 표시 날짜 기준’처럼 고정하면 나중에 다시 확인하기 쉽습니다. 필터를 그대로 둘지, 바꿔도 되는지도 명시합니다. 계정에 따라 보이는 행이 다른 사이트라면 예상 건수를 어느 권한 범위에서 셌는지도 맞춰야 합니다.

행 번호나 ‘위에서 세 번째’는 정렬이 달라지면 다른 항목이 됩니다. 화면에 보이는 고유 접수번호를 우선 쓰고, 상태와 접수일을 함께 대조하세요. 고유값이 없거나 같은 값이 여러 번 나오면 추가 식별 정보가 필요합니다. 값 두 개를 적는 것만으로 대상이 유일해지는 것은 아닙니다.

이 방식은 조직이 요청과 검수를 설계하는 방법입니다. 모든 사이트에서 Agent가 정확한 행을 자동으로 고른다는 제품 보장은 아닙니다.

먼저 읽기만 맡기는 요청을 만듭니다

Guide는 대상 URL과 원하는 결과를 적고, 읽기·입력·제출·다운로드·외부 전송 중 허용 범위를 명시한 뒤 작은 읽기 요청으로 접근 가능 여부를 확인하도록 안내합니다. 목록 업무라면 여기에 대상의 식별 기준과 확인 가능한 범위를 붙이세요.

다음은 가상 예시입니다. 주소·접수번호·건수·결과는 실제 실행 기록이 아니며 제품 화면을 재현하지 않습니다. 목록은 이미 표시되어 있고, 화면 이동이나 필터 변경 없이 세 항목을 읽을 수 있다고 가정합니다.

https://example.com/reports의 현재 표시된 목록만 읽어 주세요. 승인된 검수팀 조회 범위에서, 접수일이 2026-08-01~2026-08-31이고 상태가 ‘검수 대기’인 항목을 확인합니다. 예상 접수번호는 R-104, R-109, R-112, 총 3건입니다. 로그인·계정 전환·필터 입력·상태 변경·제출·다운로드는 하지 마세요. 결과는 이 대화에만 적고 다른 수신자나 외부 서비스로 보내지 마세요. 접수번호·접수일·상태와 출처 URL, 확인한 범위, 실제 변경, 실패하거나 확인하지 못한 단계를 보고해 주세요. 추가 로그인, 중복 식별값, 예상과 다른 항목 또는 건수가 나오면 진행하지 말고 차이를 알려 주세요. 다른 페이지를 열어야 하면 먼저 필요한 범위를 설명해 주세요.

‘읽기만’이라는 말에 허용하지 않은 탐색이나 다운로드까지 포함시키지 않았습니다. 대화에 결과를 받는 범위와 다른 곳으로 전송하는 범위도 분리했습니다. 실제 업무에서는 조직 정책에 따라 대화에 남겨도 되는 항목만 요청하세요.

결과 표와 확인 범위를 함께 받습니다

위 요청에 대한 가상 결과 표본은 다음과 같습니다. 실제 사이트에서 읽어 온 자료가 아닙니다.

접수번호 접수일 상태
R-104 2026-08-04 검수 대기
R-109 2026-08-18 검수 대기
R-112 2026-08-27 검수 대기

출처: https://example.com/reports. 현재 표시된 검수팀 목록의 세 항목을 확인했습니다. 접수번호 집합과 건수가 예상값과 같습니다. 로그인·계정 전환·필터 입력·상태 변경·제출·다운로드·다른 수신자 전송은 수행하지 않았습니다. 읽은 범위에서 실패한 단계는 없습니다. 다른 페이지와 숨겨진 항목은 확인하지 않았으므로 전체 목록을 모두 확인했다고 보고하지 않습니다.

완료 여부는 표의 행 수만으로 정하지 마세요. 아래 순서로 요청과 결과를 대조합니다.

  1. 출처 URL뿐 아니라 계정의 업무 범위, 기간, 상태, 확인한 페이지 범위가 맞는지 봅니다.
  2. 접수번호가 정확히 R-104·R-109·R-112인지 확인하고 날짜와 상태를 대조합니다. 3건이어도 R-112 대신 R-113이 들어 있으면 실패입니다.
  3. 실제 변경과 미실행·미확인 항목을 읽습니다. 표본처럼 다른 페이지를 확인하지 않았다면 전체 목록 확인으로 확대해서 해석하지 않습니다.

Agent의 보고는 대조의 출발점입니다. 변경 여부가 중요한 업무라면 권한 있는 사람이 대상 서비스의 이력 등 이용 가능한 독립 근거와도 맞춰야 합니다. ‘클릭 성공’이나 화면의 성공 안내만으로 올바른 대상의 업무가 완료됐다고 판단하지 마세요.

차이가 나면 대상을 다시 정하고 멈춘 지점부터 확인합니다

예상은 3건인데 4건이 보이면 그중 임의의 3건을 고르지 않게 하세요. 다음처럼 보고하도록 요청할 수 있습니다. 가상 실패 표본: ‘검수 대기 항목이 4건이며 R-117이 예상 목록에 없습니다. 변경은 하지 않았습니다. 대상 조건 또는 예상 접수번호를 확인해 주세요.’ 건수가 같아도 접수번호가 다르면 같은 방식으로 차이를 알립니다.

추가 페이지가 필요하거나 필터·정렬·계정이 달라졌다면 기존 결과를 그대로 재사용하지 않습니다. 필요한 최소 범위를 확인하고, 허용된 경우 새 화면을 읽어 항목을 다시 대조하세요. 부분 목록만 읽을 수 있었다면 확인된 항목과 미확인 범위를 나누어 받습니다. 추가 로그인이나 사람 확인이 필요하면 멈추고 필요한 조치를 알리도록 합니다.

오류를 문의할 때는 실행한 단계, 민감한 값을 제거한 URL, 예상값과 실제값의 차이, 오류 요약을 전달하세요. 비밀번호·쿠키·인증값·전체 로그를 대화에 붙이지 않습니다. 출처 주소에도 민감한 검색어 또는 토큰이 있으면 공유 가능한 형태로 가려야 합니다.

나중에 상태 변경까지 맡기려면 읽기 요청을 그대로 재사용하지 말고 허용할 대상과 변경을 다시 정하세요. Guide는 결제·계정 변경·메시지 전송·파일 업로드·다운로드처럼 되돌리기 어렵거나 데이터가 이동하는 동작을 실행하기 직전에 다시 확인하도록 요청하라고 안내합니다. 도구의 사용 가능 여부와 실제 업무 승인은 별개입니다.

오늘 맡길 목록 하나에서 고유 식별값, 예상 항목 집합, 확인할 화면 범위를 적어 보세요. 먼저 읽기 결과를 대조한 뒤 다음 동작을 결정하면 됩니다.

Sources