통합 기여하기

통합 기여하기 (Contributing integrations)

통합은 LangChain의 핵심 구성 요소예요.

LangChain은 LLM 애플리케이션을 구축할 때 중요한 여러 컴포넌트(언어 모델, 벡터 스토어 등)를 위한 표준 인터페이스를 제공합니다. 새 통합을 구현하면 LangChain의 생태계를 확장하고 수백만 개발자에게 여러분의 서비스를 알릴 수 있습니다.

출처: 문서

본문

새 통합은 `langchain-ai` 저장소에 **PR로 받지 않습니다**. 모든 새 통합은 PyPI에 독립 패키지(예: `langchain-yourprovider`)로 게시되어야 합니다. `langchain-ai` 저장소에 열어야 하는 유일한 PR은 게시된 패키지를 문서에 등록하는 것입니다: 다운로드 테이블용 YAML 행 또는 [자격 기준](/oss/javascript/contributing/publish-langchain#eligibility-for-hosted-guides)을 충족하면 호스티드 가이드입니다.

왜 LangChain 통합을 구현하나요?

  • 발견 가능성(Discoverability) — LangChain은 월 2억 회 이상의 다운로드로 LLM 애플리케이션 구축에 가장 많이 사용되는 프레임워크입니다.
  • 상호 운용성(Interoperability) — LangChain 컴포넌트는 표준 인터페이스를 노출하여 개발자가 쉽게 서로 교체할 수 있습니다. LangChain 통합을 구현하면 다른 컴포넌트를 사용하는 개발자가 쉽게 여러분의 컴포넌트로 교체할 수 있습니다.
  • 모범 사례(Best Practices) — LangChain 컴포넌트는 표준 인터페이스를 통해 개발자 경험과 애플리케이션 성능을 개선하는 모범 사례(스트리밍, 비동기 등)를 장려하고 촉진합니다.

통합할 컴포넌트

어떤 컴포넌트든 LangChain에 통합할 수 있지만, 다음과 같은 특정 유형의 통합을 더 권장합니다:

권장 ✅:

권장하지 않음 ❌:

  • LLM (텍스트 완성 모델): 채팅 모델을 위해 더 이상 사용되지 않음(deprecated)
  • 문서 로더 (Document Loaders): 높은 유지 관리 부담
  • 키-값 스토어 (Key-Value Stores): 제한적인 사용
  • 문서 변환기 (Document Transformers): 틈새 사용 사례
  • 모델 캐시 (Model Caches): 인프라 관련 사항
  • 그래프 (Graphs): 복잡한 추상화
  • 메시지 기록 (Message Histories): 스토리지 추상화
  • 콜백 (Callbacks): 시스템 수준 컴포넌트
  • 채팅 로더 (Chat Loaders): 제한적인 수요
  • 어댑터 (Adapters): 엣지 케이스 유틸리티

통합 기여 방법

  1. 패키지 구현하기 — LangChain 통합 구현 방법

  2. 표준 테스트 통과하기 — 해당되는 경우 통합에 LangChain의 표준 테스트 스위트 지원을 구현하고 성공적으로 실행하세요.

  3. 통합 게시하기 — 통합 게시 방법

  4. 통합 등록하기 — 사용자가 패키지를 찾을 수 있도록 LangChain 문서 저장소에 PR을 여세요. 호스티드 가이드는 제한적입니다; 대부분의 통합은 YAML로 등록됩니다.

    등록이 작동하는 방식:

    • 기본(월 5만 회 미만 다운로드, 추천 아님): 통합 등록 이슈를 제출하세요. 메인테이너가 integration-run을 적용한 후 자동화가 scripts/data/integration_external_docs.yaml에 행을 추가하는 PR을 엽니다. 이름 열은 docs_url(파트너 문서 우선, 그다음 GitHub, 그다음 PyPI 또는 npm)에 연결됩니다. 새 MDX 페이지를 추가하지 마세요.
    • 호스티드 가이드(월 5만 회 이상 다운로드, 또는 메인테이너 추천): 템플릿에서 src/oss/python/integrations/<component_type>/ 아래에 페이지를 만드세요:

    전체 단계, 자격 세부 사항, 거부 기준은 통합 게시를 참고하세요.

  5. (선택) 공동 마케팅 — 공동 공동 마케팅을 위해 LangChain 팀과 소통하세요.

더 알아보기