ag-ui与LangGraph集成终极指南：构建企业级AI工作流的完整教程

ag-ui是GitHub加速计划中的核心项目，它为开发者提供了一个强大的协议层，能够无缝集成各种AI框架和工具，而LangGraph作为构建状态ful多智能体应用的领先框架，两者的结合为企业级AI工作流带来了无限可能。本文将详细介绍如何将ag-ui与LangGraph集成，帮助你快速构建高效、可靠的AI应用。[![ag-ui与LangGraph集成架构图](https://raw.gitcod

章雍宇

985人浏览 · 2026-03-24 11:26:51

章雍宇 · 2026-03-24 11:26:51 发布

ag-ui与LangGraph集成终极指南：构建企业级AI工作流的完整教程

【免费下载链接】ag-ui 项目地址: https://gitcode.com/gh_mirrors/agu/ag-ui

为什么选择ag-ui与LangGraph集成？

ag-ui作为一个灵活的协议层，能够连接你的应用与各种AI工具和服务。它支持多种流行的AI框架，包括LangGraph、LlamaIndex、CrewAI等，为开发者提供了统一的接口来管理和协调不同的AI组件。

LangGraph则专注于构建状态ful的多智能体应用，通过定义节点和边来建模复杂的工作流，支持循环、条件分支等高级控制流，非常适合构建需要复杂决策和状态管理的AI系统。

将ag-ui与LangGraph集成，你可以：

利用ag-ui的统一接口简化LangGraph与其他工具的集成
通过ag-ui的事件系统实时监控和调试LangGraph工作流
借助ag-ui的状态管理功能增强LangGraph应用的可靠性和可维护性

快速开始：ag-ui与LangGraph集成步骤

1. 环境准备

首先，确保你已经安装了必要的依赖：

git clone https://gitcode.com/gh_mirrors/agu/ag-ui
cd ag-ui

2. 安装LangGraph集成包

ag-ui提供了专门的LangGraph集成包，支持TypeScript和Python两种语言：

TypeScript:

cd integrations/langgraph/typescript
npm install

Python:

cd integrations/langgraph/python
pip install -e .

3. 创建LangGraph代理

在ag-ui中，你可以通过创建LangGraph代理来连接LangGraph工作流。以下是一个简单的示例：

TypeScript:

import { LangGraphHttpAgent } from "@ag-ui/langgraph";

const agent = new LangGraphHttpAgent({
  name: "my-langgraph-agent",
  url: "http://localhost:3000/langgraph"
});

Python:

from ag_ui_langgraph.agent import LangGraphAgent
from langgraph.graph import CompiledStateGraph

# 假设你已经定义了一个LangGraph图
graph = CompiledStateGraph(...)

agent = LangGraphAgent(
    name="my-langgraph-agent",
    graph=graph,
    description="A LangGraph agent integrated with ag-ui"
)

深入理解：ag-ui与LangGraph的核心集成点

ag-ui与LangGraph的集成主要通过以下几个核心组件实现：

1. 事件处理系统

ag-ui提供了强大的事件处理机制，可以捕获和处理LangGraph工作流中的各种事件。在ag_ui_langgraph/agent.py中，你可以看到如何将LangGraph事件转换为ag-ui事件：

async def _handle_single_event(self, event: Any, state: State) -> AsyncGenerator[str, None]:
    event_type = event.get("event")
    if event_type == LangGraphEventTypes.OnChatModelStream:
        # 处理聊天模型流事件
        ...
    elif event_type == LangGraphEventTypes.OnToolEnd:
        # 处理工具调用结束事件
        ...

2. 状态管理

ag-ui的状态管理系统可以帮助你跟踪和管理LangGraph工作流的状态。通过get_state_snapshot方法，你可以获取当前工作流的状态快照：

def get_state_snapshot(self, state: State) -> State:
    schema_keys = self.active_run["schema_keys"]
    if schema_keys and schema_keys.get("output"):
        state = filter_object_by_schema_keys(state, [*DEFAULT_SCHEMA_KEYS, *schema_keys["output"]])
    return state