我用AI做了一套“自动学情分析系统”（二）——数据的收集、传输和存储

上一篇介绍了搭建个性化学情分析系统的整体思路、踩过的坑和取得的结果。今天这一篇主要拆解第一步：如何收集数据并将数据传入飞书多维表格。这步一开始我设想得比较简单，就是学生通过网页做完题后，把网页链接发给学生，学生点击提交后，既能看到自己的错题，也能把这些错题信息传入飞书多维表格。实际上我也是这么做的，但是做的过程当中发现遇到的问题还是挺多的。上面说的是数据传递的思路，但是实际设计的时候却需要倒着设计。具体原因下面会提到。实际上，这一步可以分为四小步：

1. 确定需要传输的数据
2. 飞书多维表格设计
3. 配置数据传输的接口
4. 闯关题目网页设计

这四步里面最核心的就是确定传输的数据，因为网页端传出的数据要和飞书多维表格的匹配才能存进去，所以数据设置必须是相同的，而且网页要拿到飞书多维表格的钥匙，才能打开表格把数据填进去，所以这四步之间的关系需要考虑清楚，且确定收集什么样的数据和类型必须要放在第一步。接下来，我会简单拆分一下这四小步的具体做法。第一步，确定收集数据我们做的系统是要分析学生的学习情况，所以我觉得至少要拿到他的班级、姓名、分数，还有错题这4个信息。所以我确定要收集的数据有四个：学生姓名、班级、分数和错题详情。因此，只要在网页端和飞书多维表格里有这四个数据就可以了。第二步，设计飞书多维表格飞书多维表格可以在飞书里面打开，也可以在它的网页端打开。这里建议用网页端。
网址： https://mqhunwolc43.feishu.cn/base前面已经确定了需要的数据信息，所以我们就只需要设置这几个字段就可以了。姓名、班级、分数和错题详情。

这里要知道每一个的字段类型，我这里面的姓名、班级和错题详情都是字符串，分数是整数。因为设计网页的时候需要进行对应的设计。我这里字段写成英文，是为了更好的进行数据传输。第三步，配置数据传输接口我最终实现的方法是调用飞书的机器人。（这里我要先和大家道个歉，因为之前的文章里写的都是调用飞书多维表格的 API，其实调用的不是 API，而是飞书自建应用的 ID 和 Secret。用扣子做实践的时候调用的是 API。搞混了，请原谅我这个小白😂。）其实我本来也不知道怎么做，这一步全都是我问 AI，然后一点一点摸索着做出来的。所以这个方法应该也适合大部分的人。（插个题外话）借助 AI 探索和学习的能力，我觉得是现阶段使用 AI 的必备技能，应该属于通用能力，如果你自己也搞不定，就可以把你的问题发给 AI，让它协助你完成这一步。实践过程中我用了三个 AI 工具参考他们的回答，第一个是谷歌的 Gemini，第二个是知乎的知乎直答，第三个是腾讯的 ima 知识库，这里要夸一夸腾讯的 ima 识库，上下文长度可以，而且收集的信息也挺精准。另外我建议也用飞书开放平台，毕竟是官方的，知识库更全面，这也还是我后面实践时候才知道的。（回归正题）为什么要配置接口？这里需要说明一下，网页无法直接把数据写入到飞书多维表格中，因为不是一个东西，他们之间没有打通，要想写入数据，就需要一个中间连接口连通它们两个，这个连接口就是飞书机器人。飞书机器人会把网页端的数据接收过来，然后再填入到多维表格中。但是飞书中本身是没有合适的机器人的，所以这一步需要我们自己创建一个机器人。创建步骤如下：

1. 打开飞书开放平台官网，点击右上角的开发者后台。

网址：https://open.feishu.cn/?lang=zh-CN

2. 点击“创建自建应用”，选择“创建企业自建应用”。
   如果你是飞书新用户，没有企业，也没有加入企业，可以随便建一个，不需要任何其他信息，只要一个名字就可以了。我这里的名字也是随便起的。

3. 应用创建后，需要填写应用名称，名称可以根据用途随意填写。

4. 应用创建后，需要添加应用的能力，否则只是一个空壳。这里我们选择“机器人”。

5. 有了机器人之后，需要给它权限，所以要点击左侧的“权限管理”。在右侧点击开通权限，找到“多维表格”，将所有权限全部开通，点击确认即可。

6. 都做好之后 我们需要把机器人上线才能用。点击左侧的版本管理与发布，点击右上角的创建版本，填写版本号和版本说明就可以了。其他的都不用动。

机器人发布后，我们需要将获取的权限配置给到网页，让网页能够给机器人传数据。第四步，制作网页这一步不难，会和 AI 聊天就可以了。先把教材上传到 Gemini（无法使用 Gemini，就用 DS、豆包、千问等国内 AI，只要能识别图片中文字就行）。提示词也比较简单，需求说明白就行。为了方便讲解，我以我的实际操作为例：我要出的是科学第四单元“不一样的物体”这个单元的测试题，所以我就把教材传给 Gemini，然后让它帮我出第四单元的15道互动形式的闯关练习题。交互过程成比较长，限于篇幅原因，具体的步骤可以移步小报童看我与 Gemini 的聊天记录。我的初始提示词：根据三年级上科学课本的第四单元（不一样的物体），设计一个单元的题目抽测游戏闯关网页，用来检测学生对科学知识的掌握程度，题目需要覆盖每一个关键知识点，且数量不少于15道。题目要结合学生的生活情景，以知识的迁移应用和延伸为主，不要只停留在知识记忆的维度，要遵循布鲁姆教育金字塔模型，覆盖每一个层级。如果需要画图，则调用 Canvas 功能进行设计。请一步一步分析如何实现题目和网页的设计，并设计出完整的网页。因为我之前用 AI 制作过不少网页，也清楚知道我的需求，所以这一步的操作对我来讲并没有那么难，很顺利地就实现了。网页设计的思路我还是保持一贯的做法：先实现核心功能，再实现附加功能。所以我先设计的是题目，网页的题目设计完之后再进行扩充，比如我的要求是要在开始做题之前先选择班级、填写自己的姓名；做完题之后能够显示所有的错题和解析报告。其实也可以同时告诉它，我们需要通过飞书机器人将网页的数据填入到飞书多维表格中。这样AI就会把修改后的网页代码做好，并告诉我们哪里需要填入什么样的数据和信息。要从网页端把数据填入到飞书，需要用到4个数据：

1. 飞书自建应用的 App ID
2. 飞书自建应用的 App Secret
   这两个数据来自刚才在飞书开放平台中创建机器人的地方，点击左侧最上方的“凭证与基础信息”，就能看到这两个信息。
3. 多维表格的 App Token
4. 多维表格的 Table ID
   获取 App Token 和 Table ID 需要你用浏览器打开你创建的那个多维表格，然后在浏览器的地址栏（网址）中查看。地址中“base/”后面“？”前面的一串字母加数字就是 App Token，“table=”后面的一串字母加数字就是 Table ID。

注意：获取到的这四个数据是需要我们手动填入到网页代码中相对应的位置的。（需要我们写数据的地方，在网页设计的时候一般 AI 会放一块。如果没有单独放，那最好在设计网页时要求让他把这些信息放在一块填写。）这里我展示AI留出的填写信息的位置图片。

填好信息之后，接下来测试网页就可以了，遇到报错就把错误信息发给 AI，让他帮你判断是哪里的问题。没有报错，显示数据传输成功，那就到多维表格里面看看数据有没有填入，如果有数据，那就说明正确了，数据传输这一步就完成了。恭喜你，如果做到这一步那数据传输的核心问题就已经解决了。但是，还没完现在数据已经可以传输了，但这一步还没有完全完成。为什么呢？如果你直接把网页发到群里给学生，他们下载后，大概率要么打不开，要么虽然能打开并完成填写，但点击提交时，数据会被浏览器拦截。因为电脑的浏览器会默认这是危险操作，不让数据传出去，所以多维表格很可能无法接收到数据。（当然，这一步我没有实际测试过，是AI说的），但为了保险起见，我们需要用另一种方式：把网页托管成线上网页，给学生发链接，填写数据后直接提交。如何将网页托管成线上网页？这里我推荐一个最简单的方法，就是用 Netlify。 网址：https://app.netlify.com/具体步骤如下：

1. 把网页的名字改成 index.html，然后放到一个文件夹里。

2. 把文件夹拖到 Netlify 上就可以了，它会自动创建一个项目，自动部署好。

3. 我们只需要拿到页面中的网址，发给学生就可以了。

部署完我测试了一下，网速不是特别快，但可以正常使用。建议用电脑端直接打开网页。如果用手机端，最好用本地浏览器。我试了 UC 浏览器，它会自动跳到支付宝界面，不知道为什么，遇到这种情况返回一下就可以正常进入了。至此，我们的初步闭环基本上已经完成。数据传输已经跑通。潜在问题：信息泄露风险但是，这时候还有一个我之前提到的问题：会有泄露信息的风险。因为我们是直接把飞书多维表格的ID和机器人的ID、Secret这些直接放到网页上的，稍微懂点代码的人能够轻松拿到这些钥匙，可以在你的飞书多维表格里面操作数据（还能干什么可怕的事情我也不知道了）。不过考虑到我们的用户都是学生，为了方便使用，这个暂时可以忽略。如何避免信息泄露？那，不想忽略怎么办呢？为了保险起见，应该把这些关键信息放到一个中转站里边，然后让网页去调用它，这样网页端就不会显示了。我用的是vercel，具体的实现方法这里就不讲了，这已经是另外一个话题了，老师们可以自行尝试。我虽然尝试成功了，但在国内是不可用的，就放到小报童了。国内的我还没有找到很好的替代品，如果有知道的老师，可以给我推荐一下，非常感谢。好，到这里，数据传输的步骤、配置步骤和注意事项基本上都讲清楚了。有兴趣的朋友可以跟着操作一遍。如果遇到问题可以加群一块交流学习。

专栏原定价49元，现在给最早支持我的粉丝朋友们一个“早鸟价”，限时优惠只要10块钱，就当交个朋友（计划元旦涨至19.9）。现在已有一百多位老师订阅。如果你觉得这些内容对你有帮助，也欢迎你来看看。扫描下图中的二维码即可享受早鸟价，购买成功后记得添加我为好友哦，送你两大福利：价值199的DeepSeek教师资源和我实践总结的课程开发全流程提示词。