025. 模型调用测试与 LangGraph 工作流入门

学习目标

这一节继续测试模型调用接口，并开始介绍 LangGraph 工作流的基本概念。

学完后，你应该能理解：

为什么要先用 API 调试工具验证接口；
模型服务代理为什么要先跑通；
LangGraph 中工作流、节点和边分别是什么；
Agent 为什么可以理解成一个循环工作流；
模型调用和工具调用之间是什么关系；
为什么旧版 LangGraph 课程内容不再作为当前重点。

先测试接口

写完接口后，不要直接相信它能用。

课程里先用 API 调试工具测试聊天接口。

这样可以确认：

后端服务已启动；
请求路径正确；
请求参数格式正确；
模型配置能读取；
响应结果正常返回；
报错时能看到明确原因。

前端页面如果直接调失败，可能有很多原因。

先用接口工具验证，可以把问题范围缩小到后端本身。

模型服务代理

前端通常不会直接请求模型平台。

后端会提供一个代理接口。

它负责：

接收前端请求；
读取模型配置；
调用云厂商模型；
处理响应；
返回给前端。

这样模型 Key 不会暴露到浏览器里。

同时，后端也可以统一处理模型切换、日志、错误和鉴权。

为什么需要 LangGraph

普通模型调用是一问一答。

用户输入一段话，模型返回一段话。

但 Agent 不是简单问答。

Agent 可能需要：

先判断用户意图；
决定是否调用工具；
调用工具后读取结果；
再让模型继续判断；
多次循环后才结束。

这种流程就适合用 LangGraph 来描述。

最简单的工作流

课程里展示了一个最简单的工作流。

它大致包含两个核心节点：

模型节点；
工具节点。

用户输入进来后，先进入模型节点。

模型判断是否需要调用工具。

如果需要，就进入工具节点。

工具执行完，把结果交回模型。

模型再判断是否继续调用工具。

如果不需要继续，就结束并回复用户。

这就是 Agent 最基础的循环。

节点和边

在 LangGraph 里，可以把工作流理解成一张图。

图里有节点，也有边。

节点负责做事情，例如：

调模型；
调工具；
处理数据；
判断状态。

边负责决定下一步去哪里。

例如：

模型决定继续调用工具；
模型决定结束；
工具执行后回到模型。

这和前端状态机有一点像：当前状态执行完后，根据条件跳到下一个状态。

工具调用结果回到模型

工具不是最终答案。

工具只是给模型提供新的信息或执行结果。

例如工具查到了数据库，模型还要根据查询结果组织回复。

所以工具节点执行完后，通常会回到模型节点。

模型再决定：

继续调用另一个工具；
让用户补充信息；
直接给出结果。

这就是 Agent 比普通 API 更复杂的地方。

旧版 LangGraph

课程里提到，旧版 LangGraph 曾经使用过不同写法，例如 LCEL 相关表达。

当前课程不再重点讲旧版写法。

原因是新版 LangGraph 更适合当前项目，也更贴近后面的实战。

如果遇到企业旧项目，旧版知识可能还有用。

但当前学习重点应该放在新版工作流、节点、边和工具循环上。

阶段重点

这一节从“模型接口能调用”过渡到“Agent 工作流能组织”。

模型调用只是基础。

真正的 Agent 要能在模型和工具之间循环，并根据结果决定下一步。

LangGraph 就是用来描述这类流程的核心框架。