Skip to main content

概述

LangChain 的 create_agent 底层运行在 LangGraph 的运行时上。 LangGraph 暴露了一个 Runtime 对象,包含以下信息:
  1. 上下文:静态信息,如用户 ID、数据库连接或代理调用的其他依赖项
  2. 存储:一个 BaseStore 实例,用于长期记忆
  3. 流写入器:一个对象,用于通过 "custom" 流模式流式传输信息
  4. 执行信息:当前执行的身份和重试信息(线程 ID、运行 ID、尝试次数)
  5. 服务器信息:在 LangGraph 服务器上运行时的特定元数据(助手 ID、图 ID、已认证用户)
运行时上下文为你的工具和中间件提供依赖注入。你可以在调用代理时注入运行时依赖项(如数据库连接、用户 ID 或配置),而不是硬编码值或使用全局状态。这使你的工具更易于测试、重用和灵活。
你可以在工具中间件中访问运行时信息。

访问

使用 create_agent 创建代理时,你可以指定 context_schema 来定义存储在代理 Runtime 中的 context 的结构。 调用代理时,传递 context 参数并包含运行的相关配置:

在工具中

你可以在工具中访问运行时信息,以:
  • 访问上下文
  • 读取或写入长期记忆
  • 写入自定义流(例如,工具进度/更新)
使用 ToolRuntime 参数在工具内访问 Runtime 对象。

工具中的执行信息和服务器信息

通过 runtime.execution_info 访问执行身份(线程 ID、运行 ID),在 LangGraph 服务器上运行时通过 runtime.server_info 访问服务器特定元数据(助手 ID、已认证用户):
当不在 LangGraph 服务器上运行时(例如,在本地开发期间),server_infoNone
需要 deepagents>=0.5.0(或 langgraph>=1.1.5)才能使用 runtime.execution_inforuntime.server_info

在中间件中

你可以在中间件中访问运行时信息,以创建动态提示、修改消息或根据用户上下文控制代理行为。 使用 Runtime 参数在节点式钩子内访问 Runtime 对象。对于包装式钩子Runtime 对象在 ModelRequest 参数内可用。

中间件中的执行信息和服务器信息

中间件钩子也可以访问 runtime.execution_inforuntime.server_info
需要 deepagents>=0.5.0(或 langgraph>=1.1.5)。