第34篇：Vibe Coding时代：LangGraph + OpenAPI 工具调用实战，解决 Agent 调接口参数混乱问题

一、问题场景：Agent 会调用接口，但参数经常传错

当 Agent 开始接入企业内部系统后，最常见的需求是调用 API：

查询用户信息 创建工单 获取订单状态 提交部署任务 查询日志

一开始我让模型根据接口说明自己拼请求：

请调用 /api/users/{id}

结果问题很多：

1. 路径参数写错 2. query 参数漏传 3. body 字段格式错 4. HTTP method 用错 5. 返回结果没有校验 6. 错误码没有处理

尤其是接口多了之后，仅靠自然语言描述很难稳定。

本文解决的问题是：

如何基于 OpenAPI Schema 封装工具，让 LangGraph Agent 调接口时参数更稳定、更可控。

二、为什么要基于 OpenAPI？

OpenAPI 的好处：