从零构建生产级LLM Agent:LangChain+FastAPI实现token流式输出、代码执行与搜索实战!
2026/5/12 3:08:23 网站建设 项目流程

简介

本文详细介绍了如何使用LangChain和FastAPI构建一个生产级的多工具AI Agent。该系统具备token流式输出、代码执行、网络搜索和数据库访问能力,通过异步处理和Server-Sent Events实现实时响应。文章涵盖了技术选型、Agent构建、工具集成、流式实现和部署等关键环节,展示了如何超越简单的LLM聊天功能,打造能够执行实际任务的智能Agent系统。


构建一个可用于生产的、工具增强型 LLM Agent,具备 token 流式输出、代码执行、搜索能力,以及 FastAPI 带来的极速表现。


当 ChatGPT 刚面世时,感觉就像魔法。但新鲜感很快过去,开发者开始共同发问:我们该如何超越“聊天”?我想打造更聪明的东西——一个能够实时推理、联网搜索、运行代码、访问结构化数据,并且可以一边“打字”一边响应的 AI Agent。

于是我动手做了一个。借助LangChainFastAPI,这个多工具 AI Agent 可以编排浏览器、数据库、Python REPL 等外部工具,并以 token 为单位实时流式输出生成内容。本文将拆解我的实战方案,以及你如何也能搭建同样的系统。


🛠 ️ 愿景:多工具 Agent 是 LLM 的未来

LLM 很擅长生成文本,但在“采取行动”方面有局限。LangChain 的 AgentExecutor正是为此而生——它通过让模型使用各类“tools”为其“装上手脚”。需要实时数据?调用搜索 API。需要算数?起一个代码解释器。需要结构化信息?接上数据库。

但问题在于:大部分演示只停留在“可以跑”。我想要的是一个能在生产环境中稳定服务的系统,利用FastAPI的异步能力和类似 ChatGPT 界面的token 级流式输出


🧱 核心技术栈

快速拆解这个实时 Agent 背后的技术选型:

  • LangChain

    :负责 Agent 逻辑、Prompt 模板、Memory、Tool 链接

  • OpenAI GPT-4 / GPT-3.5

    :用于推理与生成

  • FastAPI

    :高效通过 HTTP 提供服务

  • AsyncLangChain + SSE (Server-Sent Events)

    :实现实时 token 流式传输

  • Python REPL Tool

    :在沙箱中安全执行 Python 代码

  • Google Search Tool

    (基于 SerpAPI):获取最新的网页信息

  • PostgreSQL Tool

    :查询结构化数据

关键词(自然覆盖):langchain fastapi streaming, LLM agents, real-time AI agent, code execution with langchain, serve AI agent API


🧠 用 LangChain 构建 Agent

LangChain 提供了构建可使用外部工具的推理 Agent 所需的一切。概念流程如下:

  1. 定义 Tools
    Tool 本质是带有名称、描述和可调用体的 Python 包装。例如:
from langchain.agents import Tooldef run_code(code: str) -> str: # Execute in sandbox (be careful in prod!) try: returnstr(eval(code)) except Exceptionas e: returnstr(e)code_tool = Tool( name="Python REPL", func=run_code, description="Executes Python code and returns the result")
  1. 初始化 Agent
    我使用了 LangChain 的initialize_agent(),并选择chat-zero-shot-react-description类型,让模型可以自主选择工具并逐步解释其推理过程。
  2. 添加 Memory(可选)
    你可以用ConversationBufferMemory持久化会话历史,或者在规模化时替换为 Redis。
  3. 开启 Streaming
    若要按 token 流式输出,将stream_handler(LangChain 的AsyncIteratorCallbackHandler)传入 OpenAI LLM 类即可。

🚀 使用 FastAPI 和 Server-Sent Events 提供服务

流式传输是许多基于 LLM 的 API 的短板。传统做法是点“发送”,等 10 秒,然后一次性返回一大段内容——这不是用户期望的体验。

FastAPI 对SSE(Server-Sent Events)的支持非常适合低延迟流式传输。我的接入方式如下:

from fastapi import FastAPIfrom fastapi.responses import StreamingResponsefrom sse_starlette.sse import EventSourceResponse@app.get("/agent/stream")async def stream_agent_response(query: str): async def event_generator(): async for chunk in run_agent_stream(query): yield {"event": "message", "data": chunk} return EventSourceResponse(event_generator())

run_agent_stream()会实时产出来自 LangChain 的 token 片段。前端可以像 OpenAI playground 一样边到边渲染。

自然覆盖的相关搜索:fastapi streaming response, langchain async stream, token streaming openai, how to build real-time LLM agent


🔍 工具集成:搜索、数据库与代码执行

🔎 Web 搜索工具

为回答最新问题,我通过 LangChain 的封装集成了SerpAPI。这让模型可以在不知道答案时“Google 一下”。

from langchain.tools import Toolfrom langchain.utilities import SerpAPIWrappersearch = SerpAPIWrapper()search_tool = Tool( name="Google Search", func=search.run, description="Use this to look up current events or recent data")

📦 PostgreSQL 工具

我通过 LangChain 的 SQL Agent 连接到本地 Postgres 数据库。这样模型就能查询结构化数据,例如产品信息、日志或分析数据。

这对企业内部 Agent 非常有价值。

⚙️ 代码执行工具

为执行逻辑,我用受限的全局变量构建了一个最小化的 Python REPL 沙箱。不要在生产环境中直接使用eval(),除非有强有力的安全措施。建议使用 Docker 沙箱或诸如 Code Interpreter API 的服务。


🎯 实时效果:最终的 UX

连接完成后,用户发出一个请求:

“请总结这篇文章,并计算每个段落的平均词数。另外,附上排名前 3 的来源链接。”

Agent 可能会:

  1. 搜索该文章
  2. 运行代码处理文本
  3. 调用数据库核验来源
  4. 在生成时将答案以 token 流的形式持续推送到前端

这一切都在“直播”进行——用户能看到 Agent 边想边答。

这种交互体验更接近 ChatGPT,但用的是你自己的工具和后端。


⚡ 构建过程中的关键经验

  • 流式传输很关键:按 token 输出的 UX 能显著提升速度感与信任感
  • LLM ≠ 全栈应用:要超越“生成”,外部工具必不可少
  • LangChain 灵活但偏“啰嗦”:要准备好管理复杂的 Prompt
  • FastAPI 非常适合异步:速度飞快,SSE 支持一流
  • 生产安全:在公开前为工具加上限流、日志与监控

📦 Bonus:部署 Agent

我用Docker容器化服务,使用NGINX作为反向代理,并部署到Render(也可选Fly.io)。请将 LLM Key、数据库凭证和搜索 API Key 安全存放在环境变量或密钥管理服务中。

更丰富的前端可采用 React + SWR 搭配 SSE 客户端。这样几乎无延迟地实现实时交互。


🗣 ️结语

这个项目让我意识到,我们正从“Prompt Engineering”迈向工具编排。LLM 不再只是生成器,而是更大系统中的决策者。借助LangChainFastAPI和少量精心挑选的工具,你可以构建会“行动”的 Agent,而不仅仅是会“聊天”的 Agent。

​最后

我在一线科技企业深耕十二载,见证过太多因技术卡位而跃迁的案例。那些率先拥抱 AI 的同事,早已在效率与薪资上形成代际优势,我意识到有很多经验和知识值得分享给大家,也可以通过我们的能力和经验解答大家在大模型的学习中的很多困惑。

我整理出这套 AI 大模型突围资料包:

  • ✅AI大模型学习路线图
  • ✅Agent行业报告
  • ✅100集大模型视频教程
  • ✅大模型书籍PDF
  • ✅DeepSeek教程
  • ✅AI产品经理入门资料

完整的大模型学习和面试资料已经上传带到CSDN的官方了,有需要的朋友可以扫描下方二维码免费领取【保证100%免费】👇👇
​​

为什么说现在普通人就业/升职加薪的首选是AI大模型?

人工智能技术的爆发式增长,正以不可逆转之势重塑就业市场版图。从DeepSeek等国产大模型引发的科技圈热议,到全国两会关于AI产业发展的政策聚焦,再到招聘会上排起的长队,AI的热度已从技术领域渗透到就业市场的每一个角落。


智联招聘的最新数据给出了最直观的印证:2025年2月,AI领域求职人数同比增幅突破200%,远超其他行业平均水平;整个人工智能行业的求职增速达到33.4%,位居各行业榜首,其中人工智能工程师岗位的求职热度更是飙升69.6%。

AI产业的快速扩张,也让人才供需矛盾愈发突出。麦肯锡报告明确预测,到2030年中国AI专业人才需求将达600万人,人才缺口可能高达400万人,这一缺口不仅存在于核心技术领域,更蔓延至产业应用的各个环节。

​​

资料包有什么?

①从入门到精通的全套视频教程⑤⑥

包含提示词工程、RAG、Agent等技术点

② AI大模型学习路线图(还有视频解说)

全过程AI大模型学习路线

③学习电子书籍和技术文档

市面上的大模型书籍确实太多了,这些是我精选出来的

④各大厂大模型面试题目详解

⑤ 这些资料真的有用吗?

这份资料由我和鲁为民博士共同整理,鲁为民博士先后获得了北京清华大学学士和美国加州理工学院博士学位,在包括IEEE Transactions等学术期刊和诸多国际会议上发表了超过50篇学术论文、取得了多项美国和中国发明专利,同时还斩获了吴文俊人工智能科学技术奖。目前我正在和鲁博士共同进行人工智能的研究。

所有的视频教程由智泊AI老师录制,且资料与智泊AI共享,相互补充。这份学习大礼包应该算是现在最全面的大模型学习资料了。

资料内容涵盖了从入门到进阶的各类视频教程和实战项目,无论你是小白还是有些技术基础的,这份资料都绝对能帮助你提升薪资待遇,转行大模型岗位。


智泊AI始终秉持着“让每个人平等享受到优质教育资源”的育人理念‌,通过动态追踪大模型开发、数据标注伦理等前沿技术趋势‌,构建起"前沿课程+智能实训+精准就业"的高效培养体系。

课堂上不光教理论,还带着学员做了十多个真实项目。学员要亲自上手搞数据清洗、模型调优这些硬核操作,把课本知识变成真本事‌!

​​​​

如果说你是以下人群中的其中一类,都可以来智泊AI学习人工智能,找到高薪工作,一次小小的“投资”换来的是终身受益!

应届毕业生‌:无工作经验但想要系统学习AI大模型技术,期待通过实战项目掌握核心技术。

零基础转型‌:非技术背景但关注AI应用场景,计划通过低代码工具实现“AI+行业”跨界‌。

业务赋能 ‌突破瓶颈:传统开发者(Java/前端等)学习Transformer架构与LangChain框架,向AI全栈工程师转型‌。

👉获取方式:

😝有需要的小伙伴,可以保存图片到wx扫描二v码免费领取【保证100%免费】🆓**

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询