使用标准测试 - Docs by LangChain中文

标准测试可确保您的集成按预期工作。 无论是为自己创建自定义类，还是在 LangChain 集成中发布，添加测试以确保其按预期工作是必要的。LangChain 为每种集成类型提供了一套全面的测试集。本指南将向您展示如何为每种集成类型添加 LangChain 的标准测试套件。

设置

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

langchain-core

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

langchain-tests

提供运行标准测试所需的测试和插件

npm install @langchain/core
npm install @langchain/standard-tests

pnpm add @langchain/core
pnpm add @langchain/standard-tests

yarn add @langchain/core
yarn add @langchain/standard-tests

bun add @langchain/core
bun add @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。

Connect these docs to Claude, VSCode, and more via MCP for real-time answers.

Edit this page on GitHub or file an issue.

​设置

langchain-core

langchain-tests

​实现标准测试

​沙盒集成

​故障排除

设置

实现标准测试

沙盒集成

故障排除