操作指南¶
在这里,您将找到“我如何……?”类型问题的答案。这些指南是以目标为导向且具体的;它们旨在帮助您完成特定任务。有关概念性解释,请参阅概念指南。有关端到端演练,请参阅教程。有关每个类和功能的全面描述,请参阅API 参考。
安装¶
LangGraph¶
可控性¶
LangGraph.js 以其高度可控的智能体框架而闻名。这些操作指南展示了如何实现这种可控性。
持久性¶
LangGraph.js 使在图运行之间持久化状态变得容易。下面的指南展示了如何为您的图添加持久性。
有关如何使用功能性 API 为您的工作流添加持久性的方法,请参阅以下指南
记忆¶
LangGraph 使您能够轻松管理图中的对话记忆。这些操作指南展示了如何实现不同的策略。
人机协作¶
人机协作功能允许您将人类参与到图的决策过程中。这些操作指南展示了如何在您的图中实现人机协作工作流。
关键工作流
- 如何等待用户输入:一个基本示例,展示了如何使用
interrupt
函数在您的图中实现人机协作工作流。 - 如何审查工具调用:在工具调用请求执行前,使用
interrupt
函数引入人机协作,以进行审查/编辑/接受。
其他方法
- 如何添加静态断点:用于调试目的。对于人机协作工作流,我们建议改用
interrupt
函数。 - 如何编辑图状态:使用
graph.update_state
方法编辑图状态。如果通过静态断点实现人机协作工作流,请使用此方法。 - 如何使用
NodeInterrupt
添加动态断点:不推荐:请改用interrupt
函数。
有关如何使用功能性 API 实现人机协作工作流的方法,请参阅以下指南
时间旅行¶
时间旅行允许您在 LangGraph 应用程序中重放过去的动作,以探索替代路径和调试问题。这些操作指南展示了如何在您的图中使时间旅行。
流式传输¶
LangGraph 优先支持流式传输。这些指南展示了如何使用不同的流式传输模式。
- 如何流式传输图的完整状态
- 如何流式传输图的状态更新
- 如何流式传输 LLM 令牌
- 如何在不使用 LangChain 模型的情况下流式传输 LLM 令牌
- 如何流式传输自定义数据
- 如何配置多种流式传输模式
- 如何从工具内部流式传输事件
- 如何从最终节点流式传输
工具调用¶
子图¶
子图允许您从另一个图重用现有图。这些操作指南展示了如何使用子图
多智能体¶
有关其他多智能体架构的实现,请参阅多智能体教程。
有关如何使用功能性 API 实现多智能体工作流的方法,请参阅以下指南
状态管理¶
其他¶
预构建的 ReAct 智能体¶
有关如何使用功能性 API 构建 ReAct 智能体的方法,请参阅以下指南
LangGraph 平台¶
本节包含 LangGraph 平台的操作指南。
LangGraph 平台是一个商业解决方案,用于在生产环境中部署智能体应用程序,它基于开源 LangGraph 框架构建。它提供四种部署选项以满足不同需求:免费层、自托管版本、云 SaaS 和自带云(BYOC)选项。您可以在部署选项指南中详细了解这些选项。
提示
- LangGraph 是一个 MIT 许可的开源库,我们致力于为其社区进行维护和发展。
- 您始终可以使用开源 LangGraph 项目,在自己的基础设施上部署 LangGraph 应用程序,而无需使用 LangGraph 平台。
应用程序结构¶
了解如何设置应用程序以部署到 LangGraph 平台
- 如何设置应用程序以进行部署(requirements.txt)
- 如何设置应用程序以进行部署(pyproject.toml)
- 如何设置应用程序以进行部署(JavaScript)
- 如何自定义 Dockerfile
- 如何进行本地测试
- 如何将 LangGraph 集成到您的 React 应用程序中
部署¶
LangGraph 应用程序可以使用 LangGraph Cloud 进行部署,LangGraph Cloud 提供一系列服务,帮助您部署、管理和扩展应用程序。
认证 & 访问控制¶
修改 API¶
助手¶
助手是模板的配置实例。
线程¶
运行¶
LangGraph Cloud 除了流式运行外,还支持多种类型的运行。
流式传输¶
流式传输 LLM 应用程序的结果对于确保良好的用户体验至关重要,尤其是在您的图可能调用多个模型并需要很长时间才能完全完成运行时。请阅读这些操作指南,了解如何从您的图流式传输值。
前端 & 生成式 UI¶
借助 LangGraph 平台,您可以将 LangGraph 智能体集成到您的 React 应用程序中,并将 UI 组件与您的智能体代码并置。
人机协作¶
在创建复杂图时,将所有决策都交给 LLM 可能会有风险,尤其当决策涉及调用某些工具或访问特定文档时。为了解决这个问题,LangGraph 允许您插入人机协作行为,以确保您的图不会产生意外结果。在这些操作指南中,详细了解如何为您的 LangGraph Cloud 项目添加人机协作功能。
重复输入¶
图执行可能需要一段时间,有时用户在原始输入完成运行之前,可能会改变他们想要发送的输入。例如,用户可能会发现原始请求中存在拼写错误,然后编辑提示并重新发送。在这种情况下,决定如何处理对于确保流畅的用户体验和防止您的图以意外方式运行至关重要。以下操作指南提供了 LangGraph Cloud 处理重复输入的各种选项信息。
Webhooks¶
Cron 作业¶
LangGraph Studio¶
LangGraph Studio 是一个内置的用户界面,用于可视化、测试和调试您的智能体。
故障排除¶
这些指南用于解决您在使用 LangGraph 构建时可能遇到的常见错误。下面引用的错误在代码中抛出时,将具有与以下代码之一对应的 lc_error_code
属性。