LangChain: 헤드리스 도구 — 클라이언트 기능을 진정한 도구로 호출하는 에이전트

Christian Bromann이 2026년 6월 10일 LangChain 블로그에 에이전트가 사용자 환경과 통신하는 방식을 바꾸는 패턴을 발표했습니다. 헤드리스 도구(headless tools) — 서버에 UI가 없는 도구라는 뜻 — 는 에이전트가 브라우저와 애플리케이션 기능 — 위치 정보, 클립보드(clipboard), 파일 선택기(file picker), 로컬 스토리지(local storage) — 을 에이전트 추론 루프 안에서 완전한 도구로 호출할 수 있게 합니다.

서버 도구가 클라이언트 기능을 대체할 수 없는 이유

기존의 에이전트 시스템은 거의 전적으로 서버에서 실행되는 도구에 의존했습니다. 이는 많은 작업 — 데이터 가져오기, API 호출, 계산 — 에 효과적이었지만 근본적인 한계에 부딪혔습니다. 특정 브라우저 및 애플리케이션 기능은 서버가 안정적으로 에뮬레이션할 수 없는 실제 장치 권한과 클라이언트 신호에 본질적으로 의존합니다.

에이전트가 백엔드를 통해 사용자의 위치 정보나 로컬 파일에 접근하려 할 때 두 가지 문제가 발생합니다. (1) 사용자가 해당 데이터를 서버에 명시적으로 전달해야 하며 — 이는 대화 흐름을 방해하는 단계입니다 — (2) 민감한 데이터가 불필요하게 클라이언트를 떠나 불필요한 보안 및 프라이버시 위험을 초래합니다.

아키텍처: 서버는 무엇을, 클라이언트는 어떻게

헤드리스 도구 패턴의 핵심 아키텍처 개념은 명확한 책임 분리입니다.

• 서버는 에이전트가 무엇을 해야 하는지 정의합니다. 도구 스키마와 추론 로직을 보유합니다.
• 클라이언트는 도구가 어떻게 실행되는지 정의합니다. 브라우저 로직을 서버나 모델에 노출하지 않고 구체적인 구현을 등록합니다.

Bromann이 설명하듯: 「모델은 도구가 어디서 실행되는지 알 필요가 없습니다. 도구를 보고, 사용을 결정하고, 결과를 받습니다.」

기술적으로, 에이전트가 헤드리스 도구를 사용하기로 결정하면 서버는 로컬에서 실행하는 대신 클라이언트에 도구 호출을 보냅니다. 클라이언트가 구현을 실행하고 — 예를 들어 브라우저 API에서 위치 정보를 읽어 — 결과를 반환합니다. 에이전트는 어디서 실행이 이루어졌는지 알지 못한 채(알 필요도 없이) 추론을 계속합니다.

구현은 TypeScript를 사용하며, .implement() 메서드를 통해 도구 정의(tools.ts)와 브라우저별 구현을 분리합니다. 클라이언트는 브라우저 로직이 서버나 모델로 새지 않도록 구현을 등록합니다.

아키텍처적 장점으로서의 프라이버시

헤드리스 도구는 단순한 마케팅 주장이 아닌 패턴의 구조적 특성인 구체적인 프라이버시 이점을 가져옵니다. 민감한 데이터는 기본적으로 클라이언트에 유지됩니다.

위치 정보, 로컬 파일, 클립보드 내용 — 에이전트가 로컬에서 작업을 해결할 수 있다면 이 중 아무것도 백엔드로 이동할 필요가 없습니다. 이는 갈수록 엄격해지는 데이터 프라이버시 규제와 불필요하게 데이터를 수집하는 시스템에 대한 사용자 불신이 높아지는 맥락에서 특히 관련성이 있습니다.

동일한 원칙이 에이전트 메모리에도 적용됩니다. 서버 인프라에 저장하는 대신, 에이전트 메모리가 브라우저의 기본 스토리지인 IndexedDB에 영구 저장될 수 있습니다. 서버 인프라 요구 사항이 전혀 없습니다.

실제 적용 사례

Bromann은 가능해진 문제 클래스를 보여주는 두 가지 구체적인 예시를 설명합니다.

Slidev 프레젠테이션 내비게이션 에이전트 — 라이브 Slidev 프레젠테이션의 상태를 직접 제어하는 에이전트. 이는 브라우저 컨텍스트에만 존재하는 애플리케이션의 DOM 상태를 직접 조작해야 하기 때문에 백엔드에서는 불가능합니다.

Figma 사이드카 에이전트 — Figma 인터페이스와 함께 보조 도구로 작동하며 디자인 도구와 직접 상호작용하는 에이전트. 이 역시 Figma 상태가 클라이언트에 살아있기 때문에 서버에서 에뮬레이션할 수 없습니다.

두 예시 모두 헤드리스 도구가 해결하는 동일한 구조적 문제를 공유합니다. 에이전트가 라이브 애플리케이션 상태를 직접 조작해야 하는데, 이는 백엔드 관점에서는 불가능합니다.

에이전트 시스템에 대한 더 넓은 함의

헤드리스 도구 패턴은 에이전트 설계에서 지금까지 체계적으로 우회되어 온 문제 클래스에 대한 해결책을 제공합니다. 에이전트들이 사용자 인터페이스, 로컬 애플리케이션, 장치와의 상호작용을 포함한 더 복잡한 작업을 맡음에 따라, 클라이언트 기능을 일급 도구로 호출하는 능력은 사치가 아닌 전제 조건이 됩니다.

LangChain은 이를 오픈 소스 기여로 자리매김하고 있으며, 이는 이 패턴이 독점적 솔루션이 아닌 더 넓은 도구 프레임워크 생태계의 일부가 되려는 의도를 시사합니다.