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