Python实战：从零构建天气查询Agent的完整指南

1. 为什么你需要一个天气查询Agent每次出门前都要手动打开天气App查温度或者总忘记带伞被突然的暴雨淋成落汤鸡这些烦恼其实可以用几行Python代码解决。我最近刚用Python给自己写了个天气查询Agent现在每天早上刷牙时喊一声查今天天气它就会自动播报温度和穿衣建议简直不要太方便。这个Agent本质上就是个能听懂人话、会查天气、还能说人话的小程序。比如你说上海后天要下雨吗它能准确提取上海和后天这两个关键信息然后去天气网站把数据抓回来最后整理成上海后天多云转小雨记得带伞这样的自然语言回复。整个过程完全自动化就像有个私人气象员随时待命。相比传统天气App这种Agent有三大优势场景化服务可以直接用自然语言交互不用在App里点点点可定制化能根据你的习惯添加功能比如我加了个如果下雨就提醒带伞的逻辑开发简单用Python免费API不到200行代码就能搞定2. 开发前的准备工作2.1 工具安装与环境配置首先确保你的电脑上有Python 3.9或更高版本。我强烈建议用VS Code这个编辑器它的Python插件对新手特别友好能自动提示代码错误。安装时记得勾选Add Python to PATH这个选项否则后面运行命令会报错。接下来需要两个关键库requests用来调用天气API获取数据openai用来理解用户的自然语言输入安装命令很简单打开终端输入pip install requests openai如果遇到pip不是内部命令的报错说明Python环境没配置好重新安装Python并勾选PATH选项即可。2.2 申请免费API密钥我们需要两个API和风天气API提供实时天气数据OpenAI API用于自然语言理解注册和风天气账号后在控制台创建应用就能拿到KEY。免费版每天可以查1000次完全够用。OpenAI的API密钥在官网个人设置里能找到新用户有5美元免费额度。注意国内用户如果访问OpenAI有困难可以用阿里云的通义千问API替代调用方式类似。3. 核心模块开发实战3.1 自然语言理解模块新建agent_understand.py文件这个模块的任务是把用户说的北京明天天气怎么样转换成{city:北京,day:1}这样的结构化数据。关键点在于给AI的指令(prompt)要写清楚prompt f 任务从用户输入中提取2个信息 1. city城市名没说默认北京 2. day查询天数今天0明天1... 示例 用户输入查上海后天天气 → 返回{city:上海,day:2} 用户现在输入{input_text} 只返回JSON不要加其他字 我测试时发现如果用户说后天下午的天气AI可能会把下午也识别为day参数。所以prompt里要强调day只能是整数。另外温度参数设为0可以让结果更稳定避免AI自由发挥。3.2 天气数据获取模块在agent_tool.py中我们需要处理两个核心问题把中文城市名转成API需要的城市ID处理API返回的复杂数据提取关键信息和风API返回的数据结构比较繁琐我做了简化处理daily_weather weather_data[daily][day] # 获取指定日期的数据 result { city: city, date: daily_weather[fxDate], text: daily_weather[textDay], temp_min: daily_weather[tempMin], temp_max: daily_weather[tempMax] }这里有个坑要注意API返回的温度是字符串类型如果要做数值比较比如判断是否低于10度需要先用int()转换。3.3 主程序整合最后的weather_agent.py要把前两个模块串起来实现完整流程。我加了个while循环让用户可以连续查询还增加了错误处理try: user_info understand_user(input_text) except Exception as e: print(f理解失败{str(e)}) continue为了让交互更友好我设计了自然语言回复模板reply f {city}{date}天气 • 状况{text} • 温度{temp_min}~{temp_max}℃ • 建议{get_suggestion(text, temp_min)} 这个get_suggestion()是我自己加的额外功能根据天气状况给出穿衣建议实测特别实用。4. 常见问题与调试技巧4.1 API调用问题新手最容易遇到的是401未授权错误通常有三个原因API密钥输错了注意不要有空格免费额度用完了网络问题特别是公司内网可能会拦截API请求我的调试经验是先用Postman单独测试API是否正常在代码里打印完整的API响应看看错误详情如果是OpenAI的问题可以先用简单文本测试prompt是否有效4.2 中文编码问题当城市名包含生僻字时可能会遇到Unicode编码问题。解决方法是在请求URL中使用from urllib.parse import quote city quote(city) # 对中文进行URL编码4.3 性能优化当用户查询北京明天天气时我发现程序会先查城市ID再查天气总共要2次API调用。其实可以把常用城市ID缓存起来下次直接使用。我用了Python的shelve模块来实现这个功能import shelve with shelve.open(city_cache) as db: if city in db: city_id db[city] else: city_id fetch_city_id(city) db[city] city_id5. 进阶功能扩展5.1 添加语音交互用pyttsx3和SpeechRecognition这两个库可以轻松实现语音输入输出import speech_recognition as sr r sr.Recognizer() with sr.Microphone() as source: print(请说出你的查询...) audio r.listen(source) text r.recognize_google(audio, languagezh-CN)5.2 多城市查询改进get_weather函数支持同时查询多个城市def get_multi_weather(cities, day): results [] for city in cities.split(和): # 处理北京和上海 results.append(get_weather(city.strip(), day)) return results5.3 定时天气推送结合Windows任务计划或Linux的cron可以实现每天早上8点自动推送天气import schedule import time def morning_report(): weather get_weather(北京, 0) send_notification(weather) schedule.every().day.at(08:00).do(morning_report) while True: schedule.run_pending() time.sleep(60)这个项目最让我惊喜的是用这么简单的代码就能实现一个真正有用的智能助手。现在我的家人都在用这个天气Agent下一步我准备把它部署到云服务器上做成一个微信小程序。Python的魅力就在于此——用最少的代码解决实际问题。