LangChainJS 1.0과 Gemini 3의 만남: 새로운 기능과 간편해진 패키지

기존에는 @langchain/google-genai, @langchain/google-gauth, @langchain/google-webauth, @langchain/google-vertexai 등 여러 패키지로 Gemini API를 지원하여 사용자가 혼란을 겪었다. REST 기반(REST-based)으로 구현되어 Google Cloud ADC(Application Default Credentials) 지원에 어려움이 있었고, Node.js와 웹 환경 간의 호환성 문제도 있었다. 이에 따라, @langchain/google 단일 패키지로 통합하여 설치 및 사용 편의성을 높였다. 이 새로운 라이브러리는 기존 ChatGoogle 클래스를 그대로 사용할 수 있도록 설계되어, 기존 사용자들의 마이그레이션 비용(Migration Cost)을 최소화했다.

LangChainJS 1.0은 텍스트 기반 모델뿐만 아니라 멀티모달 입출력을 위한 표준화된 지원을 제공한다. 기존 response.content 필드는 텍스트와 MessageContentComplex 객체 배열을 혼합하여 반환했으나, 새로운 response.text 필드를 통해 텍스트를 문자열로 안전하게 접근할 수 있도록 개선했다. 또한, ContentBlock.Standard 객체를 도입하여 텍스트, 이미지, 오디오, 비디오 등 다양한 형태의 콘텐츠를 일관된 방식으로 처리할 수 있게 되었다. 이를 통해 개발자는 멀티모달 데이터(Multimodal Data)를 더욱 쉽게 Gemini 모델에 전송하고 처리할 수 있다.

새로운 @langchain/google 라이브러리는 REST API를 기반으로 Gemini와 통신하므로, Google의 별도 라이브러리에 의존하지 않는다. 이는 의존성 관리(Dependency Management)를 단순화하고, 다양한 환경에서 유연하게 사용할 수 있도록 한다. 또한, API 키, Google Cloud 자격 증명(Credentials) 등 다양한 인증 방식을 지원하며, 환경 변수 또는 ADC를 통해 자격 증명을 로드할 수 있다. 이 라이브러리는 기존 REST 기반 라이브러리의 경험을 바탕으로, REST API 기반 라이브러리(REST API-based Library)의 모범 사례를 제시하는 것을 목표로 한다.

2026년 초에 알파 버전, 한 달 뒤 최종 버전 출시를 목표로 하고 있으며, 기존 라이브러리의 지원 방식에 대한 논의가 진행 중이다. 기존 버전은 새로운 @langchain/google 릴리스와 함께 버전이 업데이트되고, @langchain/google로 기능이 위임될 예정이다. 이 과정에서 호환성 문제가 최소화될 수 있도록 노력하고 있다. 향후 임베딩 지원, 배치 처리, 미디어 매니저, 보안 매니저, Gemini 외 모델 지원 등 다양한 기능이 추가될 예정이다. 개발자는 이러한 기능에 대한 피드백을 제공하고, 직접 통합에 참여할 수도 있다. 개발자는 사용자 피드백(User Feedback)을 통해 라이브러리의 개선 방향을 제시할 수 있다.