통합 게시하기

새 통합은 langchain-ai/langchainjs 저장소에 PR로 올리는 것이 아니라, 자신의 GitHub 조직이나 계정(예: @your-org/langchain-yourservice) 아래 독립형 npm 패키지로 게시해야 합니다.

메인 저장소에는 LangChain 팀이 유지 관리하는 소수의 퍼스트파티 통합만 포함됩니다.

패키지를 npm에 게시한 후 아래 통합을 발견 가능하게 만들기를 따르세요.

통합을 발견 가능하게 만들기 (Make your integration discoverable)

게시 후 LangChain 문서 저장소에 Integration listing 이슈를 제출하면 패키지가 통합 탭 아래에 표시됩니다.

메인테이너가 이슈를 검토하고 integration-run 라벨을 적용합니다. 그러면 자동화가 시작되어 양식 필드를 읽고 아래 자격 규칙을 적용하며, 검토를 위해 메인테이너와 여러분을 태그하는 풀 리퀘스트를 엽니다. 양식에는 파트너 문서 URL을 선호합니다.

새 등록을 위해 메인테이너가 요청하지 않는 한 수동 문서 PR을 열지 마세요.

호스티드 가이드 자격 (Eligibility for hosted guides)

LangChain은 다음 중 하나를 충족할 때만 이 문서 저장소에 전체 통합 가이드를 호스팅합니다:

• 패키지가 PyPI(또는 TypeScript의 경우 npm)에서 최소 월 5만 회 다운로드가 있을 때, 또는
• 메인테이너가 통합을 featured로 표시할 때

두 기준 중 어느 하나도 충족하지 않으면 자동화는 자신의 문서로 연결되는 외부 등록(YAML + 다운로드 테이블 + 프로바이더 카드)을 추가합니다. 호스티드 MDX 페이지는 추가하지 않습니다.

다운로드 테이블에 등록 (기본)

• Integration listing 이슈 제출하기: 표시 이름, 언어, 컴포넌트, 패키지 이름, 문서 URL, 짧은 프로바이더 설명을 위한 고정 양식 필드를 사용하세요.

자동화는 이슈에서 scripts/data/integration_external_docs.yaml과 관련 등록 표면을 채웁니다.

각 등록에는 최소한 다음이 필요합니다:

• name: LangChain 클래스 또는 표시 이름 (예: ChatAI21).
• pypi 또는 npm: 다운로드 배지에 사용되는 레지스트리 패키지 이름.
• docs_url: 이름 열에 대한 링크. 파트너 문서, 그다음 GitHub 저장소, 그다음 PyPI 또는 npm 페이지를 선호합니다.

선택적으로 이슈 양식에 컴포넌트별 기능 플래그(예: 채팅 stream 및 tool_calling)를 포함해 테이블 열이 정확하게 유지되도록 하세요.

병합 후 새로고침 작업이 컴포넌트 테이블 스니펫을 재생성하여 행이 호스티드 통합과 함께 표시됩니다.

호스티드 가이드 (5만+ 또는 featured)

패키지가 자격 기준을 충족하면 Integration listing 자동화가 다음 템플릿 중 하나에서 문서 페이지가 포함된 PR을 열 수 있습니다. 메인테이너가 호스티드 페이지를 수동으로 작성하거나 수정하도록 요청할 수도 있습니다.

구축한 통합 유형에 따라 다른 유형의 문서 페이지를 만들어야 합니다. LangChain은 시작을 돕기 위해 다양한 통합 유형에 대한 템플릿을 제공합니다.

• 채팅 모델 템플릿