The agent inbox(에이전트 받은 편지함)는 머신이 절전 모드이거나 daemon이 오프라인이거나 에이전트가 이미 작업 중일 때 요청이 대기하는 에이전트별 큐입니다. 각 요청은 ID, 요청자, 승인 상태와 함께 보관되며, daemon이 복귀하면 순서대로 받은 편지함을 처리합니다. 노트북 덮개를 닫았다고 요청이 유실되지 않으며, daemon이 재시작되었다고 두 번 실행되지도 않습니다.
로컬 우선 에이전트는 장점에 대한 대가로 가용성을 치릅니다. 받은 편지함은 그 비용을 최소화하는 방법입니다.
받은 편지함에 들어가는 항목
예외 없이 모든 요청이 들어갑니다. 머신이 온라인 상태일 때도 요청은 런타임으로 전달되는 과정에서 받은 편지함을 거칩니다. 단지 큐가 비어 있었을 뿐입니다. 받은 편지함은 에이전트별로 분리되어 있습니다. 한 머신에 있는 두 에이전트는 두 개의 받은 편지함을 가지며 병렬로 실행됩니다. 하나의 에이전트는 받은 편지함을 한 번에 요청 하나씩 순차적으로 실행하므로, 작업 디렉터리가 두 실행에서 동시에 수정되는 일이 전혀 없습니다.
밤 사이의 받은 편지함: 승인된 세 개의 요청이 순서대로 대기 중이고, 하나는 여전히 소유자의 승인이 필요합니다. 머신이 깨어나 이를 순서대로 처리합니다.
순서와 상태
요청은 전송된 순서가 아니라 승인된 순서대로 실행됩니다. 상시 권한이 있는 사람의 요청은 도착 즉시 승인되어 자리를 잡습니다. 소유자의 승인을 기다리는 요청은 위치는 유지하되 승인될 때까지 건너뜁니다. 소유자는 실행 전에 받은 편지함의 항목을 삭제하거나 순서를 변경할 수 있습니다.
각 항목은 대기 중에도 자신의 상태를 유지합니다. pending(승인 필요), approved(머신 대기 중), 또는 running(머신이 절전 모드로 들어갈 때 실행 중이었음). 요청 ID와 재개 가능한 실행을 참고하세요.
깨어날 때
daemon이 복귀하면 작업을 폴링하고, 받은 편지함을 순서대로 수신한 뒤 다음을 수행합니다.
- 저장된 런타임 세션 참조를 사용해 머신이 절전 모드에 들어갈 때 실행 중이던 요청을 재개합니다. 동일한 ID, 동일한 세션이며 중복 실행 대신 타임라인에 공백이 생길 뿐입니다.
- 승인된 요청을 한 번에 하나씩 실행합니다.
- 소유자가 응답할 때까지 대기 중인(pending) 요청을 그대로 유지합니다.
TTL(기본값 24시간)보다 오래 응답이 없는 승인은 그때 만료되며, 요청은 오래된 채로 실행되는 대신 expired로 표시됩니다.
머신 연결 상태 유지하기
받은 편지함은 오프라인 상태를 안전하게 만들어 주지만, 속도를 빠르게 해 주지는 않습니다. 세 가지 습관으로 대기 시간을 줄일 수 있습니다.
muti service install로 daemon을 서비스로 설치합니다. 로그인 시 자동으로 시작되고 비정상 종료 후 재시작되므로 “daemon이 실행 중이지 않음”으로 인해 대기할 일이 사라집니다.- 데스크톱에서는 근무 시간 중 절전 모드를 비활성화하거나, 노트북을 전원에 연결하고 전원 공급 시 절전 모드로 전환되지 않도록 설정합니다. 덮개가 닫히면 에이전트는 오프라인 상태가 됩니다.
- 상태가 확실하지 않을 때는
muti status를 확인합니다. daemon 연결 여부와 마지막 폴링 시간을 확인할 수 있습니다.
요청자가 보는 화면
룸에 표시된 자신의 요청과 해당 ID, 그리고 상태(“queued, machine offline since 22:00” 또는 “waiting for Noah’s approval”)가 보입니다. 요청을 취소하거나 메시지를 덧붙일 수 있습니다. 실행이 시작되면 평소처럼 타임라인이 스트리밍됩니다. 누구도 다시 전송할 필요가 없습니다.
자주 묻는 질문
받은 편지함은 내 머신에 있나요, 아니면 룸에 있나요? 룸 서비스에 있습니다. 그렇기 때문에 머신이 꺼져 있어도 요청을 받을 수 있고, 소유자가 휴대전화에서 순서를 변경할 수도 있습니다.
받은 편지함을 비울 수 있나요? 네. 항목을 제거하면 해당 요청이 취소되며, 요청자에게는 cancelled로 표시됩니다.
머신이 며칠 동안 꺼져 있으면 어떻게 되나요? 요청은 대기합니다. 승인은 자체 TTL에 따라 만료되지만, 승인된 요청은 만료되지 않습니다. 단, 장기간 자리를 비우기 전에 소유자가 정리하고 싶을 수는 있습니다.
채팅 플랫폼을 통한 요청에도 동일하게 적용되나요? 네. Feishu나 Slack 멘션도 다른 요청과 마찬가지로 요청이 되어 동일한 받은 편지함에서 대기합니다. Feishu 설계를 참고하세요.
덮개를 닫으셔도 됩니다. 아침에도 요청은 그대로 남아 있습니다. 에이전트에게 룸을 만들어 주세요.
게시일