에이전트 워커
내가 가진 컴퓨터에서 자동화를 실행하세요
에이전트 워커는 내 컴퓨터나 서버에 설치하는 하나의 프로그램입니다. UIA 계정으로 한 번 로그인한 뒤 태스크와 잡이 도착하기를 기다립니다. 브라우저는 워커가 실행 중인 곳에서 열리며, 저희 서버에서는 열리지 않습니다.
- 버전
- 1.0.0
- 지원 환경
- Windows, macOS, Linux
다운로드
운영체제를 선택하세요
모든 빌드는 단독 실행 파일입니다. Python을 설치할 필요도, 직접 빌드할 필요도 없습니다.
Windows
Windows 10 이상, 64비트. Chrome 필요.
x64 다운로드agent-worker-1.0.0-windows-x64.zip
macOS
macOS 12 Monterey 이상. Chrome 필요.
Apple silicon 다운로드agent-worker-1.0.0-macos-arm64.zip
Linux
Ubuntu 20.04 이상 및 동등 배포판, 64비트. Chrome 필요.
x64 다운로드agent-worker-1.0.0-linux-x64.tar.gz
같은 컴퓨터에 Google Chrome이 설치되어 있어야 합니다. 워커는 자체 브라우저를 포함하지 않고 이미 설치된 Chrome을 사용합니다.
설치
다운로드부터 첫 실행까지
설정에는 2분정도 걸립니다. 워커를 처음 실행하면 몇 가지를 물어본 뒤 계정에 자신을 등록하고, 인증 정보를 암호화해 해당 컴퓨터에 저장합니다.
- 01
압축 풀기
압축 파일을 오른쪽 클릭해 '압축 풀기'를 선택하세요. 워커는 첫 실행 때 자신의 파일을 같은 자리에 설치하므로 계속 둘 폴더에 두세요.
- 02
실행 허용하기
Windows가 알 수 없는 개발자라고 경고할 수 있습니다. '추가 정보'를 누른 뒤 '실행'을 선택하세요. 아직 상용 인증서로 서명되지 않은 빌드입니다.
- 03
워커 실행
agent-worker.exe를 더블클릭하거나 압축을 푸 폴더에서 터미널로 실행하세요. 콘솔 창에 설치 마법사가 열립니다.
agent-worker.exe - 04
컴퓨터 등록
앱에서 알아볼 수 있는 워커 이름을 정한 뒤 UIA 아이디와 비밀번호로 로그인하세요. 워커는 이를 토큰으로 교환해 암호화해 두며, 비밀번호는 저장되지 않습니다.
- 05
정식으로 실행
설치가 끝나면 프로그램이 종료됩니다. 워커 이름을 붙여 다시 실행하면 서버에 연결되어 작업을 기다립니다. 몇 초 안에 워커 페이지에 대기 상태로 나타납니다.
agent-worker.exe my-worker
문제가 생기면
첫 실행에서 자주 겪는 문제
워커 페이지에 오프라인으로 표시됩니다
워커 프로세스가 아직 실행 중인지, 방화벽이 외부 WebSocket 연결을 허용하는지 확인하세요. 온라인으로 보이는데도 잡이 다른 곳에서 실행된다면 WORKER_HEARTBEAT_SECONDS를 20으로 설정하고 다시 시작하세요.
실행은 되는데 브라우저 작업이 바로 실패합니다
워커는 Google Chrome을 사용하므로 같은 컴퓨터에 Chrome이 설치되어 있어야 합니다. Chrome을 설치한 뒤 워커를 다시 시작하세요. 설치 경로가 일반적이지 않다면 CHROME_PATH에 실행 파일 경로를 지정하세요.
Windows나 macOS가 파일 열기를 거부합니다
아직 상용 인증서로 서명되지 않아 두 시스템 모두 알 수 없는 개발자라고 경고합니다. Windows에서는 '추가 정보' 후 '실행'을 선택하세요. macOS에서는 02단계처럼 격리 플래그를 해제하거나 개인정보 보호와 보안에서 '그대로 열기'를 사용하세요.