에이전트를 위한 안정적인 서식지.

워커를 의사 결정과 분리하세요

에이전트가 작업을 계획하는 동안 큐가 워커의 실행 시점을 제어할 수 있습니다. 이렇게 하면 재시도가 가시화되고, 짧은 API 장애가 중복 작업으로 이어지는 것을 방지할 수 있습니다. 각 작업에 식별자를 부여하고 중요한 상태 전환을 기록하세요.

도구를 권한으로 취급

이메일을 보내거나, 비용을 지출하거나, 프로덕션에 기록할 수 있는 프로세스에는 연구 작업자보다 더 좁은 자격 증명이 필요합니다. 별도의 서비스 계정, 도구별 권한, 중대한 작업에 대한 명시적 승인 단계를 사용하세요. 프롬프트나 브라우저에서 접근 가능한 파일에 개인 키를 절대 두지 마세요.

• 비밀 정보를 웹 루트와 버전 관리 외부에 보관하세요
• 외부 API에 지출 및 요청 한도를 적용하세요
• 불필요한 개인 데이터를 저장하지 않고 감사 가능한 기록 유지

중지된 프로세스를 고려한 설계

서비스 관리자 또는 컨테이너 런타임, 상태 확인 및 제한된 재시작 정책을 사용하세요. 에이전트는 마지막 외부 작업을 무작정 반복하지 않고 저장된 상태에서 재개해야 합니다. 프로세스 존재 여부뿐 아니라 디스크 증가, 대기열 경과 시간 및 오류율을 모니터링하세요.

머신 규모 적정화

원격 모델을 호출하는 워커는 보통 적당한 CPU와 도구 실행에 충분한 메모리가 필요합니다. 브라우저 자동화는 훨씬 더 많은 RAM를 사용할 수 있습니다. 로컬 모델 추론은 별도의 메모리 및 가속기 요구 사항이 있으며, 일반적인 VPS가 GPU 탑재를 의미하지는 않습니다.

프로비저닝 워크플로 설계

에이전트 통합 워크플로는 공개 요금제를 조회하고, 계정을 등록하며, 명시된 지출 한도 내에서 서비스 주문을 준비할 수 있습니다. 결제와 서버 생성에는 적절한 권한이 필요합니다. 작업 식별자를 부여받아 완료 상태를 기다린 후 자체 공개 SSH 키로 서버를 관리해야 합니다. 해제는 의도적으로 수행하고 필요한 결과를 보존해야 합니다.

조급한 폴링 대신 이벤트

서명된 웹훅은 결제 정산 및 수명 주기 변경을 보고할 수 있습니다. 다음 조치를 취하기 전에 진위 여부를 확인하고, 중복 전송을 제거하며, API와 대조하십시오. 제공자는 에이전트의 비공개 SSH 키, 지갑 시드 또는 제한 없는 모델 자격 증명을 받아서는 안 됩니다.

하나의 작업을 하나의 지속적인 운영으로 전환

각 작업에 안정적인 식별자와 대기 중, 실행 중, 승인 대기 중, 완료됨 또는 실패함과 같은 명시적 상태를 부여하세요. 외부 작업의 결과를 플래너에게 확인 응답하기 전에 저장하세요. 재시작된 워커는 터미널 출력이 손실되었다는 이유로 결제, 메시지 또는 프로덕션 쓰기를 재생하지 말고 저장된 상태를 검사해야 합니다.

프로비저닝 도구와 호스팅 워커는 별도 제품입니다

VPS은(는) 자체 서비스 관리자와 자격 증명을 사용하여 고객의 에이전트를 지속적으로 실행할 수 있습니다. 호스팅 제어 평면의 API 또는 MCP 엔드포인트는 다른 통합입니다. 첫 번째는 애플리케이션으로 배포할 수 있지만, 두 번째는 별도로 릴리스된 KoalaVPS 제어 평면 통합이 필요하며 이 문서로는 연결되지 않습니다.

전체 워커에 대한 예산을 책정하세요

브라우저, 모델 클라이언트, 큐 및 데이터베이스를 함께 고려하여 메모리를 확보하세요. API 기반의 소규모 워커는 적당한 CPU만 필요할 수 있지만, 동시 브라우저 세션은 RAM를 빠르게 소진합니다. 머신 크기를 늘리기 전에 큐 동시성과 외부 API 지출 한도를 설정하세요. 모델 구독, 가속기 또는 제3자 API 허용량은 암묵적으로 포함되지 않습니다.

유용한 운영 인수인계

시작 명령, 작업 디렉터리, 보호된 환경 위치, 재시작 정책, 큐 스토리지, 상태 확인 및 각 외부 자격 증명의 소유자를 기록하세요. 새 작업을 안전하게 중지하는 조치와 미완료 작업을 재개하는 경로를 포함하세요. 모니터링은 중단된 프로세스뿐 아니라 지연되거나 중복된 작업도 식별해야 합니다.

조금 더 명확하게.