LangChain v0.3

最后更新：09.14.24

变更内容

所有 LangChain 包现在都将 @langchain/core 作为对等依赖项，而非直接依赖项，以帮助避免与核心版本冲突相关的类型错误。
- 您现在需要显式安装 @langchain/core，而不能依赖其他包内部解析的版本。
回调现在默认在后台运行且不阻塞，而不是阻塞执行。
- 这意味着，如果你在无服务器环境中使用例如 LangSmith 进行追踪，则需要等待回调完成，以确保它们在函数结束前执行完毕。
移除了 langchain 中已弃用的文档加载器和自查询入口点，改为使用 @langchain/community 和集成包中的入口点。
移除了社区中已弃用的 Google PaLM 入口点，改为使用 @langchain/google-vertexai 和 @langchain/google-genai 中的入口点。
已弃用将包含 "type" 的对象作为 BaseMessageLike 的方式，转而采用更接近 OpenAI 风格的 MessageWithRole

如何更新你的代码

如果您正在使用 langchain / @langchain/community / @langchain/core 0.0 或 0.1，我们建议您首先升级到 0.2。

如果您正在使用 @langchain/langgraph，请升级到 @langchain/langgraph>=0.2.3。这将适用于所有基础包的 0.2 或 0.3 版本。

以下是所有已发布包的完整列表，以及我们建议您在 package.json 中升级的版本约束。任何现在支持 @langchain/core 0.3 的包都进行了次要版本更新。

基础包

包	最新	推荐的 `package.json` 约束
langchain	0.3.0	>=0.3.0 <0.4.0
@langchain/community	0.3.0	>=0.3.0 <0.4.0
@langchain/textsplitters	0.1.0	>=0.1.0 <0.2.0
@langchain/core	0.3.0	>=0.3.0 <0.4.0

下游包

包	最新	推荐的 `package.json` 约束
@langchain/langgraph	0.2.3	>=0.2.3 <0.3

集成包

包	最新	推荐的 `package.json` 约束
@langchain/anthropic	0.3.0	>=0.3.0 <0.4.0
@langchain/aws	0.1.0	>=0.1.0 <0.2.0
@langchain/azure-cosmosdb	0.2.0	>=0.2.0 <0.3.0
@langchain/azure-dynamic-sessions	0.2.0	>=0.2.0 <0.3.0
@langchain/baidu-qianfan	0.1.0	>=0.1.0 <0.2.0
@langchain/cloudflare	0.1.0	>=0.1.0 <0.2.0
@langchain/cohere	0.3.0	>=0.3.0 <0.4.0
@langchain/exa	0.1.0	>=0.1.0 <0.2.0
@langchain/google-genai	0.1.0	>=0.1.0 <0.2.0
@langchain/google-vertexai	0.1.0	>=0.1.0 <0.2.0
@langchain/google-vertexai-web	0.1.0	>=0.1.0 <0.2.0
@langchain/groq	0.1.1	>=0.1.1 <0.2.0
@langchain/mistralai	0.1.0	>=0.1.0 <0.2.0
@langchain/mixedbread-ai	0.1.0	>=0.1.0 <0.2.0
@langchain/mongodb	0.1.0	>=0.1.0 <0.2.0
@langchain/nomic	0.1.0	>=0.1.0 <0.2.0
@langchain/ollama	0.1.0	>=0.1.0 <0.2.0
@langchain/openai	0.3.0	>=0.3.0 <0.4.0
@langchain/pinecone	0.1.0	>=0.1.0 <0.2.0
@langchain/qdrant	0.1.0	>=0.1.0 <0.2.0
@langchain/redis	0.1.0	>=0.1.0 <0.2.0
@langchain/weaviate	0.1.0	>=0.1.0 <0.2.0
@langchain/yandex	0.1.0	>=0.1.0 <0.2.0

一旦你已更新到这些包的最新版本，如果尚未安装，则需要显式安装 @langchain/core：

npm
Yarn
pnpm

npm install @langchain/core

yarn add @langchain/core

pnpm add @langchain/core

我们还建议检查您的锁定文件或运行相应的包管理器命令，以确保您的包管理器仅安装了一个版本的 @langchain/core。

如果您当前在无服务器环境中运行代码（例如 Cloudflare Worker、Edge 函数或 AWS Lambda 函数），并且您正在使用 LangSmith 跟踪或其他回调功能，则需要等待回调完成，以确保它们在函数结束前执行完毕。以下是一个简单的示例：

import { RunnableLambda } from "@langchain/core/runnables";
import { awaitAllCallbacks } from "@langchain/core/callbacks/promises";

const runnable = RunnableLambda.from(() => "hello!");

const customHandler = {
  handleChainEnd: async () => {
    await new Promise((resolve) => setTimeout(resolve, 2000));
    console.log("Call finished");
  },
};

const startTime = new Date().getTime();

await runnable.invoke({ number: "2" }, { callbacks: [customHandler] });

console.log(`Elapsed time: ${new Date().getTime() - startTime}ms`);

await awaitAllCallbacks();

console.log(`Final elapsed time: ${new Date().getTime() - startTime}ms`);

Elapsed time: 1ms
Call finished
Final elapsed time: 2164ms

您也可以将 LANGCHAIN_CALLBACKS_BACKGROUND 设置为 "false"，以使所有回调变为阻塞模式：

process.env.LANGCHAIN_CALLBACKS_BACKGROUND = "false";

const startTimeBlocking = new Date().getTime();

await runnable.invoke({ number: "2" }, { callbacks: [customHandler] });

console.log(
  `Initial elapsed time: ${new Date().getTime() - startTimeBlocking}ms`
);

Call finished
Initial elapsed time: 2002ms

LangChain v0.3

变更内容​

最新动态​

如何更新你的代码​

基础包​

下游包​

集成包​

变更内容

最新动态

如何更新你的代码

基础包

下游包

集成包