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
// Indicate that a chat model supports parallel tool calls

class ChatParrotLinkStandardIntegrationTests extends ChatModelIntegrationTests<
    ChatParrotLinkCallOptions,
    AIMessageChunk
> {
    constructor() {
        // ... other required properties

        super({
            // ... other required properties
            supportsParallelToolCalls: true,  // (The default is False)
            // ...
        });
    }
您应该在相对于包根目录的这些子目录中组织测试：
  • tests/unit_tests 用于单元测试
  • tests/integration_tests 用于集成测试
要查看可配置功能的完整列表及其默认值，请访问标准测试的 API 参考。

​
沙盒集成

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

​
故障排除

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