用LangChain快速实现天气查询智能体 1. 引言从 API 到对话式助手调用天气 API 并不难但要让用户能用自然语言询问“今天北京热不热”“上海会下雨吗”并自动查询、返回友好回答——这就是 LangChain 大显身手的场景。本文带你用不到 50 行代码从零搭建一个可对话的天气查询助手无需前端、无需复杂配置只需 Python 和一个本地 LLM。读完你将掌握如何将任意 API 封装成 LangChain 的tool如何使用create_agent快速构建一个智能体如何用system_prompt精细化控制助手行为2. 准备工作2.1 环境依赖确保已安装以下 Python 包pipinstalllangchain langchain-ollama requests pandaslangchain主体框架langchain-ollamaOllama 模型集成requests调用天气 APIpandas读取城市代码映射表2.2 天气 API 与城市映射天气数据来自第三方 API需要准备以下两项城市代码映射文件city.csv包含province、city、district、areacode/城市ID等字段用于根据城市名查找接口所需的城市代码。API 令牌在请求头中携带X-APISpace-Token进行鉴权。文中使用的 API 及 Token 仅供参考示例实际使用时请替换为你自己的接口和密钥。3. 核心实现3.1 城市代码查询首先实现一个辅助函数根据用户输入的城市名称如“北京”“上海浦东”匹配到对应的城市代码。importpandasaspddefget_city_code(city_name:str): 根据城市名称获取城市代码 参数city_name: 城市名称如北京、上海浦东等 city_dfpd.read_csv(city.csv)# 按区县精确匹配matchcity_df[city_df[district]city_name]ifnotmatch.empty:returnmatch.iloc[0][areacode/城市ID]# 按城市名匹配matchcity_df[city_df[city]city_name]ifnotmatch.empty:returnmatch.iloc[0][areacode/城市ID]# 按省份模糊匹配matchcity_df[city_df[province].str.contains(city_name,naFalse)]ifnotmatch.empty:returnmatch.iloc[0][areacode/城市ID]# 兜底返回默认城市代码北京return101010100匹配优先级为区县 城市 省份未匹配时返回默认代码。3.2 封装天气工具使用tool装饰器将天气查询函数封装为 LangChain 工具让智能体能够自动识别并调用它。importrequestsfromlangchain.toolsimporttooltooldefget_weather(city:str): 获取实时天气信息返回温度及天气状况 参数city: 城市名称如北京 urlhttps://api.example.com/weathercity_codeget_city_code(city)payload{areacode:city_code}headers{X-APISpace-Token:your_token_here}responserequests.request(GET,url,paramspayload,headersheaders)dataresponse.json()tempdata.get(result).get(realtime).get(temp)wddata.get(result).get(realtime).get(text)returnf{city}的实时天气{temp}°C{wd}tool装饰器会根据函数签名和 docstring 自动生成工具描述智能体正是通过这个描述来判断何时调用该工具。3.3 创建并运行助手最后用create_agent把语言模型和工具组合成一个天气查询助手。fromlangchain.agentsimportcreate_agentfromlangchain_ollamaimportChatOllama llmChatOllama(modeldeepseek-r1:1.5b)tools[get_weather]prompt你是天气查询助手请根据用户的问题调用天气工具。# 创建智能体agentcreate_agent(modelllm,toolstools,system_promptprompt)# 调用智能体responseagent.invoke({messages:[{role:user,content:北京天气如何}]})print(response[messages][-1].content)至此天气查询助手就搭建完成了。用户输入自然语言问题智能体会自动判断何时调用天气工具并将 API 返回的数据整合成自然语言回复。4. 运行结果示例当你运行上述代码时会得到类似如下的输出北京今天的天气是 26°C晴。很适合出门活动哦你也可以自由提问比如responseagent.invoke({messages:[{role:user,content:上海和深圳哪个更热}]})助手会自动多次调用get_weather工具分别查询两座城市的天气然后对比回答。5. 进阶优化方向本文实现的助手虽然基础但已经具备了智能体的核心能力。你可以从以下方向继续优化错误处理当 API 请求失败或城市不存在时添加友好的提示信息。系统提示词优化精细化system_prompt比如让助手在回复时附带穿衣建议、出行提醒等。工具扩展添加更多工具如空气质量查询、未来天气预报让助手能力更全面。记忆与上下文加入对话记忆组件让助手能记住你上一轮问的城市实现多轮对话。切换模型将ChatOllama替换为ChatOpenAI或其他兼容接口接入更强大的模型。6. 总结本文完整演示了使用 LangChain 构建天气查询助手的全过程封装外部 API 为工具tool编写辅助函数处理城市代码映射用create_agent组合模型与工具设置系统提示词定义助手行为整个流程不超过 50 行代码却实现了从自然语言输入到自然语言输出的完整闭环。这个模式不仅适用于天气查询也可以快速迁移到股票查询、新闻播报、快递跟踪等任何需要连接外部 API 的场景——关键是你几乎不需要写任何业务逻辑的胶水代码。

相关新闻

最新新闻

13种贝斯线编曲实战技巧:从律动构建到混音处理全解析

13种贝斯线编曲实战技巧:从律动构建到混音处理全解析

在实际音乐制作和编曲过程中,贝斯线(Bassline)是连接节奏与和声的骨架,它决定了音乐的律动感和情感基调。很多制作人,尤其是刚接触编曲的朋友,常常会遇到低音部分听起来单调、缺乏变化、无法与旋律和鼓点有…

2026/8/1 3:59:07
VC++ 2013运行库深度解析:从DLL依赖到开源部署实践

VC++ 2013运行库深度解析:从DLL依赖到开源部署实践

1. 项目概述:为什么我们需要关注一个“老掉牙”的运行库?如果你在Windows上折腾过稍微有点年头的软件或者游戏,大概率见过这个弹窗:“无法启动此程序,因为计算机中丢失 VCRUNTIME140.dll”或者“MSVCP120.dll 未找到”…

2026/8/1 3:59:07
Python可视化五大激活函数及其导数:从Sigmoid到Softmax的深度解析

Python可视化五大激活函数及其导数:从Sigmoid到Softmax的深度解析

1. 从“画”开始:为什么我们要亲手绘制激活函数?如果你刚开始接触深度学习或者神经网络,可能会在无数的教程和论文里看到Sigmoid、ReLU这些名字。它们通常被称作“激活函数”,是神经网络里决定神经元是否“兴奋”的关键组件。很多…

2026/8/1 3:59:07
Python彻底卸载与缓存清理指南:解决环境冲突与残留问题

Python彻底卸载与缓存清理指南:解决环境冲突与残留问题

1. 为什么“彻底卸载”Python比安装更棘手?如果你在搜索引擎里输入“Python卸载”,大概率会看到一堆教你用控制面板或者第三方工具卸载的教程。但作为一个和Python环境打了多年交道的开发者,我必须告诉你,这些方法绝大多数都只做了…

2026/8/1 3:59:07
预测建模的思想基石:从观察到决策

预测建模的思想基石:从观察到决策

各位同学,今天我们聊一个既朴素又深刻的话题——预测建模到底是什么?很多人一听到“模型”二字,脑海里浮现的是复杂的公式、密密麻麻的代码,似乎那是数学家和程序员的事情。但在我的课堂上,我始终强调一个观点&#xf…

2026/8/1 3:59:07
乐鑫ESP32环形缓冲区设计解析:从原理到SPI/UART驱动实战

乐鑫ESP32环形缓冲区设计解析:从原理到SPI/UART驱动实战

1. 项目概述:为什么乐鑫的环形缓冲区值得深挖?如果你在乐鑫的ESP-IDF代码仓库里翻过,或者调试过ESP32、ESP32-C3这类芯片的驱动,大概率会碰到一个叫ringbuf或者ring_buffer的东西。它不是什么高深莫测的黑科技,但却是乐…

2026/8/1 3:54:07