설치형 업무 프로그램, 무엇부터 Agent에게 맡겨 볼까요?

매달 첫 주, 구매 관리 프로그램의 발주 목록을 표로 옮기는 일이 반복됩니다. 이 글은 브라우저가 아닌 설치형 프로그램의 업무를 Agent에게 맡길지 판단하는 실무자를 위한 안내입니다. 먼저 프로그램이 실행되는 컴퓨터, 화면 접근 권한, 허용할 작업을 확인해야 합니다. 준비된 환경에서 작은 조회 시험을 설계하는 방법을 다루며, 특정 사내 프로그램의 호환성을 보장하지 않습니다.

핵심은 화면을 볼 수 있다는 사실과 업무를 끝낼 수 있다는 사실을 나누는 것입니다. 첫 시험은 비민감 테스트 자료를 조회하는 일로 잡고, 원본 변경이나 외부 전송 없이 결과를 대조하세요.

프로그램이 있는 컴퓨터부터 정하세요

ClawPod Cloud는 Agent를 관리하고 대화하는 서비스이고, ClawPod Agent는 준비된 도구와 권한 안에서 요청을 수행합니다. GUI 데스크톱은 창과 아이콘이 있는 작업 화면입니다. 공식 Guide는 full 실행 이미지의 Agent가 브라우저와 GUI 데스크톱을 조작할 수 있다고 설명합니다. 실행 이미지는 Agent에 포함된 프로그램과 실행 환경의 묶음입니다.

하지만 내 PC에 설치한 프로그램이 Agent의 화면에도 나타나는 것은 아닙니다. 다음 구분이 시험의 출발점입니다.

Cloud Portal — 조직과 Agent를 관리하는 웹 서비스입니다. Portal 접근 권한을 업무 프로그램의 조작 권한으로 해석하지 않습니다.

Agent Control UI — Agent의 관리·대화 인터페이스입니다. Cloud Portal과 같은 화면이라고 가정하거나 한쪽 메뉴를 다른 쪽에 적용하지 않습니다.

Agent의 브라우저 — 웹 페이지를 여는 작업 환경입니다. 브라우저 사용 가능 여부가 설치형 앱의 실행 가능 여부를 증명하지 않습니다.

Agent Desktop — Agent 실행 환경의 화면입니다. 내 PC 화면이나 내 PC에 설치한 프로그램과 구분합니다.

별도로 연결한 PC·노드 — 업무 프로그램이 다른 컴퓨터에 있다면 별도 연결과 권한 확인이 필요합니다. 노드는 여기서 Agent에 연결된 다른 기기를 뜻합니다. 이 글은 특정 연결 절차나 앱 호환성을 확인한 안내가 아닙니다.

Guide에서 확인한 데스크톱 지원은 모든 Windows·macOS 프로그램을 Agent 환경에서 실행한다는 뜻이 아닙니다. 필요한 운영체제, 설치와 라이선스, 로그인, 화면 접근, 파일 접근을 대상 환경에서 각각 확인하세요. 별도 PC 연결도 현재 Agent의 도구와 연결 상태에서 확인해야 하며, 문서에 없다는 이유만으로 불가능하다고 단정하거나 숨겨진 설정으로 강제로 켜서는 안 됩니다.

먼저 작은 조회를 고르고, 쓰기 작업은 뒤로 미루세요

첫 시험은 결과를 대조할 수 있고 실패해도 다른 업무를 막지 않는 일이어야 합니다. 조회도 민감정보를 노출할 수 있으므로 읽기 전용이라는 이유로 안전하다고 단정하지 않습니다.

먼저 시험할 일	나중으로 미룰 일
비민감 테스트 목록의 날짜·건수 확인	실제 주문의 승인·취소
테스트 자료 몇 행을 읽어 원본과 대조	반복 입력, 대량 수정·삭제
허용된 자료로 작은 결과 표 작성	금액·권한 변경, 결제·외부 전송

건수만 맞으면 성공이라는 기준도 부족합니다. 다른 기간의 자료를 읽거나 같은 행을 두 번 옮겨도 건수는 같을 수 있습니다. 기간, 필터, 페이지 범위, 식별자와 값까지 대조할 기준을 미리 정하세요. 되돌릴 수 있을 것 같은 작업이라도 중복 제출이나 외부 발송은 쉽게 취소되지 않습니다.

화면이 준비됐는지와 실행 허용 범위를 따로 확인하세요

Guide에 따르면 경량 이미지인 clawpod/agent-lite에는 Chromium과 GUI 데스크톱, VNC/noVNC가 없습니다. VNC/noVNC는 원격 화면을 연결해 보는 구성 요소입니다. 일반 사용자가 모든 실행 이미지를 직접 고르는 절차는 제공되지 않으므로, 필요한 화면 작업이 준비되지 않았다면 대상 Agent와 필요한 작업을 관리자에게 전달하세요.

화면 지원이 확인된 뒤에도 프로그램의 설치 여부와 사용할 계정, 테스트 자료 접근 권한을 확인해야 합니다. Skill은 Agent가 작업을 수행할 때 참고하는 재사용 지침입니다. cli-anything Skill이 기본 포함됐다는 사실만으로 특정 앱의 자동화 도구, 의존 프로그램, 자격 증명이 준비됐다고 볼 수 없습니다.

브라우저도 별도 경계가 있습니다. Agent 쪽에서 관리하는 브라우저와 개인 일상 브라우저를 혼동하지 마세요. Guide는 Cloud가 전용 브라우저 프로필의 생성·선택·회수 절차를 제공하지 않는다고 설명합니다. 개인 비밀번호 관리자나 일상 프로필을 공유하지 말고 쿠키, 로그인 상태와 다운로드 파일을 민감정보로 다루세요.

도구가 있다는 사실은 실행 승인과 다릅니다. 요청에 대상 프로그램과 창, 읽을 자료, 허용 경로, 변경·전송 금지 범위, 멈출 지점을 적으세요. 설치, 계정 변경, 파일 업로드·다운로드, 제출처럼 영향이 있는 작업은 해당 범위의 명시적 승인에 따릅니다. 확인되지 않은 권한을 늘리거나 실제 자료로 시험하지 않습니다.

발주 목록 세 행으로 요청부터 결과 확인까지

아래는 가상 예시입니다. 테스트용 구매 프로그램을 허용된 데스크톱 환경에서 열고 읽을 수 있다는 전제이며, 특정 앱을 실제로 조작한 기록이나 지원 약속이 아닙니다. 날짜·식별자·수량과 검증 기준도 설명을 위해 정했습니다.

요청: 읽을 범위와 멈출 조건을 함께 전달합니다

테스트용 구매 프로그램에서 2026년 8월 발주 목록을 읽을 수 있는지 먼저 확인해 주세요. 허용된 테스트 계정과 지정한 창만 사용하세요. 기간과 필터, 전체 건수와 페이지 범위를 알려 주고, 화면의 세 행을 발주번호·품목·수량 표로 정리해 이 Room에 답해 주세요. 원본 등록·수정·삭제, 파일 내보내기, 다운로드와 외부 전송은 하지 마세요. 다른 계정 로그인, 새 권한, 다른 창이나 민감자료가 필요하면 멈추고 이유를 알려 주세요.

결과 표본: 확인한 범위와 하지 않은 일을 같이 받습니다

가상 응답: “지정한 테스트 창에서 기간은 2026년 8월, 상태 필터는 전체, 표시된 총건수는 3건, 페이지는 1/1로 확인했습니다. 아래 세 행을 읽었습니다. 원본 변경, 파일 내보내기·다운로드, 외부 전송은 하지 않았습니다. 다른 기간이나 실제 운영 자료는 확인하지 않았습니다.”

발주번호	품목	수량
TEST-081	파일철	4
TEST-082	라벨 묶음	2
TEST-083	보관 상자	6

성공 확인: 행 수 외에 범위와 값을 대조합니다

사용자가 허용된 원본 화면과 결과 표를 나란히 확인합니다. 기간과 상태 필터가 요청과 같고, 1/1 페이지의 3건이 빠짐없이 들어 있어야 합니다. 발주번호 세 개가 중복 없이 대응하고 품목·수량도 각각 같아야 합니다. 가능하면 프로그램의 기록에서 원본 변경이 없었는지도 확인합니다. 변경 이력을 볼 수 없다면 “변경 없음 독립 확인은 미실시”로 남기며, Agent의 설명만으로 그 항목까지 검증됐다고 하지 않습니다.

실패 복구: 빠진 자료를 추정해서 채우지 않습니다

예를 들어 화면 총건수는 3인데 두 행만 읽었다면 결과는 미완료입니다. Agent는 “세 번째 행을 읽지 못해 2/3건만 정리했고 내보내기는 하지 않았습니다”라고 보고해야 합니다. 필터·페이지·창이 맞는지 읽기 범위 안에서 확인하고, 추가 접근이나 권한이 필요하면 사용자가 범위를 결정한 뒤 다시 시험합니다. 이미 입력·제출이 일어났는지 불명확하다면 같은 동작을 반복하지 말고 현재 상태와 기록부터 확인하세요.

화면이 열리지 않을 때는 막힌 위치를 기록하세요

Cloud Portal의 Agent 화면 보기와 프로그램 내부 작업은 서로 다른 단계입니다. Guide는 실행 중인 Agent 상세에서 Desktop, Dashboard, 대화 기록을 볼 수 있다고 설명하지만, 이 글은 현재 로그인한 Portal이나 Agent Control UI의 메뉴를 직접 검증한 화면 안내가 아닙니다. 실제 표시 항목은 현재 환경에서 확인하세요. 작업 요청은 대상 Agent가 참여한 Chat Room에 보내며, Conversations는 읽기 전용 기록 화면입니다.

Agent에 접근하지 못함: Agent 상태와 접근 권한을 확인합니다. Guide가 안내하는 awaiting_auth 상태라면 필요한 인증부터 완료합니다.
Desktop 연결 실패: 화면 지원 환경과 연결 상태를 관리자에게 전달합니다. 비밀번호 변경이나 재시작을 진단용 첫 행동으로 실행하지 않습니다.
화면은 보이지만 앱이 없음: 지금 보는 컴퓨터가 맞는지, 앱 설치와 운영체제 조건이 맞는지 확인합니다.
앱은 보이지만 읽기·조작 실패: 대상 창, 로그인, 권한, 대화상자와 실패한 단계를 구분해 기록합니다. 화면을 봤다는 사실만으로 조작 성공을 보고하지 않습니다.

오류 보고에는 대상 Agent, 필요한 작업, 멈춘 단계와 비민감 오류 요약을 남기세요. 화면에는 파일·로그인·업무자료가 보일 수 있으므로 전체 화면 녹화, 쿠키, 비밀번호나 전체 로그를 그대로 공유하지 않습니다.

첫 결과는 자동화 성공 여부 하나가 아닙니다. 어느 컴퓨터의 어떤 창에서, 어느 범위까지 확인했고 무엇이 남았는지가 다음 시험의 입력입니다. 지금 반복 업무 하나를 골라 비민감 자료 몇 행을 읽는 요청부터 작성해 보세요.

Sources

ClawPod Guide — Agent에게 Browser와 CLI 작업 요청하기: 실행 환경, 브라우저 상태, 요청 범위와 승인, 결과 전달.
ClawPod Guide — Agent Desktop과 대화 기록 보기: Agent 화면, 이미지 조건, 연결과 민감정보 주의사항.
ClawPod Guide — 기능 안내: Portal 기능과 Agent 작업의 구분, 준비 조건.
ClawPod Guide — 기능 사용 조건: 환경별 사용 범위와 미확인 기능의 판단.
ClawPod Guide — Agent가 문서를 읽고 판단하는 방법: 문서와 현재 도구의 차이, 권한·승인 경계.