贡献集成

首先，请确保您已安装贡献代码指南中列出的所有依赖项。

您可以通过几种不同的方式为 LangChain 贡献集成

• 社区：适用于主要由 LangChain 和开源社区维护的轻量级集成。
• 合作伙伴包：适用于由 LangChain 和合作伙伴共同维护的独立包。

在大多数情况下，新的集成应添加到社区包中。合作伙伴包作为单独的包需要更多维护，因此在创建新的合作伙伴包之前，请与 LangChain 团队确认。

在以下各节中，我们将介绍如何从一家名为 Parrot Link AI 的虚构公司为这些包做出贡献。

社区包

@langchain/community 包位于 libs/langchain-community 中，包含大多数集成。

它可以使用例如 npm install @langchain/community 安装，导出的成员可以使用如下代码导入

import { ChatParrotLink } from "@langchain/community/chat_models/parrot_link";
import { ParrotLinkLLM } from "@langchain/community/llms/parrot_link";
import { ParrotLinkVectorStore } from "@langchain/community/vectorstores/parrot_link";

@langchain/community 包依赖于手动安装的依赖包，因此如果您尝试导入未安装的包，您将看到错误。在我们的虚构示例中，如果您尝试导入 ParrotLinkLLM 而不安装 parrot-link-sdk，您将看到一个错误，告诉您包导入失败。

假设我们想为 Parrot Link AI 实现一个聊天模型。我们将在 libs/langchain-community/src/chat_models/parrot_link.ts 中创建一个新文件，其中包含如下代码

import {
  SimpleChatModel,
} from "@langchain/core/language_models/chat_models";

export class ChatParrotLink extends SimpleChatModel {

  ...

测试与 src/ 目录位于同一位置，因此您可以将它们写入如下文件中

• 单元测试：libs/langchain-community/src/chat_models/tests/parrot_link.test.ts
• 集成测试：libs/langchain-community/src/chat_models/tests/parrot_link.int.test.ts

单元测试不应有任何外部 API 调用或需要任何环境变量。

您应该将文档添加到

• docs/core_docs/docs/integrations/chat/parrot_link.mdx

LangChain 仓库中的合作伙伴包

合作伙伴包可以托管在 LangChain monorepo 中。

LangChain 仓库中的合作伙伴包应放置在 libs/langchain-{partner} 下

用户可以使用 npm install @langchain/{partner} 安装包，包成员可以使用如下代码导入

import { X } from "@langchain/{partner}";

设置新包

要设置新的合作伙伴包，您可以使用 create-langchain-integration，这是一个实用程序，它将自动搭建一个支持 ESM + CJS 入口点的仓库。您可以在 libs/ 文件夹中像这样运行它

cd libs/
npx create-langchain-integration

然后，按照提示命名您的包。默认包将包含聊天模型、LLM 和/或向量存储的存根。您应该删除任何您不会使用的文件，并从 index.ts 中删除它们。

依赖项

如果您的包需要依赖项，例如您公司的 SDK，您可以像正常一样将它们添加到您包的 package.json 文件中

npm install parrot-link-sdk

编写单元测试和集成测试

src/tests/ 目录中提供了一些基本测试。您应该添加更多测试来覆盖您包的功能。

有关运行和实现测试的信息，请参阅测试指南。

编写文档

请从此处复制并使用适当的模板

https://github.com/langchain-ai/langchainjs/tree/main/libs/langchain-scripts/src/cli/docs/templates

您应该将带有示例的 notebook 放置在 monorepo 根目录的 docs/core_docs/docs/integrations 目录中。

（如果必要）弃用社区集成

注意：这仅在您将现有社区集成迁移到合作伙伴包时才必要。如果您集成的组件对于 LangChain 来说是全新的（即尚未在 community 包中），您可以跳过此步骤。

假设我们将 ChatParrotLink 聊天模型从社区包迁移到合作伙伴包。我们需要在社区包中弃用旧模型。我们可以使用 @deprecated TSDoc 注释来做到这一点。

在我们的更改之前，我们的聊天模型可能如下所示

class ChatParrotLink extends SimpleChatModel {
  ...

在我们的更改之后，它将如下所示

/** @deprecated Install and import from `@langchain/parrot-link` instead. */
class ChatParrotLink extends SimpleChatModel {
  ...

您应该为您迁移到合作伙伴包的每个组件执行此操作。