홈 서버에서 Open WebUI 코딩 에이전트 예약 실행하는 방법

Open WebUI v0.13.3에서는 선택한 터미널과 작업 디렉터리에서 코딩 에이전트를 예약 실행할 수 있습니다. 폐기 가능한 체크아웃에서 보고서만 작성하는 작업으로 시작하세요. 확인된 테스트 명령을 실행하고, 실패 내용을 요약한 뒤 결과를 채팅으로 보내도록 하세요. 이 테스트를 통해 반복 작업에 중요한 파일에 대한 접근 권한을 부여하기 전에 스케줄러, 권한, 결과 전달 경로를 검증할 수 있습니다.

호환되는 Open WebUI 설치본, 사용할 에이전트를 제공하는 연결 가능한 터미널 통합 기능, 그리고 접근 가능한 작업 공간이 필요합니다. v0.13.3 릴리스 노트에 따르면 예약 실행 시 저장된 터미널과 에이전트를 여전히 사용할 수 있는지 확인합니다. 터미널, 파일 시스템, 기반 모델 연결을 설정의 서로 다른 요소로 다루세요.

11월 릴리스에서 무엇이 바뀌었나요?

자동화 편집기에서 터미널과 디렉터리를 선택한 다음, 해당 터미널에서 제공하는 에이전트를 선택할 수 있습니다. 설정된 터미널과 폴더는 예약 실행에도 적용됩니다. 에이전트 자동화 결과는 채팅으로 전송되지만, 다른 유형의 자동화는 대상 옵션이 다를 수 있습니다. 앞서 나온 v0.13.1 릴리스에서는 연결된 터미널이 코딩 에이전트를 제공할 경우 모델 선택기에 해당 에이전트가 표시되도록 했습니다.

선택한 터미널은 Open WebUI와 동일한 호스트에서 실행되거나, 연결 가능한 별도 서비스일 수 있습니다. 작업에서 중요한 것은 터미널의 파일 시스템입니다. 노트북에 표시되는 디렉터리가 컨테이너에는 없을 수 있습니다. 한 터미널에서 사용할 수 있는 파일이 다른 터미널에는 없을 수도 있습니다. 자동화에 선택한 바로 그 터미널에서 경로를 확인하세요.

작업 공간은 어떻게 준비해야 하나요?

전용 테스트 체크아웃을 만드세요. 프로덕션 비밀 정보가 없는 소규모 저장소라면 더욱 좋습니다. 확인된 리비전을 고정하고, 설정에 정상적으로 통과하는 테스트와 실패하는 것으로 알려진 테스트를 하나씩 넣으세요. 첫 보고서에서는 테스트 실행기가 지원하는 경우 입력 체크아웃을 읽기 전용으로 제공하세요. 테스트 캐시와 로그를 저장할 쓰기 가능한 임시 위치를 마련하세요. 일부 빌드 도구는 트리에 쓰기를 해야 하므로, 다른 위치에 쓰도록 설정하거나 쓰기가 가능한 임시 복사본을 사용하세요.

여러 작업에서 하나의 저장소를 공유한다면 에이전트나 작업마다 워크트리를 하나씩 만드세요. 백업과 작업 디렉터리는 분리하세요. 파일 서버에 광범위한 쓰기 권한을 부여하기 전에 공유 접근으로 백업이 실패할 수 있는 이유를 읽어 보세요.

첫 예약 작업은 어떻게 설정하나요?

에이전트 자동화를 지원하는 버전에서 자동화 편집기를 여세요. 터미널을 선택한 다음 해당 터미널에서 볼 수 있는 디렉터리를 선택하고 에이전트를 고르세요. 설치 환경에서 일회성 예약 실행을 선택할 수 있다면, 첫 테스트에는 가까운 시각으로 한 번만 실행되도록 예약하세요. 설정한 시간대를 기준으로 예약 시각을 확인하세요. 에이전트 및 배포 환경에서 사용할 수 있는 설정으로 실행 시간이나 단계 수를 적절히 제한하세요.

작업에 구체적인 입력, 명령, 결과 형식을 지정하세요. 예를 들면 다음과 같습니다.

선택한 작업 디렉터리의 체크아웃을 살펴보세요.
기존 로컬 스모크 테스트 명령을 한 번 실행하세요.
명령, 종료 상태, 처음 실패한 테스트를 보고하세요.
명령이나 폴더를 사용할 수 없으면 해당 실패를 보고하세요.
종속 항목을 설치하거나, 저장소를 변경하거나, 외부 서비스에 연결하지 마세요.

지침은 에이전트를 안내합니다. 터미널과 컨테이너 설정을 통해 파일 시스템 및 네트워크 경계를 별도로 적용하세요. 누락된 종속 항목이 예기치 않게 설치되는 대신 명확한 오류로 이어지는지 확인하세요. 터미널 및 관리자 설정은 Open WebUI 문서에서 확인할 수 있습니다.

첫 실행 후 무엇을 확인해야 하나요?

결과 채팅을 열어 에이전트 ID, 작업 경로, 테스트 명령, 종료 상태, 테스트한 리비전을 확인하세요. 같은 터미널에서 같은 명령을 직접 실행한 결과와 비교하세요. 자동화가 완료되었다는 사실은 워크플로가 끝났다는 것만 보여 줍니다. 보고서에는 의도한 테스트가 실제로 실행되었다는 증거가 여전히 필요합니다.

일부러 실패 경로를 테스트하세요. 테스트 작업에 문제가 없는 존재하지 않는 입력을 지정하거나, 일회용 터미널을 잠시 중지하고 결과 상태를 확인하세요. 테스트 후에는 복구하세요. 작업자는 전체 채팅 기록을 읽지 않고도 에이전트에 연결할 수 없는 상태, 디렉터리 누락, 테스트 실패, 모델 시간 초과를 구분할 수 있어야 합니다. 다음에 정상적인 작업을 실행할 때 이전 결과가 실수로 재사용되지 않는지 확인하세요.

셀프 호스팅한 Open WebUI는 코드를 로컬에 보관하나요?

Open WebUI와 해당 터미널은 자체 호스팅할 수 있지만, 선택한 코딩 에이전트는 원격 모델을 사용할 수 있습니다. 에이전트가 시스템 프롬프트, 파일 발췌 내용, 테스트 로그를 어디로 보내는지 확인하세요. 비공개 체크아웃에 연결하기 전에 에이전트의 제공업체 설정을 확인하세요. 제공업체 자격 증명은 서비스에서 지정한 비밀 정보 설정에 저장하고 프롬프트나 로그에 포함하지 마세요.

외부 처리가 금지된 요구 사항이라면 로컬 모델 엔드포인트부터 시작하세요. 엔드포인트와 에이전트의 폴백 구성을 확인한 다음 터미널에 적용되는 네트워크 제한도 확인하세요. 노출을 줄이는 방법은 이 AI 취약점 분류 및 비밀 정보 가이드를 참조하세요.

보고서만 작성하는 작업을 정기 워크플로로 전환하려면 어떻게 해야 하나요?

첫 실행의 성공과 실패를 모두 이해할 수 있게 되면, 같은 디렉터리를 사용하는 다른 작업과 겹치지 않는 정기 일정을 추가하세요. 보고서에는 타임스탬프와 저장소 리비전을 표시하세요. 알림은 간단하게 유지하세요. 조치가 필요한 실패를 알리고 재현에 필요한 맥락을 충분히 보존하세요. 업그레이드 후에도 에이전트 자격 증명, 터미널 연결, 예약된 디렉터리가 계속 작동하는지 주기적으로 확인하세요.

나중에 패치를 허용하더라도 격리된 브랜치에서 작업하고 병합 전에 검토를 거치도록 하세요. 그렇지 않으면 스케줄러가 재시도하면서 부수 효과가 중복될 수 있습니다. 보고서 작업은 결과만 작성하므로 재시도가 더 간단하지만, 종속성 업데이트와 배포 명령은 상태를 변경합니다. 이를 별도의 권한 결정으로 다루세요.

자주 묻는 질문

에이전트 자동화는 어느 버전에 추가되었나요?

관련 기능은 Open WebUI v0.13.3에 명시되어 있습니다. v0.13.1의 에이전트 선택 기능은 관련은 있지만 별개의 기능입니다.

에이전트가 선택 목록에 표시되지 않는 이유는 무엇인가요?

선택한 터미널에 접속할 수 있고 해당 에이전트를 제공하는지 확인하세요. 설치된 버전과 계정 권한에서 이 기능을 사용할 수 있는지도 확인하세요.

노트북에서 폴더를 선택할 수 있나요?

작업을 실제로 실행할 터미널의 경로를 선택하세요. 필요한 경우 먼저 체크아웃을 해당 위치에 마운트하거나 복사하세요.

자동화 결과는 채널로 전달되나요?

v0.13.3 노트에는 에이전트 자동화의 전달 방식으로 채팅이 명시되어 있습니다. 해당 채팅 이외의 대상으로 전달할 수 있다고 기대하기 전에 현재 버전의 옵션을 확인하세요.

두 실행이 겹치면 어떻게 해야 하나요?

별도의 워크트리를 사용하거나 실행 일정과 런타임 예산을 조정해 작업이 겹치지 않도록 하세요. 잘못된 리비전을 사용한 실행은 보고서를 신뢰하기 전에 확인하세요.

결론

터미널 하나, 범위를 제한한 작업 디렉터리 하나, 보고서만 작성하는 간단한 작업 하나로 전체 과정을 검증하세요. 모델 제공업체를 확인하고, 성공과 실패를 모두 테스트하고, 프로덕션 자격 증명은 터미널 밖에 보관하세요. 결과가 반복해서 동일하게 나오면 같은 설정으로 정기적인 저장소 검사도 처리할 수 있습니다.