에이전트 승인함 UX: 무엇을 승인하는지 보이는 대기 화면

실행을 멈추는 기능 다음에 필요한 화면

LangChain의 Human-in-the-loop 문서는 도구 실행을 승인·수정·거절하는 결정을 다룹니다. LangGraph의 interrupts는 상태를 저장하고 외부 입력 후 재개하는 구조를 설명합니다. 이 문서들은 승인 대기를 구현할 기반이며 특정 업무에서 누가 무엇을 승인해야 하는지까지 정해 주는 제품 규정은 아닙니다.

• LangChain · Human-in-the-loop
• LangGraph · Interrupts

토핑의 제품 설계 관점에서는 승인함을 알림 목록이 아니라 실행 전 검토 화면으로 보는 것이 유용합니다. 단순히 ‘진행할까요?’라고 묻기보다 대상, 현재 상태, 바뀔 내용과 영향을 한 번에 보여줘야 합니다. 확인에 필요한 원문이 여러 화면에 흩어져 있으면 승인 버튼이 있어도 검토 품질을 보장하기 어렵습니다.

견적 발송 승인함을 만든다면

가상의 영업 에이전트가 고객에게 보낼 견적 초안을 만든다고 가정하겠습니다. 승인 카드에는 고객과 수신 주소, 품목·수량·총액, 유효기간과 첨부 문서 버전을 표시합니다. 기존 견적에서 달라진 조건을 강조하고 승인자가 원문을 열어 검토할 수 있게 하면, 문장을 예쁘게 썼는지보다 실제 거래 조건을 판단할 수 있습니다.

승인자가 금액을 수정했다면 원래 제안을 승인한 것으로 처리하지 않습니다. 수정본을 새 실행 대상으로 만들고 계산 결과와 첨부 자료가 일치하는지 확인합니다. 발송 주소나 거래 주체까지 바뀌면 승인 범위를 다시 검토해야 합니다. 변경 이력을 남겨야 작성자와 승인자의 결정이 뒤섞이지 않습니다.

대기·승인·실행 상태를 나눕니다

사용자가 버튼을 누르는 순간과 외부 시스템의 작업이 끝나는 순간은 다릅니다. 승인 접수 후 발송 API가 실패하면 ‘승인됨, 발송 실패’라고 표시해야 합니다. 승인 카드를 바로 목록에서 지우거나 완료로 바꾸면 담당자는 고객에게 문서가 전달된 것으로 오해할 수 있습니다. 재시도 가능 여부와 후속 담당자를 함께 보여주세요.

오래된 승인에는 유효기간이 필요합니다. 오전에 확보한 재고나 가격이 오후에도 같은지 확인하지 않고 실행하면 승인자가 본 조건과 실제 결과가 달라집니다. 대기 중인 요청과 실행하려는 요청의 버전이 일치하는지 서버에서 확인하고, 조건이 달라졌으면 차이를 보여준 뒤 판단을 다시 받습니다.

사람이 늦게 답하거나 두 번 누르는 상황

검수에는 두 담당자의 동시 승인, 휴대폰과 PC의 중복 클릭, 승인 후 권한 회수와 요청 취소를 포함합니다. 이미 결정된 요청에 다시 응답하면 기존 결정과 실행 상태를 안내해야 합니다. 거절 사유를 받은 에이전트가 이름만 바꾼 같은 작업을 다시 올리는지도 살펴보면 승인 피로를 줄이는 데 도움이 됩니다.

초기 도입에서는 승인 건수보다 판단에 필요한 정보가 빠진 요청, 만료 후 재검토, 실행 실패로 되돌아온 요청을 관찰하세요. 모든 조회에 승인을 붙이면 중요한 결정이 묻힐 수 있습니다. 업무 영향과 사전 위임 범위를 바탕으로 대기시킬 작업을 선택하고, 검토자는 실제 결과까지 추적할 수 있게 만드는 것이 목표입니다.