主题
贡献集成
集成是 LangChain 的核心组成部分。
LangChain 为若干不同组件（语言模型、向量存储等）提供了标准接口，这些组件在构建 LLM 应用时至关重要。实现一个新的集成有助于扩展 LangChain 的生态系统，并让你的服务为数百万开发者所发现。
WARNING
新的集成不以 PR 形式接受到任何 langchain-ai 仓库。所有新集成都必须作为独立包发布到 PyPI（例如 langchain-yourprovider）。你应向 langchain-ai 仓库提交的唯一 PR 是在文档中列出你已发布的包：要么是下载表的 YAML 行，要么是符合资格标准时的托管指南。
为什么要实现 LangChain 集成？
Discoverability
LangChain 是构建 LLM 应用最常用的框架，每月下载量超过 2 亿次。
Interoperability
LangChain 组件暴露标准接口，使开发者可以轻松地将它们互相替换。如果你实现了 LangChain 集成，任何使用其他组件的开发者都能轻松地将其替换为你的组件。
Best Practices
通过其标准接口，LangChain 组件鼓励并促进最佳实践（流式传输、异步等），从而改善开发者体验和应用性能。
可集成的组件
虽然任何组件都可以集成到 LangChain 中，但我们对某些类型的集成更为鼓励：
请集成这些 ✅：
- 聊天模型：使用最活跃的组件类型
- 工具/工具包：启用智能体能力
- 检索器：RAG 应用的核心
- 嵌入模型：向量运算的基础
- 向量存储：语义搜索的必备要素
- 中间件：通过钩子扩展智能体行为
- 沙箱：使用 Deep Agents 安全地运行代码
不要集成这些 ❌：
- LLM（文本补全模型）：已被弃用，推荐使用聊天模型
- 文档加载器：维护负担高
- 键值存储：使用有限
- 文档转换器：用例小众
- 模型缓存：属于基础设施关注点
- 图：抽象复杂
- 消息历史：属于存储抽象
- 回调：系统级组件
- 聊天加载器：需求有限
- 适配器：边缘场景工具
如何贡献一个集成
Implement your package
Pass standard tests
如果适用，请为你的集成实现对 LangChain 标准测试套件的支持，并成功运行它们。
Publish integration
List your integration
在 LangChain 文档仓库中提交 PR，以便用户能找到你的包。托管指南数量有限；大多数集成通过 YAML 列出。
上架如何运作
默认（每月下载量低于 50,000，未被推荐）： 提交一个集成上架 issue。维护者应用 integration-run 标签后，自动化会打开一个 PR，向 scripts/data/integration_external_docs.yaml 添加一行。名称列链接到你的 docs_url（优先合作伙伴文档，其次是 GitHub，然后是 PyPI 或 npm）。不要新增 MDX 页面。
托管指南（每月下载量 50,000+，或由维护者推荐）： 基于模板在 src/oss/python/integrations/<component_type>/ 下创建页面：
完整的步骤、资格详情和拒绝标准，请参阅发布集成。
Co-marketing
（可选）与 LangChain 团队接洽，开展联合营销。