五步,把一个真实需求
做成能上线的智能体
这是朱丽叶老师开发智能体时一直在用的流程。核心只有一句话:先问清楚,再画出来,拿给用户看,再写代码,最后上线。每一步都有可直接复制的提示词,本教程以“辅导员工作智能体”为贯穿案例。
- 01需求说清场景,让 AI 反过来问你需求确认稿
- 02前端 UI画布 ONE 推理出界面原型图2 张原型图
- 03沟通拿原型找用户,录音并整理纪要修订版方案
- 04开发PRD + 原型图交给 AI 开发可运行的平台
- 05部署先预览,再申请云主机正式上线线上网址
说清楚场景,再让 AI 反过来问你
不要一上来就让 AI“帮我做个智能体”。信息不够,AI 只能凭空猜,做出来的东西往往不是用户要的。先把场景讲明白,再让 AI 用苏格拉底式提问一轮轮追问,直到它掌握足够的信息,才开始出方案。
开口前先想清楚四件事
- 为谁做:使用者是谁?(例如:高校辅导员)
- 在什么行业 / 场景:他在什么环节、什么时间用?(例如:学生日常管理、谈心谈话、评奖评优)
- 解决什么问题:现在哪里费时、易出错、记不住?
- 做到什么程度算成功:例如“写一份谈心记录从 30 分钟缩短到 5 分钟”。
什么是苏格拉底式提问?
不直接给答案,而是通过一连串追问,帮你把模糊的想法想清楚。对开发者来说,它有三个好处:
- 逼出你没想到的细节:数据从哪来、谁来维护、出错怎么办;
- AI 的每个问题都是一次“需求访谈”,答完就是一份需求记录;
- 信息足够后再出方案,返工最少。
填一填,生成你的开场提示词
对话会是这个样子
AI 通常会追问这些,提前想好答案
- 一天用几次?在电脑上用还是手机上用?
- 需要哪些数据?谁录入、谁维护、多久更新?
- 有没有必须遵守的规范、模板或保密要求?
- 哪些功能必须有,哪些可以第二期再做?
- AI 回答错了怎么办?需要人工审核吗?
小技巧:回答不出来的问题,就如实说“不确定”,让 AI 给出几个选项供你选。
用画布 ONE,把方案“画”成界面
把第一步的开发方案交给 画布 ONE,选用其中最强的生图模型 gpt-image2.5。它会先根据方案推理“这个软件应该有哪些页面、每页放什么”,再生成前端界面图。这一步只做前端外观,不涉及后台。
至少生成两张图
- 外观(首页):用户打开后第一眼看到的样子——标题、功能入口、主要信息。
- 点进去(功能页):点开核心功能后的样子——例如对话页、表单页、详情页。
为什么是两张:一张定风格,一张定交互。这两张图会在第三步拿给用户看,在第四步交给 AI 当作开发依据。
主色调跟着行业走
颜色能让用户一眼认出“这是给我们行业做的”。辅导员从事学生思想政治工作,所以示例用了红色思政元素。你也可以从下面选一个,或者直接对 AI 说:“请根据行业特点帮我定主色调。”
3 名学生待回访 · 1 份通知待发布
本周主题教育学习材料已更新
图① 外观:首页(示意)
· 主要问题:作息紊乱、缺课
· 原因分析:游戏依赖、家庭沟通
· 跟进建议:两周后回访,联系任课老师
仅本人及学院学工负责人可见
图② 点进去:功能页(示意)
拿着原型去找用户,把想法“录”下来
带着第一步的开发方案和第二步的原型图,当面找辅导员沟通,并全程录音。
1 · 展示
先讲 1 分钟“这是为谁、解决什么问题”,再逐张展示原型图,让对方想象自己在用。
2 · 录音
征得对方同意后,用千问 App 全程录音。沟通结束后用“录音纪要”自动生成文字稿和要点。
3 · 整理
把录音纪要、你的会议笔记和原方案一起交给 AI,生成文字版的修订方案。
现场可以这样问(勾选已问过的)
注意:录音前必须征得对方同意;沟通时用虚构或脱敏的示例,不要出现真实学生的姓名、学号、成绩和心理状况等隐私信息。
先写 PRD,再把 PRD 和原型图一起交给 AI
PRD(产品需求文档)是 AI 开发的“施工图”。先让 AI 根据修订方案生成 PRD,你检查确认后,再把 PRD 和第二步的两张原型图一起发给 Claude、Codex 等开发工具,让它据此开发整个平台。
一份合格的 PRD 至少包含这 9 部分
两种大模型接入方式,在管理员后台二选一
DeepSeek 官方 API
在 DeepSeek 开放平台创建 API Key。
- 接口地址:
https://api.deepseek.com - 常用模型:
deepseek-chat
TokenOne 中转站
中转站会给出一段连接信息,格式如下(Key 已隐去):
{"_type":"newapi_channel_conn","key":"sk-********","url":"https://token.agentone.work"}
按 OpenAI 兼容方式调用,接口地址一般为 https://token.agentone.work/v1。
API Key 安全:真实的 Key 不要写进代码、提示词或截图,也不要上传到 GitHub。让 AI 把 Key 做成管理员后台的配置项,部署后由管理员在后台填写,页面上只显示打码后的值。
先预览看效果,再正式上线
根据用途选择不同的部署路径。
WorkBuddy 一键上传
- 让 AI 把项目打包成部署包(zip),并写明启动方式;
- 在 WorkBuddy 中上传部署包;
- 获得预览网址,发给用户试用、收集反馈;
- 根据反馈回到第三、四步迭代。
适合:课堂展示、比赛演示、给用户看效果。不要在预览环境里录入真实的学生数据。
申请学校云主机
- 由使用方(辅导员所在学院)向学校网信处提出申请;
- 说明系统用途、访问范围、涉及的数据类型;
- 网信处开通云主机后,按部署包说明安装上线;
- 在管理员后台配置 API Key,完成验收后正式使用。
适合:长期使用、涉及真实数据的场景。系统由学校统一管理,数据安全更有保障。