큐와 검토

큐는 URL이나 레코드를 순서대로 또는 여러 워커에서 병렬로 처리하기 위한 작업 목록입니다. Guida에서는 큐를 스크립트에서 다룰 수 있을 뿐 아니라 Queue Console에서 운영 상태를 직접 확인할 수 있습니다.

Queue Console이 다루는 것

큐별 pending, in-flight, completed, failed 수
보류 항목과 페이로드 세부 정보
데드 레터 항목 확인
워커 시작, 중지, 상태 확인
재시도, 폐기, 복구를 위한 작업
Workflow Ledger와의 관련성

기본 흐름

스크립트 또는 MCP 도구로 항목을 큐에 넣음
워커 또는 수동 스크립트가 항목을 꺼냄
처리가 성공하면 완료로 기록
실패하면 재시도하거나 데드 레터로 보냄
Queue Console과 Workflow Ledger Console에서 상태 확인

g.queue.enqueue("urls", { url: "https://example.com" });

const item = g.queue.dequeue("urls");
if (item) {
  await g.nav.navigateToUrl(item.data.url);
  await g.dom.waitForDomStable();
  g.queue.commit(item.id);
}

대상을 한정한 삭제

Remote Ops 삭제는 한 항목을 정확히 지정하고 미리 확인하도록 설계되어 있습니다. queues.items.delete.preview에 큐 이름, pending 항목의 안정적인 ID, 운영자 사유를 전달하면 대상 항목, 현재 수, 삭제 가능 여부, 확인 문구, 짧은 시간 동안 유효한 previewHash가 반환됩니다. 그다음 같은 큐 이름, 항목 ID, 사유, 해시와 confirm: true를 queues.items.delete에 전달합니다.

이 변경 작업은 pending 항목 한 개만 삭제합니다. 와일드카드나 일괄 비우기는 지원하지 않습니다. 미리보기가 오래됐거나 항목 상태가 바뀌면 충돌로 처리되며, Remote Ops 로컬 정책이 작업을 거부할 수도 있습니다. 데드 레터 항목 재시도는 별도의 복구 판단입니다.

검토와 복구

큐 처리가 항상 완전 자동으로 끝나지는 않습니다. 사이트 변경, 시간 초과, 인증, 데이터 누락 등으로 실패한 항목은 Queue Console에서 페이로드를 확인하고 재시도나 폐기를 판단할 수 있습니다.