重要提示:新的集成应为独立包,而非 LangChain 单体仓库的 PR。虽然 LangChain 在主仓库中维护一小部分第一方和高使用率的集成(如 OpenAI、Anthropic 和 Ollama),但新的集成应作为独立的 PyPI 包和仓库发布(例如,
langchain-yourservice),供用户与核心 LangChain 包一起安装。你不应提交 PR 以直接将你的集成添加到主 LangChain 仓库。发布你的包
出于本指南的目的,我们将使用 PyPI 作为包注册表。如果你愿意,可以选择发布到其他注册表;说明会有所不同。设置凭据
首先,确保你有一个 PyPI 账户如何创建 PyPI 令牌
如何创建 PyPI 令牌
1
创建账户
访问 PyPI 网站并创建一个账户
2
验证邮箱
点击 PyPI 发送给你的链接以验证你的邮箱地址
3
启用双重验证 (2FA)
前往你的账户设置,点击“生成恢复代码”以启用双重验证。要生成 API 令牌,你必须启用双重验证
4
生成令牌
前往你的账户设置并生成一个新的 API 令牌
构建与发布
如何发布包
来自
uv 的关于如何构建和发布包到 PyPI 的有用指南。添加文档
要将你的包的文档添加到本网站的集成选项卡下,你需要创建相关的文档页面并在LangChain 文档仓库中发起一个 PR。编写文档
根据你构建的集成类型,你需要创建不同类型的文档页面。LangChain 为不同类型的集成提供了模板,以帮助你入门。要参考现有文档,你可以查看集成列表并找到与你的集成相似的页面。要以原始 Markdown 格式查看给定文档页面,请使用页面右上角“复制页面”旁边的下拉按钮,并选择“以 Markdown 形式查看”。
提交 PR
在个人 GitHub 账户下分叉LangChain 文档仓库,并将其克隆到本地。为你的集成创建一个新分支。复制模板并使用你喜欢的 Markdown 文本编辑器进行修改。在编写文档时,请务必参考并遵循文档指南。如果出现以下情况,我们可能会拒绝 PR 或要求修改:
- CI 检查失败
- 存在严重的语法错误或拼写错误
- Mintlify 组件使用不正确
- 页面缺少前置内容
- 缺少本地化(如果适用)
- 代码示例无法运行或存在错误
- 未达到质量标准
后续步骤
恭喜!你的集成现已发布并有文档,可供整个 LangChain 社区使用。联合营销
联系 LangChain 营销团队,探索联合营销机会。
以编程方式连接这些文档到 Claude、VSCode 等,通过 MCP 获取实时答案。