AI 应用与大模型能力使用指南
大模型能力让你生成的应用本身能够调用 AI，例如根据用户输入生成个性化内容、进行智能问答、翻译或总结。
本指南的目标，是帮助你完成以下事情：
- 在创作应用时正确提出 AI 功能需求。
- 在开发前确认是否启用大模型能力。
- 区分应用内大模型调用与袋马生码模型的积分消耗。
- 查看调用次数和积分明细。
- 关闭或重新开启应用的大模型能力。
应用内大模型调用是应用交付后，用户使用智能问答、AI 分析等功能时发生的调用； 生码模型调用是你在袋马中创建或修改应用时发生的调用。两者会在项目用量中分别统计。
1. 如何使用大模型能力
第一步：在需求中说明 AI 要做什么
创建应用时，直接描述需要 AI 完成的任务。建议同时说清楚：
- 触发时机：用户进行什么操作后调用 AI。
- 输入内容：需要把哪些信息交给 AI。
- 输出结果：希望 AI 返回什么内容、以什么形式展示。
例如：
做一个 MBTI 性格测试应用。用户完成 28 道题后，调用大模型根据答题组合生成个性化人格分析，结果包含人格昵称、优势、盲点、适合职业和最配 CP。生成过程中展示“AI 正在解读你的人格”，失败时允许重新生成。
适合使用大模型能力的常见场景包括：
- 智能问答、AI 助手和客服。
- 个性化报告、测评结果或建议。
- 文案、摘要、行程、菜谱等内容生成。
- 翻译、润色、分类和信息提取。
如果页面只展示固定内容，或规则可以完全由普通程序实现，则不一定需要大模型。选择固定模板可以避免产生应用内大模型调用消耗。
第二步：等待袋马生成接入方案
袋马会先生成产品文档和原型，并识别需求中是否需要大模型。需要接入时，确认区会展示大模型能力选项、用途和消耗说明。
第三步：生成完成后验证
项目完成后，在右侧预览中走完一次真实流程。重点检查：
- AI 功能入口能够正常触发。
- 加载状态和失败提示清楚。
- 生成内容与用户输入相关，而不是始终显示同一份模板。
- 输出内容的长度、结构和展示效果符合需求。
用户提交答案后，应用调用大模型生成个性化人格分析。
生成完成后，结果页展示与本次答题组合对应的专属分析。
2. 如何确认是否使用大模型能力
在开发开始前，袋马会要求你确认产品需求范围；如果应用需要 AI，还会同时出现大模型能力确认项。
以个性化人格分析为例，确认区会提供两种选择：
- 启用 AI 解读：接入大模型，根据每次输入动态生成结果，并按实际调用量扣除积分。
- 使用固定模板：不接入大模型，应用按照预先写好的规则或模板展示结果。
确认步骤如下：
- 阅读右侧产品文档和原型，确认 AI 功能的输入、输出和页面流程。
- 在需求范围中选择 「确认需求范围，开始设计」；如果方案不符合预期，选择 「需要调整，我会补充意见」。
- 在大模型能力选项中选择启用 AI 的方案，或选择固定模板。
- 阅读积分消耗和余额不足提示。
- 点击 「确认并继续」。
启用后，应用每次实际调用大模型都会产生积分消耗。余额不足时，AI 服务会暂停，应用中的相关功能暂时无法继续生成结果；补充积分后可恢复服务。
确认需求时，可以选择启用 AI 解读或使用固定模板；启用前页面会说明积分消耗方式。
3. 如何查看消耗，大模型能力如何消耗积分
消耗发生在什么时候
应用内功能真正向大模型发起调用时，才会产生大模型 API 积分消耗。例如，用户提交一次问题、生成一份报告或重新生成一次结果，都可能产生新的调用。
以下操作本身不会产生应用内大模型调用消耗：
- 只打开应用或浏览普通页面。
- 查看之前已经保存的结果，且应用没有再次请求大模型。
- 大模型服务已经关闭，调用被拦截。
单次扣除多少积分，以当次项目积分流水显示为准。不同能力、模型或计费规则下，单次消耗可能不同，不建议只用调用次数推算积分总额。
查看累计扣费调用次数
进入目标项目后：
- 点击工作区顶部的 「管理」。
- 打开 「增值服务」。
- 在 「大模型调用」 卡片中查看运行状态和 「累计扣费调用次数」。
这里统计的是已经发生实际积分扣减的调用次数，不是累计扣除的积分总额。待扣、处理中、最终失败、无需扣费或实际扣减为 0 的记录不会计入。
查看积分趋势和每条明细
进入 「管理 → 项目用量」 后，可以看到：
- 积分消耗趋势：按天展示所选时间范围内的积分消耗。
- 分类图例：分别展示“增值-大模型 API”“生码模型调用”和“增值-云服务”。
- 区间总消耗：当前日期范围内所有分类的积分合计。
- 积分流水：展示每次扣费的时间、类型、说明和积分数。
上方趋势图受日期筛选影响；下方积分流水展示该项目全部时间的记录，不受趋势日期筛选影响。需要核对大模型应用的实际扣费时，请在流水中查找说明为 「增值服务-大模型调用」 的记录。
项目用量会分别展示大模型 API、生码模型与云服务消耗，积分流水中可核对每次大模型调用扣费。
4. 如何开启、关闭或重新开启
首次开启
首次接入大模型能力，需要在项目创作对话中提出 AI 功能需求，并在需求确认阶段选择启用。管理页只负责管理已经开通的服务，不能为一个从未接入过大模型的项目直接开通能力。
如果项目生成时没有启用，可以继续在创作对话中说明需求，例如：
为结果页接入 AI 个性化解读。用户提交问卷后，调用大模型生成分析；请先向我说明接入方案和积分消耗方式，确认后再继续开发。
关闭大模型能力
在“管理 → 增值服务”中可以查看大模型调用状态，并通过“关闭服务”入口停用能力。
- 进入目标项目，点击 「管理」。
- 打开 「增值服务」。
- 在 「大模型调用」 卡片中点击 「关闭服务」。
- 阅读影响说明，在确认弹窗中点击 「确认关闭」。
关闭后，应用内依赖大模型的功能将无法继续调用模型。已经产生的积分消耗不会退回；因为不再发生新的模型调用，也不会再产生后续的大模型调用扣费。
重新开启大模型能力
- 回到 「管理 → 增值服务」。
- 在已关闭的 「大模型调用」 卡片中点击 「重新开启」。
- 在确认弹窗中点击 「确认开启」。
重新开启后，应用可以继续调用大模型，并按实际用量扣除积分。
关闭前，页面会再次说明功能影响和历史积分消耗规则。
重新开启后，应用可继续调用模型，并恢复按实际用量扣除积分。
常见问题
为什么应用能打开，但 AI 功能不能用？
先到 「管理 → 增值服务」 查看大模型调用状态。服务可能被手动关闭，也可能因积分余额不足而暂停。再到 「项目用量」 查看最近是否有调用和扣费记录。
关闭服务会删除已经生成的内容吗？
关闭操作会阻止后续模型调用，不会退回历史消耗。已经保存在应用中的内容是否继续显示，取决于应用自身是否保存了结果；建议关闭前在预览中验证关键页面。
为什么累计调用次数和消耗积分对不上？
累计调用次数是发生实际扣费的调用笔数，不是积分金额。请以 「项目用量 → 积分流水」 中每条记录的积分数为准。
如何避免不必要的积分消耗？
- 让用户明确点击生成或提交后再调用，不要在页面打开时自动重复调用。
- 对已经生成且可以复用的结果进行保存，避免每次查看都重新生成。
- 为“重新生成”设置清楚的按钮和提示，避免误触。
- 暂时不需要 AI 功能时，在管理页关闭大模型调用。