news 2026/3/25 10:54:36

基于LangChain与Ollama的API封装实战详解(含完整代码)

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
基于LangChain与Ollama的API封装实战详解(含完整代码)

本文将介绍如果使用 LangChain 封装成 Api 提供给其他人使用。

环境搭建

在开始实际编码之前,首先需要搭建一个干净、稳定的开发环境。本文推荐使用 conda 管理虚拟环境,并利用 pip 安装所需的依赖包。以下将详细介绍如何创建环境并安装相关依赖。

创建开发环境

使用 conda 创建一个独立的虚拟环境,可以确保项目间依赖不会相互干扰。执行以下命令,即可创建名为langchain-api的 Python 3.10 环境:

bin/conda create -n langchain-api python=3.10

这条命令会自动下载并安装 Python 3.10,同时为该环境配置基本的包管理工具。使用虚拟环境不仅有助于依赖的隔离,还能在需要时轻松切换不同版本的 Python 环境,适应各种项目需求。

在创建环境后,记得激活该环境:

conda activate langchain-api
安装依赖包

在环境搭建好后,我们需要安装实现 API 所需的各个依赖包。本文主要涉及以下几个核心组件:

  • langserve:用于将 LangChain 链封装为 API 路由,便于与 FastAPI 集成。
  • langchain:核心链式处理框架,负责提示模板、模型调用等功能。
  • langchain_community:社区扩展包,提供了与 Ollama 大语言模型交互的接口。
  • FastAPI:轻量级、高性能的 Web 框架,用于构建 API 服务。
pip install "langserve[all]" pip install langchain pip install langchain_community pip install fastapi

API 实现原理与代码详解

在完成环境搭建之后,接下来的重点工作便是构建 API 服务。本文将结合代码示例,详细介绍如何利用 LangChain 与 Ollama 模型进行交互,并将整个流程封装为一个 API 接口。

环境依赖导入与模型初始化
# 导入FastAPI库,用于创建Web服务 from fastapi import FastAPI # 从langchain_community.llms模块导入Ollama类,它是与Ollama大语言模型进行交互的接口 from langchain_community.llms import Ollama # 从langchain_core.prompts模块导入ChatPromptTemplate类,用于创建对话提示词模板 from langchain_core.prompts import ChatPromptTemplate # 从langchain_core.output_parsers模块导入StrOutputParser类,用于将模型的输出解析为字符串 from langchain_core.output_parsers import StrOutputParser # 从langserve模块导入add_routes函数,用于将LangChain链添加到FastAPI应用中作为API路由 from langserve import add_routes
对话提示模板与链式处理流程
# 创建输出解析器实例,其作用是将模型的输出转换为字符串类型 output_parser = StrOutputParser() # 初始化Ollama模型的配置 llm = Ollama( # 指定要使用的Ollama模型名称为"deepseek-r1:14b" model="deepseek-r1:14b", # 模型的API端点URL,程序将通过此URL与Ollama模型进行通信 base_url="https://203.0.113.10:8443" ) # 构建对话提示模板 prompt = ChatPromptTemplate.from_messages([ # 系统角色的提示信息,告知模型要用指定的开发语言实现需求代码 # {dev_language} 是一个占位符,在运行时会被具体的开发语言替换 ("system", "请用{dev_language}语言帮我实现这个需求代码"), # 用户角色的提示信息,{user_requirements} 是一个占位符,在运行时会被用户的具体需求替换 ("user", "{user_requirements}") ])

这一部分主要完成了三个功能:

  • 输出解析器:创建了一个 StrOutputParser 实例,用于将模型返回的复杂数据解析为纯文本,便于后续展示和处理。
  • 模型初始化:通过 Ollama 类初始化了大语言模型,并配置了模型名称和 API 端点。此处我们将原有的敏感 URL 替换为示例地址,以保障信息安全。
  • 提示模板构建:利用 ChatPromptTemplate 构建了一个对话提示模板,通过定义系统角色与用户角色的对话内容,将具体的开发语言与用户需求参数化,确保在实际调用时能够灵活生成符合预期的提示信息。

在实际运行中,当用户通过 API 接口传递开发语言及需求描述后,提示模板会自动将占位符替换为具体内容,形成完整的请求文本,随后传递给 Ollama 模型进行处理。

FastAPI 路由注册与服务启动
# 构建处理流水线,它定义了数据的处理流程 # 首先,将输入的数据应用到提示词模板中,生成完整的提示信息 # 然后,将生成的提示信息传递给Ollama模型进行处理 # 最后,使用输出解析器将模型的输出转换为字符串 chain = prompt | llm | output_parser # 以下代码注释掉了,它的作用是执行问答流程 # 调用chain的invoke方法,通过字典传递输入参数,这里的"input"可以替换为具体的需求 # 例如:{"dev_language": "Python", "user_requirements": "实现一个简单的加法函数"} # print(chain.invoke({"input": "容器化相比传统虚拟化有哪些优势?"})) # 把我们的程序部署成服务 # 创建FastAPI的应用实例 # title:应用的标题,用于描述应用的名称 # version:应用的版本号 # description:应用的描述信息,简要说明应用的功能 app = FastAPI(title='LangChain Api 服务', version='V1.0', description='基于 Ollama 的 LangChain Api 服务') # 将LangChain链添加到FastAPI应用中作为API路由 # app:FastAPI应用实例 # chain:要添加的LangChain链 # path:API的访问路径,用户可以通过此路径调用该API add_routes( app, chain, path="/coder", ) # 当脚本作为主程序运行时执行以下代码 if __name__ == "__main__": # 导入uvicorn库,它是一个用于运行ASGI应用的服务器 import uvicorn # 调用uvicorn的run方法启动服务器 # app:要运行的FastAPI应用实例 # host:服务器监听的主机地址,这里设置为本地主机 # port:服务器监听的端口号,这里设置为12345 uvicorn.run(app, host="localhost", port=12345 )

在这一部分中,我们首先将前面构建的提示模板、模型实例和输出解析器通过管道符号(|)串联起来,形成一个完整的数据处理链。该链条从接收用户输入开始,依次完成提示生成、模型调用、输出解析三个环节,最终输出处理后的结果。

接着,我们利用 FastAPI 创建了一个 Web 服务实例,并设置了服务的标题、版本号和描述信息。通过调用add_routes函数,将 LangChain 链注册为 API 路由,使得外部用户可以通过指定路径(此处为/coder)访问我们的服务。最后,使用 uvicorn 启动服务器,使服务能够在本地监听指定端口(12345)。

完整代码,复制即可运行

# 导入FastAPI库,用于创建Web服务 from fastapi import FastAPI # 从langchain_community.llms模块导入Ollama类,它是与Ollama大语言模型进行交互的接口 from langchain_community.llms import Ollama # 从langchain_core.prompts模块导入ChatPromptTemplate类,用于创建对话提示词模板 from langchain_core.prompts import ChatPromptTemplate # 从langchain_core.output_parsers模块导入StrOutputParser类,用于将模型的输出解析为字符串 from langchain_core.output_parsers import StrOutputParser # 从langserve模块导入add_routes函数,用于将LangChain链添加到FastAPI应用中作为API路由 from langserve import add_routes # 创建输出解析器实例,其作用是将模型的输出转换为字符串类型 output_parser = StrOutputParser() # 初始化Ollama模型的配置 llm = Ollama( # 指定要使用的Ollama模型名称为"deepseek-r1:14b" model="deepseek-r1:14b", # 模型的API端点URL,程序将通过此URL与Ollama模型进行通信 base_url="https://u573698-94e7-29ab86b7.nmb1.seetacloud.com:8443" ) # 构建对话提示模板 prompt = ChatPromptTemplate.from_messages([ # 系统角色的提示信息,告知模型要用指定的开发语言实现需求代码 # {dev_language} 是一个占位符,在运行时会被具体的开发语言替换 ("system", "请用{dev_language}语言帮我实现这个需求代码"), # 用户角色的提示信息,{user_requirements} 是一个占位符,在运行时会被用户的具体需求替换 ("user", "{user_requirements}") ]) # 构建处理流水线,它定义了数据的处理流程 # 首先,将输入的数据应用到提示词模板中,生成完整的提示信息 # 然后,将生成的提示信息传递给Ollama模型进行处理 # 最后,使用输出解析器将模型的输出转换为字符串 chain = prompt | llm | output_parser # 以下代码注释掉了,它的作用是执行问答流程 # 调用chain的invoke方法,通过字典传递输入参数,这里的"input"可以替换为具体的需求 # 例如:{"dev_language": "Python", "user_requirements": "实现一个简单的加法函数"} # print(chain.invoke({"input": "容器化相比传统虚拟化有哪些优势?"})) # 把我们的程序部署成服务 # 创建FastAPI的应用实例 # title:应用的标题,用于描述应用的名称 # version:应用的版本号 # description:应用的描述信息,简要说明应用的功能 app = FastAPI(title='LangChain Api 服务', version='V1.0', description='基于 Ollama 的 LangChain Api 服务') # 将LangChain链添加到FastAPI应用中作为API路由 # app:FastAPI应用实例 # chain:要添加的LangChain链 # path:API的访问路径,用户可以通过此路径调用该API add_routes( app, chain, path="/coder", ) # 当脚本作为主程序运行时执行以下代码 if __name__ == "__main__": # 导入uvicorn库,它是一个用于运行ASGI应用的服务器 import uvicorn # 调用uvicorn的run方法启动服务器 # app:要运行的FastAPI应用实例 # host:服务器监听的主机地址,这里设置为本地主机 # port:服务器监听的端口号,这里设置为12345 uvicorn.run(app, host="localhost", port=12345 )

API 接口部署与测试

使用 curl 进行接口测试
curl -X POST -H "Content-Type: application/json" -d '{ "input": { "dev_language": "Python", "user_requirements":"写一个冒泡排序" } }' http://localhost:12345/coder/invoke

上述命令解释:

  • -X POST:指定 HTTP 请求方法为 POST,因为调用/invoke接口通常是通过 POST 请求传递数据。
  • -H "Content-Type: application/json":设置请求头,表明发送的数据是 JSON 格式。
  • -d '{...}'-d参数用于在请求体中发送数据,花括号内是具体的 JSON 格式请求参数,按照接口要求构造,这里设置了dev_languageJavauser_requirements写一个冒泡排序
  • http://localhost:12345/coder/invoke:指定请求的接口地址。
通过 ApiFox 调用

总结

本文详细介绍了如何利用 LangChain 将大语言模型封装成 API 接口,并基于 FastAPI 构建了一个高性能、模块化的服务平台。

想入门 AI 大模型却找不到清晰方向?备考大厂 AI 岗还在四处搜集零散资料?别再浪费时间啦!2026 年AI 大模型全套学习资料已整理完毕,从学习路线到面试真题,从工具教程到行业报告,一站式覆盖你的所有需求,现在全部免费分享

👇👇扫码免费领取全部内容👇👇

一、学习必备:100+本大模型电子书+26 份行业报告 + 600+ 套技术PPT,帮你看透 AI 趋势

想了解大模型的行业动态、商业落地案例?大模型电子书?这份资料帮你站在 “行业高度” 学 AI

1. 100+本大模型方向电子书

2. 26 份行业研究报告:覆盖多领域实践与趋势

报告包含阿里、DeepSeek 等权威机构发布的核心内容,涵盖:

  • 职业趋势:《AI + 职业趋势报告》《中国 AI 人才粮仓模型解析》;
  • 商业落地:《生成式 AI 商业落地白皮书》《AI Agent 应用落地技术白皮书》;
  • 领域细分:《AGI 在金融领域的应用报告》《AI GC 实践案例集》;
  • 行业监测:《2024 年中国大模型季度监测报告》《2025 年中国技术市场发展趋势》。

3. 600+套技术大会 PPT:听行业大咖讲实战

PPT 整理自 2024-2025 年热门技术大会,包含百度、腾讯、字节等企业的一线实践:

  • 安全方向:《端侧大模型的安全建设》《大模型驱动安全升级(腾讯代码安全实践)》;
  • 产品与创新:《大模型产品如何创新与创收》《AI 时代的新范式:构建 AI 产品》;
  • 多模态与 Agent:《Step-Video 开源模型(视频生成进展)》《Agentic RAG 的现在与未来》;
  • 工程落地:《从原型到生产:AgentOps 加速字节 AI 应用落地》《智能代码助手 CodeFuse 的架构设计》。

二、求职必看:大厂 AI 岗面试 “弹药库”,300 + 真题 + 107 道面经直接抱走

想冲字节、腾讯、阿里、蔚来等大厂 AI 岗?这份面试资料帮你提前 “押题”,拒绝临场慌!

1. 107 道大厂面经:覆盖 Prompt、RAG、大模型应用工程师等热门岗位

面经整理自 2021-2025 年真实面试场景,包含 TPlink、字节、腾讯、蔚来、虾皮、中兴、科大讯飞、京东等企业的高频考题,每道题都附带思路解析

2. 102 道 AI 大模型真题:直击大模型核心考点

针对大模型专属考题,从概念到实践全面覆盖,帮你理清底层逻辑:

3. 97 道 LLMs 真题:聚焦大型语言模型高频问题

专门拆解 LLMs 的核心痛点与解决方案,比如让很多人头疼的 “复读机问题”:


三、路线必明: AI 大模型学习路线图,1 张图理清核心内容

刚接触 AI 大模型,不知道该从哪学起?这份「AI大模型 学习路线图」直接帮你划重点,不用再盲目摸索!

路线图涵盖 5 大核心板块,从基础到进阶层层递进:一步步带你从入门到进阶,从理论到实战。

L1阶段:启航篇丨极速破界AI新时代

L1阶段:了解大模型的基础知识,以及大模型在各个行业的应用和分析,学习理解大模型的核心原理、关键技术以及大模型应用场景。

L2阶段:攻坚篇丨RAG开发实战工坊

L2阶段:AI大模型RAG应用开发工程,主要学习RAG检索增强生成:包括Naive RAG、Advanced-RAG以及RAG性能评估,还有GraphRAG在内的多个RAG热门项目的分析。

L3阶段:跃迁篇丨Agent智能体架构设计

L3阶段:大模型Agent应用架构进阶实现,主要学习LangChain、 LIamaIndex框架,也会学习到AutoGPT、 MetaGPT等多Agent系统,打造Agent智能体。

L4阶段:精进篇丨模型微调与私有化部署

L4阶段:大模型的微调和私有化部署,更加深入的探讨Transformer架构,学习大模型的微调技术,利用DeepSpeed、Lamam Factory等工具快速进行模型微调,并通过Ollama、vLLM等推理部署框架,实现模型的快速部署。

L5阶段:专题集丨特训篇 【录播课】


四、资料领取:全套内容免费抱走,学 AI 不用再找第二份

不管你是 0 基础想入门 AI 大模型,还是有基础想冲刺大厂、了解行业趋势,这份资料都能满足你!
现在只需按照提示操作,就能免费领取:

👇👇扫码免费领取全部内容👇👇

2026 年想抓住 AI 大模型的风口?别犹豫,这份免费资料就是你的 “起跑线”!

版权声明: 本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若内容造成侵权/违法违规/事实不符,请联系邮箱:809451989@qq.com进行投诉反馈,一经查实,立即删除!
网站建设 2026/3/15 0:27:00

2026年3月Tiobe编程语言榜:Rust排名大涨,Go/Kotlin受关注

每年三月的Tiobe编程语言排行榜都是开发者关注的焦点,它反映了过去一段时间内编程语言的流行趋势和技术社区的关注变化。2026年3月的榜单已经出炉,其中既有意料之中的稳固者,也出现了令人瞩目的新变动。这份榜单不仅仅是名次的排列&#xff0…

作者头像 李华
网站建设 2026/3/21 12:21:32

当AI的思考凝结成冰:深度解析法律推理中震撼的“结晶化”效应

引言:AI思维的一次“相变” 想象一下,一台更复杂、更强大的机器,其思考问题的方式非但没有变得更加错综复杂,反而变得异常简洁、笔直,宛如晶体般完美。这听起来有悖常理,但这正是当前人工智能领域在法律推…

作者头像 李华
网站建设 2026/3/16 3:12:29

中大型企业 HR SaaS 怎么选?8 家厂商实力 PK

在企业数字化转型纵深推进的当下,HR SaaS 系统已从单纯的工具辅助升级为支撑人才战略落地、激活组织效能的核心载体。选对 HR SaaS 厂商,不仅能显著提升人力管理效率、优化管理成本,更能让人才价值与企业战略深度绑定;反之&#x…

作者头像 李华
网站建设 2026/3/21 11:09:11

综述不会写?AI论文网站 千笔AI VS 学术猹,自考写作神器!

随着人工智能技术的迅猛发展,AI辅助写作工具正逐渐成为高校学生完成毕业论文的重要帮手。无论是开题报告、文献综述还是整篇论文的撰写,越来越多的学生开始借助AI工具提升效率、降低写作难度。然而,面对市场上种类繁多、功能各异的AI写作平台…

作者头像 李华
网站建设 2026/3/20 6:55:56

导师严选9个降AIGC网站,千笔助你轻松降AI率

AI降重工具:让论文更自然,让学术更安心 在当前高校论文审核日益严格的背景下,许多学生发现,使用AI生成的内容容易被检测出高AIGC率,导致论文无法通过审核。而随着查重系统对AI痕迹的识别能力不断提升,传统的…

作者头像 李华
网站建设 2026/3/24 19:30:23

万和制药:改善皮肤干燥的内服调理办法

皮肤干燥是常见的肌肤问题,仅靠外用保湿难以从根源改善,通过科学的内服调理补充肌肤所需营养,才能让皮肤由内而外维持水润状态。内服调理需遵循循序渐进原则,结合水分补充、营养摄入等方式,长期坚持方可见效。补充水分…

作者头像 李华