Runtime 与上下文
Runtime Context 指运行时传入的额外上下文，比如当前用户、租户、权限、请求 ID、环境信息等。它不一定直接进入 Prompt，但会影响工具执行和业务逻辑。
为什么需要运行时上下文
比如订单查询工具不能只接收 order_id，还要知道当前登录用户是谁，否则可能越权查询。
python
def query_order(order_id: str, user_id: str) -> str:
# 先校验订单是否属于 user_id
return "订单状态：已发货"后端设计建议
- 用户 ID、租户 ID、权限范围应由服务端上下文传入，不能由模型自由生成。
- 请求链路中增加 trace_id，方便排查问题。
- 工具调用前统一做权限校验。
- 关键业务参数需要来源可信，而不是模型推测。
与 Prompt 的区别
Prompt 是给模型看的；Runtime Context 是给程序运行时用的。不要把所有内部信息都塞给模型，尤其是密钥、内部地址、权限策略等敏感信息。
非官方声明
本站为个人维护的非官方中文学习文档，不代表 LangChain 官方。页面内容是基于公开文档、源码实践和中文开发者视角重新整理的学习资料。涉及 API 细节时，请以官方文档和实际安装版本为准。
参考来源
- LangChain / LangGraph 官方文档：
https://docs.langchain.com/ - LangChain API Reference：
https://reference.langchain.com/ - 本站内容为中文学习整理，不做官方身份声明。