开放性实验 · 智能体开发 ← 返回首页
NEXAI 创新工坊 · 开放性实验教程

五步,把一个真实需求
做成能上线的智能体

这是朱丽叶老师开发智能体时一直在用的流程。核心只有一句话:先问清楚,再画出来,拿给用户看,再写代码,最后上线。每一步都有可直接复制的提示词,本教程以“辅导员工作智能体”为贯穿案例。

苏格拉底式提问画布 ONE · gpt-image2.5千问录音纪要PRD + 原型图驱动开发DeepSeek / TokenOneWorkBuddy 预览部署
  1. 01需求说清场景,让 AI 反过来问你需求确认稿
  2. 02前端 UI画布 ONE 推理出界面原型图2 张原型图
  3. 03沟通拿原型找用户,录音并整理纪要修订版方案
  4. 04开发PRD + 原型图交给 AI 开发可运行的平台
  5. 05部署先预览,再申请云主机正式上线线上网址
贯穿案例:高校辅导员工作智能体需求 → 原型 → 反馈 → 开发 → 上线
01
STEP 1 · 需求

说清楚场景,再让 AI 反过来问你

不要一上来就让 AI“帮我做个智能体”。信息不够,AI 只能凭空猜,做出来的东西往往不是用户要的。先把场景讲明白,再让 AI 用苏格拉底式提问一轮轮追问,直到它掌握足够的信息,才开始出方案。

开口前先想清楚四件事

  1. 为谁做:使用者是谁?(例如:高校辅导员)
  2. 在什么行业 / 场景:他在什么环节、什么时间用?(例如:学生日常管理、谈心谈话、评奖评优)
  3. 解决什么问题:现在哪里费时、易出错、记不住?
  4. 做到什么程度算成功:例如“写一份谈心记录从 30 分钟缩短到 5 分钟”。

什么是苏格拉底式提问?

不直接给答案,而是通过一连串追问,帮你把模糊的想法想清楚。对开发者来说,它有三个好处:

  • 逼出你没想到的细节:数据从哪来、谁来维护、出错怎么办;
  • AI 的每个问题都是一次“需求访谈”,答完就是一份需求记录;
  • 信息足够后再出方案,返工最少。

填一填,生成你的开场提示词

开场提示词(自动生成)

        

对话会是这个样子

AI辅导员整理谈心记录时,原始信息是什么形式?手写笔记、录音,还是聊完凭记忆补?
我多数是聊完凭记忆写,有时用手机录音。
AI这些记录涉及学生隐私。谁可以看?需要只在校内网使用吗?
我只有本人和学院学工负责人能看,最好部署在学校服务器上。
AI明白了。我先复述一下目前的理解,请你确认……

AI 通常会追问这些,提前想好答案

  • 一天用几次?在电脑上用还是手机上用?
  • 需要哪些数据?谁录入、谁维护、多久更新?
  • 有没有必须遵守的规范、模板或保密要求?
  • 哪些功能必须有,哪些可以第二期再做?
  • AI 回答错了怎么办?需要人工审核吗?

小技巧:回答不出来的问题,就如实说“不确定”,让 AI 给出几个选项供你选。

需求确认稿(AI 复述、你确认的版本)初版开发方案(功能清单 + 页面结构)
02
STEP 2 · 前端 UI

用画布 ONE,把方案“画”成界面

把第一步的开发方案交给 画布 ONE,选用其中最强的生图模型 gpt-image2.5。它会先根据方案推理“这个软件应该有哪些页面、每页放什么”,再生成前端界面图。这一步只做前端外观,不涉及后台。

至少生成两张图

  1. 外观(首页):用户打开后第一眼看到的样子——标题、功能入口、主要信息。
  2. 点进去(功能页):点开核心功能后的样子——例如对话页、表单页、详情页。

为什么是两张:一张定风格,一张定交互。这两张图会在第三步拿给用户看,在第四步交给 AI 当作开发依据。

主色调跟着行业走

颜色能让用户一眼认出“这是给我们行业做的”。辅导员从事学生思想政治工作,所以示例用了红色思政元素。你也可以从下面选一个,或者直接对 AI 说:“请根据行业特点帮我定主色调。”

学生工作 · 智慧助手辅导员工作智能体
★
谈心记录
学生档案
政策问答
学业预警
评奖评优
材料撰写
今日待办
3 名学生待回访 · 1 份通知待发布
学习园地
本周主题教育学习材料已更新

图① 外观:首页(示意)

谈心记录智能整理
✎
刚和小王聊完,他最近缺课较多,说是熬夜打游戏,家里也有些矛盾……
已整理为谈心记录:
· 主要问题:作息紊乱、缺课
· 原因分析:游戏依赖、家庭沟通
· 跟进建议:两周后回访,联系任课老师
保存到学生档案
仅本人及学院学工负责人可见
继续补充…发送

图② 点进去:功能页(示意)

画布 ONE 提示词(模型选 gpt-image2.5,生成两张原型图)

    
原型图① 外观(首页)原型图② 点进去(功能页)
03
STEP 3 · 沟通

拿着原型去找用户,把想法“录”下来

带着第一步的开发方案和第二步的原型图,当面找辅导员沟通,并全程录音。

为什么一定要做这一步?用户在没看到东西的时候,往往说不出想法;看到东西,才会做选择、提意见。原型图就是让他“说出来”的工具。

1 · 展示

先讲 1 分钟“这是为谁、解决什么问题”,再逐张展示原型图,让对方想象自己在用。

2 · 录音

征得对方同意后,用千问 App 全程录音。沟通结束后用“录音纪要”自动生成文字稿和要点。

3 · 整理

把录音纪要、你的会议笔记和原方案一起交给 AI,生成文字版的修订方案。

现场可以这样问(勾选已问过的)

    整理纪要和修订方案的提示词
    
            

    注意:录音前必须征得对方同意;沟通时用虚构或脱敏的示例,不要出现真实学生的姓名、学号、成绩和心理状况等隐私信息。

    录音纪要 + 会议纪要文字版修订方案
    04
    STEP 4 · 开发

    先写 PRD,再把 PRD 和原型图一起交给 AI

    PRD(产品需求文档)是 AI 开发的“施工图”。先让 AI 根据修订方案生成 PRD,你检查确认后,再把 PRD 和第二步的两张原型图一起发给 Claude、Codex 等开发工具,让它据此开发整个平台。

    一份合格的 PRD 至少包含这 9 部分

    01背景与目标为谁、解决什么问题、成功标准
    02用户角色与权限辅导员、学院负责人、管理员分别能做什么
    03功能清单与优先级P0 必须有 / P1 应该有 / P2 以后再说
    04页面与交互每个页面的元素、操作流程,对应原型图
    05数据设计需要存哪些数据、字段、谁录入
    06AI 能力设计哪些功能调用大模型、提示词、知识库
    07管理员后台账号、API Key 配置、内容管理
    08非功能要求手机适配、隐私安全、响应速度
    09验收标准逐条列出“怎样算做完了”
    ① 生成 PRD
    
          
    ② 开发平台(附上 PRD 和两张原型图)
    
          

    两种大模型接入方式,在管理员后台二选一

    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 做成管理员后台的配置项,部署后由管理员在后台填写,页面上只显示打码后的值。

    PRD 文档可运行的智能体平台(含管理员后台)
    05
    STEP 5 · 部署

    先预览看效果,再正式上线

    根据用途选择不同的部署路径。

    只是预览、看效果

    WorkBuddy 一键上传

    1. 让 AI 把项目打包成部署包(zip),并写明启动方式;
    2. 在 WorkBuddy 中上传部署包;
    3. 获得预览网址,发给用户试用、收集反馈;
    4. 根据反馈回到第三、四步迭代。

    适合:课堂展示、比赛演示、给用户看效果。不要在预览环境里录入真实的学生数据。

    要真正投入使用

    申请学校云主机

    1. 由使用方(辅导员所在学院)向学校网信处提出申请;
    2. 说明系统用途、访问范围、涉及的数据类型;
    3. 网信处开通云主机后,按部署包说明安装上线;
    4. 在管理员后台配置 API Key,完成验收后正式使用。

    适合:长期使用、涉及真实数据的场景。系统由学校统一管理,数据安全更有保障。

    生成部署包的提示词
    
        
    预览网址正式上线的系统
    ONE PAGE · 一页带走

    五步速记

    1 需求说清为谁、什么场景、解决什么问题;让 AI 苏格拉底式追问,信息够了再出方案。
    2 前端 UI画布 ONE 用 gpt-image2.5 推理界面;至少“外观 + 点进去”两张;主色调跟行业。
    3 沟通拿方案和原型找用户;征得同意后录音;整理纪要,形成修订方案。
    4 开发先生成 PRD;PRD + 两张原型图交给 AI 开发;后台可配置 DeepSeek / TokenOne。
    5 部署预览用 WorkBuddy 上传部署包;正式使用由使用方向网信处申请云主机。
    教程全文(可复制发给同学)