에이전트 워커

내가 가진 컴퓨터에서 자동화를 실행하세요

에이전트 워커는 내 컴퓨터나 서버에 설치하는 하나의 프로그램입니다. UIA 계정으로 한 번 로그인한 뒤 태스크와 잡이 도착하기를 기다립니다. 브라우저는 워커가 실행 중인 곳에서 열리며, 저희 서버에서는 열리지 않습니다.

버전
1.0.0
지원 환경
Windows, macOS, Linux

다운로드

운영체제를 선택하세요

모든 빌드는 단독 실행 파일입니다. Python을 설치할 필요도, 직접 빌드할 필요도 없습니다.

같은 컴퓨터에 Google Chrome이 설치되어 있어야 합니다. 워커는 자체 브라우저를 포함하지 않고 이미 설치된 Chrome을 사용합니다.

설치

다운로드부터 첫 실행까지

설정에는 2분정도 걸립니다. 워커를 처음 실행하면 몇 가지를 물어본 뒤 계정에 자신을 등록하고, 인증 정보를 암호화해 해당 컴퓨터에 저장합니다.

  1. 01

    압축 풀기

    압축 파일을 오른쪽 클릭해 '압축 풀기'를 선택하세요. 워커는 첫 실행 때 자신의 파일을 같은 자리에 설치하므로 계속 둘 폴더에 두세요.

  2. 02

    실행 허용하기

    Windows가 알 수 없는 개발자라고 경고할 수 있습니다. '추가 정보'를 누른 뒤 '실행'을 선택하세요. 아직 상용 인증서로 서명되지 않은 빌드입니다.

  3. 03

    워커 실행

    agent-worker.exe를 더블클릭하거나 압축을 푸 폴더에서 터미널로 실행하세요. 콘솔 창에 설치 마법사가 열립니다.

    agent-worker.exe
  4. 04

    컴퓨터 등록

    앱에서 알아볼 수 있는 워커 이름을 정한 뒤 UIA 아이디와 비밀번호로 로그인하세요. 워커는 이를 토큰으로 교환해 암호화해 두며, 비밀번호는 저장되지 않습니다.

  5. 05

    정식으로 실행

    설치가 끝나면 프로그램이 종료됩니다. 워커 이름을 붙여 다시 실행하면 서버에 연결되어 작업을 기다립니다. 몇 초 안에 워커 페이지에 대기 상태로 나타납니다.

    agent-worker.exe my-worker

문제가 생기면

첫 실행에서 자주 겪는 문제

워커 페이지에 오프라인으로 표시됩니다

워커 프로세스가 아직 실행 중인지, 방화벽이 외부 WebSocket 연결을 허용하는지 확인하세요. 온라인으로 보이는데도 잡이 다른 곳에서 실행된다면 WORKER_HEARTBEAT_SECONDS를 20으로 설정하고 다시 시작하세요.

실행은 되는데 브라우저 작업이 바로 실패합니다

워커는 Google Chrome을 사용하므로 같은 컴퓨터에 Chrome이 설치되어 있어야 합니다. Chrome을 설치한 뒤 워커를 다시 시작하세요. 설치 경로가 일반적이지 않다면 CHROME_PATH에 실행 파일 경로를 지정하세요.

Windows나 macOS가 파일 열기를 거부합니다

아직 상용 인증서로 서명되지 않아 두 시스템 모두 알 수 없는 개발자라고 경고합니다. Windows에서는 '추가 정보' 후 '실행'을 선택하세요. macOS에서는 02단계처럼 격리 플래그를 해제하거나 개인정보 보호와 보안에서 '그대로 열기'를 사용하세요.

워커를 설정하고, 실행할 일을 만들어 보세요