代码生成与菜单

这一节说明如何让 Agent 根据数据集、SQL 或页面需求生成前端调用代码，并把页面入口、菜单和线上资源对齐。你不需要手动拼生成或同步命令；把要接入的业务能力、目标文件和验收方式说清楚即可。

适合交给 Agent 的任务

• 根据数据集操作生成 TypeScript 调用片段。
• 根据已保存 SQL 生成前端或 BFF 内部调用片段。
• 把生成的调用代码放进指定文件或页面。
• 检查本地页面是否已经出现在平台菜单中。
• 更新线上菜单引用的 JS / CSS 资源地址。

准备工作

• 已经知道要调用的数据集操作、SQL 名称或页面功能。
• 明确代码要放到哪个目录、文件或组件里。
• 如果涉及线上菜单或资源更新，要求 Agent 先预览影响范围。

常用 Prompt

生成数据集调用片段

请根据「客户」数据集的「列表查询」生成 TypeScript 调用片段。
调用场景是：客户列表页按客户等级、负责人和最近跟进时间筛选客户。
请先确认入参和返回字段，再把代码放到「src/pages/customer/CustomerList.tsx」。
不要改无关业务逻辑，完成后告诉我如何验证。

AI 可能调用：rabetbase api pull、rabetbase dataset operations、rabetbase codegen sdk。

生成 SQL 调用片段

请根据已保存的「客户活跃度统计」生成调用代码。
目标调用方是「前端页面 / BFF 脚本」。
请说明需要传哪些参数、返回哪些字段，并把代码放到「src/pages/customer/CustomerDashboard.tsx」。

AI 可能调用：rabetbase sql detail、rabetbase codegen sql。

接入到页面中

请把「客户活跃度统计 SQL」的调用接入到「客户列表页顶部统计区」里。
页面需要展示高价值客户数、沉默客户数、待跟进客户数，筛选条件包括负责人、客户等级和统计时间范围。
请保持现有交互不变，只补齐数据获取和错误处理。

AI 可能调用：rabetbase dataset operations、rabetbase sql detail、rabetbase codegen sdk、rabetbase codegen sql。

同步页面菜单

我新增了页面「客户列表页 /crm/customers」。
请检查它是否已经出现在平台菜单中。
如果没有，请先预览将新增或调整的菜单项，确认无误后再同步。

AI 可能调用：rabetbase menu sync。

更新线上资源引用

本次客户列表页构建产物地址是：
JS：https://cdn.example.com/crm/customers/index.js
CSS：https://cdn.example.com/crm/customers/index.css
请帮我更新平台菜单引用的线上资源，并只影响「客户列表页」菜单项。
执行前先预览会影响哪些菜单，执行后告诉我更新结果和验证入口。

AI 可能调用：rabetbase menu update。

写 Prompt 时要补充的信息

• 调用来源：数据集操作、已保存 SQL，或已有 BFF。
• 目标位置：文件路径、组件名、页面路由或菜单名称。
• 交互要求：筛选、分页、空态、错误提示、加载状态。
• 发布约束：先预览菜单变化、只更新资源、不覆盖业务扩展配置。

完成检查

• 生成的代码已放到指定位置，并能被项目引用。
• 入参、返回字段和错误处理已经说明清楚。
• 菜单同步或资源更新前已经预览影响范围。
• 页面可以打开，数据能正常展示或有明确的下一步验证方式。

下一步：如果调用所需的数据结构还不清楚，回到「API 与数据集：拉配置、看清数据」；如果查询还没有沉淀成平台 SQL，先看「自定义 SQL：从写到执行」。