API 与数据集：拉配置、看清数据
这一节说明如何在 Vibe Coding 中让 Agent 对齐本地 API 配置、查清平台数据集、确认字段和操作。不要手动拼命令；把你要做的业务任务说清楚，让 Agent 自己检查、同步和解释结果。
适合交给 Agent 的任务
- 让当前项目的数据接口配置与平台保持一致。
- 查找某个业务对象对应的数据集。
- 确认数据集字段、主键、查询操作和入参。
- 梳理多个数据集之间的表关系，为写 SQL、BFF 或页面做准备。
- 受控修改少量字段展示信息或数据集元数据。
准备工作
- 已经在 Vibe Coding 工具中打开目标项目。
- 项目已完成 rabetbase 安装和登录。
- 知道本次要处理的业务对象，例如订单、客户、合同、工单。
常用 Prompt
同步本地 API 配置
text
请帮我检查当前项目的数据接口配置是否和平台一致。
如果不一致，请同步本地 API 代码。
完成后告诉我：新增、删除或变化的模型有哪些，前端代码可能需要关注哪些字段。AI 可能调用：rabetbase api pull、rabetbase api list。
查找业务对象对应的数据集
text
请帮我找一下和「客户」相关的数据集。
请说明每个数据集的用途、关键字段、主键、常用查询操作。
如果有多个候选，请推荐最适合用于「客户列表页」的那个，并说明理由。AI 可能调用：rabetbase dataset list、rabetbase dataset detail。
确认某个数据集怎么调用
text
请帮我查看「客户」数据集的数据结构。
重点确认客户列表页的关键词搜索、客户等级筛选、负责人筛选、分页查询和客户详情查询分别需要哪些参数。
返回字段请重点说明客户名称、联系人、手机号、客户等级、跟进状态、负责人、最近跟进时间。
请按前端开发可直接理解的方式说明，不要只贴原始字段。AI 可能调用：rabetbase dataset detail、rabetbase dataset operations、rabetbase api pull。
梳理表关系
text
我要基于「客户列表页」做客户、联系人、跟进记录的组合展示。
请先梳理客户、联系人、跟进记录之间的关系，包括主表、关联表、关联字段和容易用错的字段。
最后给出适合后续写 SQL 或 BFF 的数据准备说明。AI 可能调用：rabetbase dataset links、rabetbase dataset detail。
受控修改字段展示
text
请把「客户」数据集里的「客户级别」字段展示成「客户等级」。
执行前先预览影响范围，确认只修改这个字段的展示信息。
执行后请告诉我修改前后对比，以及是否还需要同步页面或调用代码。AI 可能调用：rabetbase dataset detail、rabetbase dataset field-update、rabetbase api pull。
写 Prompt 时要补充的信息
- 业务对象：例如客户、订单、合同、工单。
- 目标功能：例如列表页、详情页、查询接口、报表。
- 字段含义：哪些字段必须展示，哪些字段不能误用。
- 变更约束：只读检查、先预览、不要覆盖已有文件等。
完成检查
- Agent 能说清楚它使用了哪个数据集，以及为什么选它。
- 字段、操作和关联关系已经用业务语言解释清楚。
- 本地 API 配置已同步，前端可继续引用生成的模型或客户端。
- 如果有写入变更，已经先预览影响，再执行。
下一步：如果要把查询沉淀成平台资源，继续看「自定义 SQL：从写到执行」；如果要封装服务端逻辑，继续看「BFF 脚本：本地与远端同步」。