OpenRouter, 에이전트 SDK에 Human-in-the-Loop 기능 도입
OpenRouter
2026년 5월 12일 (화)
- •OpenRouter가 에이전트 SDK에 고위험 의사결정 처리를 위한 Human-in-the-Loop(HITL) 도구를 추가했다.
- •개발자는 조건부 로직을 사용하여 일상적인 작업은 자동화하고 특정 상황은 사람에게 검토를 요청할 수 있다.
- •이번 SDK는 단순히 실행을 멈추는 기존 방식과 달리, 사람의 응답을 처리하는 후크를 제공하여 유연한 상호작용을 지원한다.
OpenRouter가 에이전트 SDK를 업데이트하며 Human-in-the-Loop(HITL) 도구에 대한 지원을 강화했다. 개발자는 이를 통해 에이전트가 일상 업무는 자율적으로 수행하도록 하되, 특정 결제 금액을 초과하거나 정책 위반이 의심되는 등 중요한 결정이 필요한 경우에만 사람이 개입하도록 흐름을 설계할 수 있다.
이번 워크플로우는 'onToolCalled' 후크를 활용한다. 개발자가 입력값을 검사하는 로직을 정의하면, 함수가 값을 반환할 경우 에이전트는 계속 실행되고, null을 반환하면 'awaiting_hitl' 상태로 대기한다. 이후 애플리케이션은 보류 중인 호출을 포착해 사용자에게 전달하며, 'function_call_output' 항목과 함께 'callModel'을 호출하여 에이전트의 작업을 재개할 수 있다. 또한 선택적으로 사용 가능한 'onResponseReceived' 후크는 사람의 응답을 모델이 반영하기 전 메타데이터를 추가하거나 형식을 정규화하는 등의 후속 처리를 가능케 한다.
이는 모든 호출 시 실행을 멈춰야 했던 기존의 'requireApproval' 방식과는 차별화된다. HITL 도구는 100달러 미만의 결제처럼 단순한 건은 자동으로 승인하고, 설정된 기준을 벗어난 복잡한 상황에서만 사람이 검토하도록 세밀한 제어 권한을 제공한다.