Skip to main content
标准测试确保您的集成按预期工作。 当为您自己或为在 LangChain 集成中发布而创建自定义类时，有必要添加测试以确保其按预期工作。LangChain 为每种集成类型提供了一套全面的测试集。本指南将向您展示如何将 LangChain 的标准测试套件添加到每种集成类型。

​
设置

首先，安装所需的依赖项：

langchain-core

定义我们想要导入以定义自定义组件的接口

langchain-tests

提供运行测试所需的标准测试和插件
npm install @langchain/core
npm install @langchain/standard-tests
langchain-tests 包中有 2 个命名空间：
位置: src.unit_tests设计用于在隔离状态下测试组件，无需访问外部服务查看 API 参考
位置: src.integration_tests设计用于在访问外部服务（特别是组件设计用于与之交互的外部服务）的情况下测试组件查看 API 参考

​
实现标准测试

根据您的集成类型，您需要实现单元测试或集成测试，或两者都实现。 通过为您的集成类型子类化标准测试套件，您将获得该类型的完整标准测试集合。为了使测试运行成功，给定的测试应仅在模型支持正在测试的功能时通过。否则，测试应被跳过。 由于不同的集成提供独特的功能集，LangChain 提供的大多数标准测试默认是选择加入的，以防止误报。因此，您需要覆盖属性以指示您的集成支持哪些功能 - 请参阅下面的示例以进行说明。
tests/chat_models.standard.int.test.ts
// 指示聊天模型支持并行工具调用

class ChatParrotLinkStandardIntegrationTests extends ChatModelIntegrationTests<
    ChatParrotLinkCallOptions,
    AIMessageChunk
> {
    constructor() {
        // ... 其他必需属性

        super({
            // ... 其他必需属性
            supportsParallelToolCalls: true,  // (默认为 False)
            // ...
        });
    }
您应将测试组织在相对于包根目录的这些子目录中：
  • tests/unit_tests 用于单元测试
  • tests/integration_tests 用于集成测试
要查看可配置功能的完整列表及其默认值，请参阅实现标准测试。

​
沙盒集成

Deep Agents 沙盒集成使用来自 @langchain/sandbox-standard-tests 的 sandboxStandardTests。 使用包含 createSandbox、resolvePath 和 closeSandbox 的配置对象调用它。 使用 Daytona 集成测试 作为参考实现。 请参阅贡献沙盒集成 了解发布指南。

​
故障排除

有关可用标准测试套件的完整列表，以及包含哪些测试和如何解决常见问题的信息，请参阅贡献 README。
在 GitHub 上编辑此页面 或提交问题。
通过 MCP 将这些文档连接到 Claude、VSCode 等 以获取实时答案。