上下文概述

上下文工程是指构建动态系统的实践，这些系统以正确的格式提供正确的信息和工具，使AI应用能够完成任务。上下文可以从两个关键维度来理解：

根据可变性：
- 静态上下文：在执行过程中不会改变的不可变数据（例如，用户元数据、数据库连接、工具）。
- 动态上下文：随着应用运行而演变的可变数据（例如，对话历史、中间结果、工具调用观察）。
根据生命周期：
- 运行时上下文：作用域为单次运行或调用的数据。
- 跨会话上下文：在多个对话或会话中持久存在的数据。

运行时上下文指的是本地上下文：你的代码运行所需的数据和依赖项。它不是指：

LLM 上下文，即传递给 LLM 提示词中的数据。
“上下文窗口”，即可以传递给 LLM 的最大 token 数量。

运行时上下文是你在线程中传递数据的方式。你不是将东西存储在全局状态中，而是可以将值（如数据库连接、用户会话或配置）附加到上下文，并在工具和中间件内部访问它们。这保持了代码的无状态性、可测试性和可重用性。例如，你可以在运行时上下文中使用用户元数据来获取用户偏好，并将其馈送到上下文窗口中。

LangGraph 提供了三种管理上下文的方式，它结合了可变性和生命周期维度：

上下文类型	描述	可变性	生命周期
Config	运行开始时传递的数据	静态	单次运行
动态运行时上下文（状态）	单次运行中演变的可变数据	动态	单次运行
动态跨会话上下文（存储）	跨对话共享的持久化数据	动态	跨会话

Config

Config 用于存储不可变数据，如用户元数据或 API 密钥。当你有一些在运行期间不会改变的值时，可以使用它。使用一个名为 “configurable” 的键来指定配置，该键是为此目的保留的。

await graph.invoke(
  { messages: [{ role: "user", content: "hi!" }] },
  { configurable: { user_id: "user_123" } }
);

动态运行时上下文

动态运行时上下文代表可变数据，这些数据可以在单次运行中演变，并通过 LangGraph 状态对象进行管理。这包括对话历史、中间结果以及从工具或 LLM 输出中派生的值。在 LangGraph 中，状态对象在运行期间充当短期记忆。

在智能体中
在工作流中

示例展示了如何将状态融入智能体的提示词中。状态也可以被智能体的工具访问，这些工具可以根据需要读取或更新状态。详见工具调用指南。

import { createAgent, createMiddleware } from "langchain";
import type { AgentState } from "langchain";
import * as z from "zod";

const CustomState = z.object({
  userName: z.string(),
});

const personalizedPrompt = createMiddleware({
  name: "PersonalizedPrompt",
  stateSchema: CustomState,
  wrapModelCall: (request, handler) => {
    const userName = request.state.userName || "User";
    const systemPrompt = `You are a helpful assistant. User's name is ${userName}`;
    return handler({ ...request, systemPrompt });
  },
});

const agent = createAgent({
  model: "claude-sonnet-4-6",
  tools: [/* your tools here */],
  middleware: [personalizedPrompt] as const,
});

await agent.invoke({
  messages: [{ role: "user", content: "hi!" }],
  userName: "John Smith",
});

import { z } from "zod/v4";
import { StateGraph, StateSchema, MessagesValue, START } from "@langchain/langgraph";

const CustomState = new StateSchema({
  messages: MessagesValue,
  extraField: z.number(),
});

const builder = new StateGraph(CustomState)
  .addNode("node", async (state) => {
    const messages = state.messages;
    // ...
    return {
      extraField: state.extraField + 1,
    };
  })
  .addEdge(START, "node");

const graph = builder.compile();

开启记忆功能 关于如何启用记忆功能，请参阅记忆指南。这是一个强大的功能，允许你在多次调用之间持久化智能体的状态。否则，状态的作用域仅限于单次运行。

动态跨会话上下文

动态跨会话上下文代表跨多个对话或会话存在的持久化、可变数据，并通过 LangGraph 存储进行管理。这包括用户资料、偏好和历史交互。LangGraph 存储在多次运行之间充当长期记忆。这可用于读取或更新持久化事实（例如，用户资料、偏好、先前交互）。

了解更多

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

Edit this page on GitHub or file an issue.

Tutorials

Conceptual overviews

LangChain Academy

Additional resources

Config

动态运行时上下文

动态跨会话上下文

了解更多

​Config

​动态运行时上下文

​动态跨会话上下文

​了解更多

Config

动态运行时上下文

动态跨会话上下文

了解更多