rdp-cli
내 컴퓨터를 점유하지 않고 AI Agent를 백그라운드에서 실행하는 방법
내 컴퓨터를 점유하지 않고 AI Agent를 백그라운드에서 실행하는 방법
AI Agent를 로컬 컴퓨터에서 실행하면 현재 창을 바꾸거나 마우스를 움직이고, 잘못된 앱에 텍스트를 입력할 수 있습니다.
해결 방법은 Agent에게 별도의 원격 세션을 제공하는 것입니다.
rdp-cli를 사용하면 AI Agent가 인증된 RDP, VNC, X11 또는 Android 세션을 로컬 데스크톱 뷰어 없이 제어할 수 있습니다. 사용자는 자신의 컴퓨터를 계속 사용하고, 필요할 때만 같은 세션을 확인하거나 일시 중지하거나 직접 제어할 수 있습니다.
빠른 답변: AI Agent를 백그라운드에서 실행하려면?
로컬 화면 대신 별도의 원격 데스크톱 세션에 Agent를 연결하세요. Agent는 rdp-cli로 스크린샷을 캡처하고, 마우스와 키보드 입력을 보내고, 파일을 전송하고, 결과를 확인할 수 있습니다. 사람이 검토하거나 제어해야 할 때만 GUI 또는 Web Viewer를 열면 됩니다.
여기서 백그라운드 실행은 Agent가 별도의 원격 세션에서 작동한다는 뜻입니다. rdp-cli가 시스템 서비스, 예약 작업 또는 클라우드 컴퓨터를 만든다는 뜻은 아닙니다.
왜 AI Agent를 백그라운드에서 실행해야 하나요?
로컬 데스크톱을 공유하면 사용자와 Agent가 같은 입력을 사용하게 됩니다. 예를 들어 사용자가 코드를 작성하는 동안 Agent가 Excel을 열거나 Windows 설치 프로그램을 테스트하거나 사내 ERP를 조작할 수 있습니다.
별도의 원격 세션을 사용하면 Agent는 다른 컴퓨터에서 작동하고, 로컬 앱은 포커스를 유지합니다. API가 없는 레거시 Windows 앱, GUI 테스트, 보고서 처리, 장시간 자동화, Android ADB 작업, Linux X11 앱에 적합합니다.
로컬 데스크톱과 원격 세션 비교
| 항목 | 로컬 데스크톱 | rdp-cli 원격 세션 |
|---|---|---|
| 입력 충돌 | 현재 작업 화면을 공유 | 로컬 입력에 영향을 주지 않음 |
| 뷰어 필요 여부 | 자동화 도구에 따라 다름 | 일반 명령에는 필요 없음 |
| 사람의 제어 | 현재 화면을 직접 사용 | 같은 원격 세션에 참여 |
| 적합한 작업 | 짧고 감독하는 작업 | 원격 및 장시간 GUI 작업 |
시작 전 준비 사항
인증된 원격 장치, RDP 또는 VNC 서버, X11 환경 또는 Android 장치, 실행 환경에 맞는 rdp-cli, 명령과 스크린샷을 읽을 수 있는 AI Agent를 준비합니다.
RDP 대상 Windows는 원격 데스크톱을 허용해야 합니다. VNC는 기존 VNC Server가 실행 중이어야 하며, Android는 USB 또는 Wi-Fi 디버깅 승인이 필요합니다.
rdp-cli는 원격 컴퓨터를 만들거나 호스팅하지 않습니다. 이미 존재하고 사용 권한이 있는 장치가 필요합니다.
자세한 내용은 rdp-cli 빠른 시작을 참고하세요.
rdp-cli로 AI Agent를 백그라운드에서 실행하기
1단계: rdp-cli 설치
AI Agent를 실행하는 컴퓨터와 CPU에 맞는 파일을 다운로드합니다.
.\rdp-cli.exe --help
macOS 또는 Linux:
rdp-cli --help
원격 비밀번호를 명령줄에 직접 넣지 마세요.
2단계: 원격 세션 연결
기존 Windows RDP 서버에 연결하는 예시입니다.
.\rdp-cli.exe connect `
--host REMOTE_HOST `
--user REMOTE_USER `
--password-stdin
반환된 session ID를 저장합니다. 이 ID는 스크린샷, 입력, 파일 전송과 세션 제어에 사용됩니다. 이 연결에는 로컬 RDP Viewer가 필요하지 않습니다.
3단계: 원격 화면 캡처
작업 전에 현재 화면을 캡처합니다.
.\rdp-cli.exe screenshot `
--session SESSION `
--out .\before.png
Agent는 앱이 준비됐다고 가정하지 말고 최신 스크린샷을 확인해야 합니다.
4단계: 한 번에 하나의 동작 실행
최신 observation을 사용해 클릭합니다.
.\rdp-cli.exe click `
--session SESSION `
--desktop `
--x X `
--y Y `
--observation OBSERVATION
재연결, 레이아웃 변경 또는 사람의 제어 이후에는 새 스크린샷과 observation을 받아야 합니다.
5단계: 결과 확인
입력 명령이 성공했다는 것은 입력이 전송됐다는 뜻일 뿐입니다.
화면 캡처 → 한 동작 실행 → 새 화면 캡처 → 결과 확인
Save를 누른 뒤 확인 메시지, 새 레코드 번호, 상태 변화, 표의 변경 또는 출력 파일을 확인합니다. 예상 결과가 없으면 추가 클릭을 멈추고 현재 화면을 확인합니다.
자세한 명령은 rdp-cli 명령 문서에서 확인할 수 있습니다.
로컬 화면을 열지 않고 파일 전송하기
원격 Agent는 프로젝트 폴더, Excel, PDF 또는 테스트 파일을 처리해야 할 수 있습니다. 지원되는 RDP 세션에서는 파일을 교환할 수 있지만 원격 서버가 필요한 리디렉션을 허용해야 합니다. 전송이 완료된 뒤 파일을 확인하세요.
GUI 또는 Web Viewer는 언제 사용하나요?
일반적인 Agent 명령에는 Viewer가 필요하지 않습니다. 작업을 확인하거나, 오류 화면을 조사하거나, 보안 확인을 승인하거나, 원격 마우스와 키보드를 직접 사용해야 할 때 같은 세션을 엽니다.
Web Viewer는 LAN 또는 VPN을 통한 인증된 접근용입니다. 공개 rdp-cli 홈페이지가 세션 Viewer는 아닙니다.
사람의 제어 전환
Agent 작업 → 사람의 입력 일시 중지 → 사람의 제어 → 원격 화면 수정 → 제어 해제 → Agent가 새 스크린샷 확인 → 계속 작업의 순서로 진행합니다.
사람이 조작한 뒤에는 이전 스크린샷이나 observation을 재사용하지 마세요. 자세한 내용은 AI Agent 원격 데스크톱 보기, 일시 중지 및 제어 전환을 참고하세요.
rdp-cli가 하지 않는 일
rdp-cli는 원격 제어 계층이며 AI 모델이나 작업 추론을 포함하지 않습니다. 클라우드 컴퓨터를 자동으로 만들지 않으며 API 테스트나 단위 테스트를 대체하지도 않습니다.
FAQ
AI Agent가 창을 열지 않고 원격 데스크톱을 제어할 수 있나요?
예. 인증된 RDP, VNC, X11 또는 Android 세션에 연결해 로컬 Viewer 없이 명령을 보낼 수 있습니다.
rdp-cli가 로컬 마우스와 키보드를 점유하나요?
아니요. Agent는 원격 세션을 조작하므로 로컬 입력은 계속 사용할 수 있습니다.
rdp-cli에 AI 모델이 포함되어 있나요?
아니요. rdp-cli는 연결, 스크린샷, 입력, 파일 전송과 세션 제어를 제공합니다. 추론은 선택한 AI Agent가 담당합니다.
Agent가 작업 중일 때 사람이 제어할 수 있나요?
예. 같은 세션을 GUI 또는 Web Viewer에서 열고 Agent 입력을 일시 중지한 뒤 제어를 넘겨받을 수 있습니다.
rdp-cli가 원격 Windows 컴퓨터를 만들어 주나요?
아니요. RDP가 활성화된 기존 Windows 컴퓨터가 필요합니다.
마무리
AI Agent에 별도의 원격 작업 공간을 제공하면 자신의 컴퓨터를 계속 사용하면서 Agent를 실행할 수 있습니다.
rdp-cli 다운로드로 Agent에게 독립적인 원격 데스크톱을 제공해 보세요.