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