Agent에게 일을 맡기기 전에 도구 준비 상태를 확인하세요

파일·명령·브라우저 작업을 Agent에게 맡기는 실무자를 위한 글입니다. 요청 전에 현재 Agent에서 가능한 일, 허용된 일, 확인하지 못한 일을 나누는 방법을 설명합니다. 대상 Agent가 참여한 Room과 업무에 사용할 자료의 접근 범위를 먼저 확인해 주세요. 설치 안내나 모든 도구의 목록이 아니라, 준비 상태를 확인하고 작은 작업으로 검증하는 운영 안내입니다.

도구 이름보다 지금 사용할 수 있는지를 확인하세요

Skill은 특정 작업을 수행할 때 Agent가 참고하는 절차와 사용 지침을 묶은 것입니다. 도구가 실제 작업을 수행하는 수단이라면, Skill은 그 수단을 언제 어떻게 쓸지 안내합니다. Skill이 있다는 사실만으로 필요한 프로그램, 접근 권한과 외부 서비스 연결까지 모두 준비됐다고 판단하지 마세요.

공식 Guide에 따르면 일부 Skill과 도구는 기본으로 준비되지만, 사용할 수 있는 도구는 Agent 실행 환경마다 다릅니다. 경량 Agent에는 그래픽 데스크톱과 일부 문서·미디어 도구가 없습니다. 특정 프로그램이나 외부 서비스가 필요한 Skill은 해당 SKILL.md에 적힌 의존 프로그램과 인증 정보도 확인해야 합니다.

준비 상태와 실행 허용 여부도 다릅니다. Guide의 기능 사용 조건은 Agent의 도구뿐 아니라 파일 접근 권한, AI 연결과 조직 정책을 확인하도록 안내합니다. 도구가 보여도 지금 맡길 작업이 허용된다는 뜻은 아닙니다.

확인할 것	Agent에게 받을 근거	부족할 때 할 일
필요한 도구와 프로그램	현재 사용할 수 있는 수단과 확인 결과	대상 Agent와 필요한 작업을 관리자에게 전달합니다
자료 접근과 연결	허용된 자료를 읽을 수 있는지, 연결이 필요한지	자료 위치·접근 범위를 확인하고 비밀값 없이 필요한 연결을 요청합니다
실행 범위와 정책	허용된 행동과 실행하지 않을 행동	승인 주체와 범위를 정한 뒤 진행합니다
결과물과 완료 기준	받을 파일, 확인 방법, 미실행 항목	결과물 전달 방법까지 정하고 작은 작업으로 시험합니다

이 표는 요청을 정리하는 서식입니다. 제품에 같은 이름의 상태 화면이나 자동 점검표가 있다는 뜻은 아닙니다.

확인 요청과 실제 작업을 나누세요

Room은 사용자와 Agent가 같은 대화 맥락에서 협업하는 공간입니다. 공식 Guide는 작업 요청과 확인을 대상 Agent가 참여한 Chat Room에서 진행하도록 안내합니다. Cloud Portal의 Agent 상세에 있는 Conversations는 읽기 전용 기록이며 요청을 보내는 곳이 아닙니다. 여기서는 Portal의 문서화된 역할만 설명하며, Agent Control UI에 같은 메뉴나 준비 상태 화면이 있다고 가정하지 않습니다.

먼저 어떤 일을 하려는지와 어디까지 확인해도 되는지를 적습니다. 이어서 Agent가 확인한 근거와 확인하지 못한 부분을 받으세요. 단순히 “가능합니다”라는 답만으로 작업을 시작하지 말고, 필요한 자료에 실제로 접근했는지와 추가 변경이 필요한지를 구분합니다.

가상 예시 — 아래 요청과 결과는 설명용이며 실제 실행 기록이나 제품 화면이 아닙니다. 이미 허용된 작업 공간에 비민감 문서 두 개가 있는 상황을 가정합니다.

제공한 weekly-a.md와 weekly-b.md를 이 Agent에서 읽을 수 있는지 먼저 확인해 주세요. 두 파일의 접근 여부와 요약에 쓸 수단만 알려 주세요. 원본 수정, 설치, 삭제, 외부 서비스 전송은 하지 마세요. 읽을 수 없는 파일이 있으면 추측하지 말고 멈춰 주세요.

가상 확인 결과는 다음처럼 채울 수 있습니다.

항목	가상 확인 결과
자료 접근	weekly-a.md와 weekly-b.md를 모두 읽었습니다
사용 수단	현재 사용 가능한 파일 읽기 도구로 내용을 확인했습니다
변경·연결	원본을 바꾸지 않았고 추가 설치나 외부 서비스 연결은 하지 않았습니다
남은 일	요약은 아직 작성하지 않았습니다. 출력 파일명과 범위 확인을 기다립니다

두 파일이 맞고 범위도 맞다면 다음 작업을 요청합니다.

두 문서에 적힌 결정 사항과 미결 항목만 weekly-summary.md로 정리해 주세요. 항목마다 원본 파일명을 붙이고, 원본에 없는 내용은 추가하지 마세요. 원본 수정과 외부 서비스 전송은 금지합니다. 결과는 이 Room의 Chat artifact 또는 첨부로 전달하고, 실제 변경과 확인하지 못한 항목도 알려 주세요.

가상 결과 표본: weekly-summary.md에는 “결정: 검토 회의를 화요일에 진행 — 출처: weekly-a.md”와 “미결: 다음 자료의 제출 담당자 미정 — 출처: weekly-b.md” 두 항목이 담겼습니다. Agent는 요약 파일만 새로 작성했고 원본 두 개는 바꾸지 않았으며, 외부 서비스로 전송하지 않았다고 보고했습니다. 이 내용과 변경 보고는 모두 예시이지 실행 증거가 아닙니다.

성공 여부는 독자가 확인합니다. 전달된 파일의 이름과 내용을 열어 보고, 두 항목을 각 원본과 대조하세요. 원본이 그대로인지, 추가 파일이나 외부 동작이 없었는지는 Agent의 변경·검증 보고와 허용된 확인 수단으로 점검합니다. 보고만으로 확인할 수 없다면 그 항목은 미확인으로 남깁니다.

파일을 읽지 못했거나 출처가 맞지 않으면 완료로 보지 않습니다. 해당 항목을 보류하고 자료 위치나 접근 권한을 바로잡은 뒤 다시 확인하세요. 필요한 도구가 없다는 이유로 설치하거나 다른 서비스에 자료를 보내도록 요청 범위를 자동으로 넓히지 않습니다.

실행 환경을 바꾸기 전에 필요한 작업을 설명하세요

이미지(image)는 Agent가 실행되는 기본 환경 묶음입니다. 공식 Guide는 브라우저 조작은 full 이미지에서, 명령줄(CLI) 작업은 full 또는 lite 이미지에서 사용한다고 설명합니다. lite에는 Chromium, 그래픽 데스크톱과 VNC/noVNC 같은 화면 접근 구성 요소가 없으므로 그래픽 브라우저 작업용으로 선택하지 않습니다.

이미지 선택은 플랫폼 최고 관리자가 제어하며 일반 사용자는 사용 가능한 full 이미지가 기본 선택됩니다. 생성된 Agent가 lite이거나 브라우저 준비 상태 확인에 실패했다면, 대상 Agent와 필요한 작업을 정리해 플랫폼 최고 관리자에게 조정을 요청하세요. full이라는 이름만으로 특정 사이트 접근이나 업무용 계정 연결까지 보장되지는 않습니다.

Guide는 cli-anything Skill이 full과 lite 이미지에 기본 포함된다고 설명합니다. 이것도 특정 프로그램이나 외부 서비스가 모두 준비됐다는 뜻은 아닙니다. 개별 Skill의 요구사항과 현재 Agent의 확인 결과를 함께 보세요.

문서에 없다는 이유만으로 기능이 불가능하다고 단정하지도 마세요. 기능 사용 조건 Guide는 문서가 전체 도구·권한 목록이 아니며, 현재 Agent가 안전하게 확인할 수 있고 사용자 권한과 조직 정책이 허용하는 범위에서 판단할 수 있다고 설명합니다. 반대로 문서에 있는 기능도 현재 준비 상태를 확인하지 못했다면 실행 가능하다고 단정하지 않습니다. 설치·제거가 필요하다면 현재 지원되는 절차와 권한을 먼저 확인하세요. 이 글은 설치·제거 절차를 제시하지 않습니다.

비밀정보와 외부 동작의 경계를 요청에 적으세요

인증 정보는 조직에서 승인한 연결·보관 절차로 다루고, 비밀값을 Skill 패키지나 공유 대화에 복사하지 마세요. 준비 상태 보고에는 값 자체가 아니라 연결의 필요 여부와 확인 결과만 받습니다.

공식 Guide는 삭제 명령(rm), 인증 정보 변경, 패키지 설치, 배포, Git push, 외부 API 호출처럼 영향이 큰 동작을 요청에 명시하고 실행 전에 다시 확인하도록 안내합니다. API 호출은 다른 서비스에 요청을 보내는 동작입니다. 결제, 계정 변경, 메시지 전송, 파일 업로드·다운로드도 실행 직전 확인 범위를 정하세요. 요청 문장은 조직의 권한 정책이나 실제 접근 제한을 대신하지 않습니다.

브라우저 작업에는 별도 주의가 필요합니다. Guide는 Cloud가 전용 브라우저 프로필의 생성·선택·회수 전 과정을 제공하지 않는다고 설명합니다. 기존 로그인 상태, 쿠키와 다운로드 파일은 민감한 데이터로 취급하고 개인용 브라우저 프로필이나 비밀번호 관리자를 공유하지 마세요.

결과물은 Chat artifact나 Chat·Task 첨부로 받도록 요청하고 파일명과 내용을 확인합니다. artifact는 대화와 분리해 확인할 수 있는 산출물입니다. Guide는 Agent 작업 공간의 파일을 Portal Documents에서 직접 미리보기·다운로드하는 고객용 경로가 확인되지 않았다고 명시합니다. 이를 모든 파일 전달 방법이 없다는 뜻으로 확대해서 읽지 마세요. 필요 없어진 민감 결과물은 조직의 보존 정책에 따라 정리합니다.

실패 원인을 단정하지 말고 다음 확인 하나를 정하세요

실패를 공유할 때는 수행한 단계, 대상 URL 또는 허용된 작업 공간 경로, 오류의 비민감 요약, Agent 상태를 먼저 정리하세요. 경로나 URL에도 민감한 식별자가 있으면 가립니다. 비밀값, 브라우저 쿠키와 전체 터미널 로그를 공유하지 않습니다.

도구 부재, 접근 권한, 연결 상태, 정책과 요청 범위는 서로 다른 확인 항목입니다. 오류 하나만 보고 어느 항목이 원인이라고 단정하지 마세요. 오늘 맡길 작업 하나를 골라 준비된 것·확인하지 못한 것·다음 행동을 먼저 받아 보세요. 그 답과 작은 결과물 검증을 팀의 다음 요청 서식으로 남기면 됩니다.

Sources

• ClawPod Guide — Skills와 도구: 실행 환경별 차이, 작업 범위와 비밀정보 경계.
• ClawPod Guide — Agent에게 Browser와 CLI 작업 요청하기: 이미지 조건, 추가 요구사항, 실행 전 확인, 결과물 전달과 실패 공유.
• ClawPod Guide — 기능 사용 조건: 도구·권한·연결·정책의 구분과 문서에 없는 기능의 판단 경계.
• ClawPod Guide — Chat Room에서 Agent와 협업하기: Room의 역할, 요청에 넣을 정보와 결과물 확인.