@arizeai/openinference-instrumentation-langchain

中文文档
4.1.5发布于 2026/10/24Apache-2.0TypeScriptESM + CJS构建来源已验证近 30 天下载 29.7万

LangChain.js 的 OpenInformation 仪器

中文使用文档
文档目录5 节
  1. 安装
  2. 使用量
  3. 使用自定义追踪提供者
  4. 兼容性
  5. 折旧

LangChain.js 的 OpenInformation 仪器

本模块为下列人员提供自动仪器: 兰钱.js. 可结合 @ opleteometry/ sdk- trace- 节点。 。 。 .

安装

npm install --save @arizeai/openinference-instrumentation-langchain

使用量

要装入 Langchain 仪表,手动仪表 @langchain/core/callbacks/manager 模块。 由于其中的非传统模块结构,召回管理器必须手动设置仪器 @langchain/core. 补充仪器可按惯例使用 registerInstrumentations 函数.

import { NodeTracerProvider } from "@opentelemetry/sdk-trace-node";
import { LangChainInstrumentation } from "@arizeai/openinference-instrumentation-langchain";
import * as CallbackManagerModule from "@langchain/core/callbacks/manager";

const provider = new NodeTracerProvider();
provider.register();

const lcInstrumentation = new LangChainInstrumentation();
// LangChain must be manually instrumented as it doesn't have a traditional module structure
lcInstrumentation.manuallyInstrument(CallbackManagerModule);

关于OpenTeleometry Node.js SDK的更多信息,请参见: OpenTeleometry 节点.js SDK 文档。 。 。 .

使用自定义追踪提供者

您可以在创建 LangChain 仪器时指定自定义的跟踪器提供者 。 当您想要使用非全局追踪器提供者或对追踪配置有更强的控制时,此功能是有用的.

import { NodeTracerProvider } from "@opentelemetry/sdk-trace-node";
import { Resource } from "@opentelemetry/resources";
import { SEMRESATTRS_PROJECT_NAME } from "@arizeai/openinference-semantic-conventions";
import { LangChainInstrumentation } from "@arizeai/openinference-instrumentation-langchain";
import * as CallbackManagerModule from "@langchain/core/callbacks/manager";

// Create a custom tracer provider
const customTracerProvider = new NodeTracerProvider({
  resource: new Resource({
    [SEMRESATTRS_PROJECT_NAME]: "my-langchain-project",
  }),
});

// Pass the custom tracer provider to the instrumentation
const lcInstrumentation = new LangChainInstrumentation({
  tracerProvider: customTracerProvider,
});

// Manually instrument the LangChain module
lcInstrumentation.manuallyInstrument(CallbackManagerModule);

或者,您可以在创建仪器后设置跟踪提供者:

const lcInstrumentation = new LangChainInstrumentation();
lcInstrumentation.setTracerProvider(customTracerProvider);

兼容性

@ langchain/ 核心版本@arizeai/ openinference-instrument-langchain 版本
^ 1. 0^ 4.0.0 (中文(简体) )
^0.3.0 (单位:千美元)^ 4.0.0 (中文(简体) )

此软件包仅测试于 1. X 版本 @langchain/core。旧版本可能有效,但没有得到官方支持。 对于LangChain.js的0.X版本的完全相容性,一个专用软件包叫做 openinference-instrumentation-langchain-v0 已提供.

折旧

LangChain v0.1于2025-03-02年被贬值,原因是核心套装的安全漏洞.

版本与发布记录

@arizeai/openinference-instrumentation-langchain 共发布 61 个版本,首次发布于 2024/04/16;过去 12 个月发布了 28 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
4.1.5latest2026/10/2414 天前
4.1.42026/10/021 个月前
4.1.32026/10/021 个月前
4.1.22026/10/011 个月前
4.1.12026/09/191 个月前
4.1.02026/09/161 个月前

关于 @arizeai/openinference-instrumentation-langchain 的常见问题

@arizeai/openinference-instrumentation-langchain 是什么?

LangChain.js 的 OpenInformation 仪器

如何安装 @arizeai/openinference-instrumentation-langchain?

在项目目录运行 npm install @arizeai/openinference-instrumentation-langchain,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:@langchain/core(^1.0.0 || ^0.3.0 || ^0.2.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@arizeai/openinference-instrumentation-langchain 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@arizeai/openinference-instrumentation-langchain 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@arizeai/openinference-instrumentation-langchain 可以商用吗?

@arizeai/openinference-instrumentation-langchain 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@arizeai/openinference-instrumentation-langchain 的下载量有多少?

根据 npm 官方下载统计,@arizeai/openinference-instrumentation-langchain 在 2026/10/07 – 2026/11/05 这 30 天内被下载 297,023 次,日均约 9,901 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@arizeai/openinference-instrumentation-langchain 还在维护吗?

最新版本 4.1.5 发布于 2026/10/24(14 天前);至今共发布 61 个版本,其中过去 12 个月发布了 28 个;首次发布于 2024/04/16。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。