Human Approval UI는 AI가 사람의 판단을 요청할 때 보여주는 화면입니다. 승인 자체보다 중요한 것은 “무엇을 승인하는지"를 짧고 정확하게 보여주는 일입니다. 설명이 부족하면 사용자는 승인하지 못하고, 설명이 과하면 검토 시간이 길어집니다.
이 글은 Human in the Loop, AI Access Control, Enterprise AI Governance, Claude Code GitHub Actions와 함께 보면 좋습니다.
개요 #
승인 UI는 단순한 모달 창이 아니라 운영 정책의 일부입니다. 어떤 작업이 왜 멈췄는지, 어떤 결과가 예상되는지, 거절하면 다음에 어떻게 되는지를 한 화면에서 보여줘야 합니다.
왜 중요한가 #
- 승인 판단 시간을 줄일 수 있습니다.
- 사용자가 승인 위험을 이해하기 쉬워집니다.
- 반려와 재검토 흐름을 설계하기 좋습니다.
- 승인 기록을 운영 로그와 연결하기 쉽습니다.
승인 설계 #
승인 화면에는 최소한 다음 정보가 있어야 합니다.
- 수행하려는 작업
- 작업 대상
- 예상 영향
- 추천 이유
- 승인 또는 거절 후의 다음 단계
이 정보가 없으면 사용자는 맥락을 잃고, 결국 승인 UI는 클릭만 추가한 장치가 됩니다.
아키텍처 도식 #
승인 UI는 에이전트 실행 엔진과 분리해서 설계하는 편이 안전합니다.
- 에이전트는 승인 요청을 생성합니다.
- UI는 요청을 사람이 읽을 수 있게 정리합니다.
- 승인 저장소는 결과를 기록합니다.
- 실행기와 UI는 느슨하게 결합하는 편이 좋습니다.
체크리스트 #
- 승인 화면이 작업 맥락을 충분히 설명하는가.
- 승인과 거절의 결과가 명확한가.
- 반려 후 재요청 경로가 있는가.
- 승인 기록이 감사 로그로 남는가.
- 모바일이나 좁은 화면에서도 읽기 쉬운가.
결론 #
Human Approval UI는 사용자의 클릭을 받는 화면이 아니라, 위험한 자동화를 사람이 이해할 수 있게 바꾸는 인터페이스입니다. 정보 구조가 좋아야 승인 품질도 좋아집니다.