「Vibe Coding AI编程实战」系列已经来到第三篇。
上一回,我们成功搭建了AI聊天机器人的前端用户界面,外观已经像模像样了。但有个问题——它目前还是个“哑巴”,点击后没有任何响应,因为后端的大模型尚未接入。今天的目标,就是把它连接起来,同时把整个前后端联调的关键技巧讲清楚。
这一步,是整个项目中最容易让人放弃的环节。坑点多到让人想直接弃坑。不过别着急,这里有一个经过验证的实用方法,能帮你避开九成以上的报错。
先说说为什么这么容易劝退
很多人到了这个阶段,做法都差不多:把API地址、密钥一股脑儿扔给AI,然后说“帮我把大模型接到后端,再和前端联调”。
结果呢?前端一报错,AI就开始改。改完还报错,接着改。你不停重复“接口参数不对”,AI根本不知道具体哪里不对,只能胡乱修改一通。折腾半天,消耗了大量token,功能依然没通。
AI其实并不笨,它只是不知道这个接口真实返回的数据长什么样。你给它的只是文档描述,而文档与实际返回之间,总是存在差异。
测试先行:一个被低估的关键步骤
实际上做法很简单,只需在常规操作前多加一步。
在让AI做联调之前,先让它新建一个.py的小测试文件,单独把大模型接口调通。调通之后,让它把真实返回的每个字段都记录下来——哪个字段是普通对话内容、哪个字段是思考过程、哪个字段在流式输出里才有值。
把这份字段规范当作“对接说明书”,再让AI去做前后端联调。
这一步看起来像是多此一举,但实际上这是整个流程中最有价值的一招。当AI手里有了真实返回的样本,它就能照着对接,基本一次就能成功。
接入千问:先把门牌号拿到
后端使用的是阿里云百炼上的通义千问(Qwen)。国内大厂,稳定,模型种类丰富,对话和深度推理都能在同一套接口中切换。需要注意的一点是:百炼的模型更新很快,目前旗舰是Qwen3.7-Max,还有主打多模态的Qwen3.7-Plus、轻量高效的Qwen-Turbo,要深度推理的还有Qwen3-Max-Thinking。动手前,先去百炼控制台的模型市场看看,选一个尚未停更的型号,不要对着一个即将下架的名称死磕。
接入第一步,前往阿里云百炼控制台开通服务,获得一个API Key(DashScope的密钥)。这串字符就是调用大模型的“门牌号”,没有它什么都做不了。
拿到之后,先别着急往代码里塞。先做最小测试。
最小测试长什么样
让AI新建那个.py文件,做三件事。
第一,把API Key写在配置文件里,不要硬编码进代码——这是基本习惯,避免日后泄露。第二,调通最基础的对话接口,确认密钥、地址、模型名都正确。百炼兼容OpenAI的接口格式,直接用OpenAI那套请求即可,门槛很低。第三,开启流式输出(SSE),让模型一个字一个字往外吐,而不是等半天才一起蹦出来。
千问这种支持思考模式的模型有个特点:同一个模型名,靠一个参数就能切换“普通对话”和“深度思考”两种模式。思考模式下,模型会先把推理过程输出,再给出最终答案。这两种模式返回的字段不同,测试时都得跑一遍,都得记录下来。
测试跑通、字段记录好,准备工作就完成了。
轮到联调:拿着说明书干活
拿着这份规范,再让AI去做前后端对接。提示里把规范贴过去,明确告诉它“按测试好的字段对接”。
这一步基本不用你操心了。AI有了真实样本,照葫芦画瓢,一次通过的概率极高。实际操作中,刷新前端后,对话框就能正常聊天了——普通问答、深度推理、上下文记忆,全部都能正常运行。
关于MCP:工具很好,但自己的流程更可控
有人会问:现在不是有MCP、Context7这些工具吗,让AI自动拉取最新的接口规范,岂不是更省事?
试过,确实在某些场景下管用。但实际体验是:它拉下来的规范,token消耗比我直接贴官方示例多得多,而且整个过程像个黑盒,你不知道它到底拉了什么、拉全了没有。规范一旦有缺失,AI照样会胡乱修改。
所以,更倾向于“笨”一点的方法:自己去官方文档找对应功能的示例,粘贴过来,让AI先跑测试、自己总结真实返回,再对接。所有参数都掌握在自己手里,既省token,又可控。
真报错了:F12比你想象的管用
联调并不是一次都不报错。关键是快速定位。
前端点击按钮没反应,或者行为异常,别急着让AI改代码。先按F12,打开浏览器的开发者工具,看Console和Network两个标签。报错信息通常都在这里——是路由没注册、跨域问题,还是服务没启动。
看清楚之后,把报错原样复制给AI,让它自己改。整个过程不需要打开任何一个代码文件,以结果为导向即可。这次遇到的就是一个跨域问题,不是代码的锅,是服务配置的事。把报错一贴,AI几秒就修好了。
思路比代码更值钱
走到这一步,整个聊天机器人就算完工了:能聊天、能思考、能记住上下文。
回头一看,全程没有敲一行代码,也没有打开过任何一个文件去查。但这不代表你什么都不用做——你需要做的是设计功能、规划顺序、在AI动手前把关键信息提前交代清楚。先跑测试、记字段、再联调,就是这么个“提前交代”的动作。
思路对了,零基础也能照着走下去。下一篇,继续聊。
