发布集成

将您的集成提供给社区。

重要提示：新的集成应该是独立的包，而不是提交到 LangChain 单一代码库的 PR。

虽然 LangChain 在主仓库中维护一小部分第一方和高频使用的集成（如 OpenAI、Anthropic 和 Ollama），但新集成应该发布为独立的 PyPI 包和仓库（例如 langchain-yourservice），用户将其与核心 LangChain 包一起安装。您不应该提交 PR 来直接将您的集成添加到主 LangChain 仓库。

现在你的包已经实现并测试完成，你可以发布它并添加文档，让社区能够发现它。

发布您的软件包

本指南假设您已经实现了您的包并为其编写了测试。如果还没有，请参考 实现指南 和 测试指南。

在本指南中，我们将使用 PyPI 作为包注册表。如果您愿意，也可以选择发布到其他注册表；具体说明会有所不同。

设置凭据

首先，请确保您拥有一个 PyPI 账户：

How to create a PyPI Token

1. Create account

   访问 PyPI 网站 并创建账户

2. Verify email

   通过点击 PyPI 发送给您的链接来验证您的电子邮件地址

3. Enable 2FA

   前往您的账户设置，并点击“生成恢复代码”以启用 2FA。要生成 API 令牌，您必须启用 2FA

4. Generate token

   前往您的账户设置并生成新的API令牌

构建和发布

How to publish a package

来自 uv 的实用指南，教你如何构建包并发布到 PyPI。

添加文档

要将您的软件包文档添加到此站点的集成选项卡下，您需要创建相关的文档页面，并在LangChain 文档仓库中提交 PR。

编写文档

根据您构建的集成类型，您需要创建不同类型的文档页面。LangChain 为不同类型的集成提供模板，以帮助您快速开始。

Chat models

Tools/toolkits

Retrievers

Vector stores

Embedding models

要参考现有文档，你可以查看集成列表并找到与你的类似的。

要查看某个文档页面的原始 Markdown，请使用页面右上角“复制页面”旁边的下拉按钮，并选择“以 Markdown 查看”。

提交 PR

在个人 GitHub 账户下 Fork LangChain 文档仓库，并将其克隆到本地。为你的集成创建一个新分支。复制模板，并使用你喜欢的 Markdown 文本编辑器修改它们。在编写文档时，请确保参考并遵循 文档指南。

在以下情况下，我们可能会拒绝 PR 或要求修改：

• CI 检查失败
• 存在严重的语法错误或拼写错误
• Mintlify 组件 使用不当
• 页面缺少 frontmatter
• 缺少 本地化（如适用）
• 代码示例 无法运行或存在错误
• 未达到 质量标准

我们正在处理大量 PR，请您耐心等待。我们会尽快审查您的 PR，并提供反馈或进行合并。请勿就您的 PR 反复 @ 维护者。

---

下一步

恭喜！ 您的集成现已发布并附有文档，可供整个 LangChain 社区使用。

Co-marketing

联系 LangChain 营销团队，探讨联合营销机会。

---

在 GitHub 上编辑此页面的源代码。

通过编程方式连接这些文档到 Claude、VSCode 等应用，通过 MCP 获取实时答案。