SuperAPI AI 工具集

reward

智能体与模型

查看项目

更新于 10-16 04:07

技能介绍

用途

Reward 是一个奖励协议技能,用于在游戏或互动叙事中,根据角色所完成的成就动态生成并发放奖励。其核心原则是“奖励应当让人感到实至名归且恰如其分”,即奖励需与成就主题相匹配:屠龙获得龙主题奖励(鳞片、宝藏、声望),拯救村庄获得村庄的感激(庇护、盟友、头衔),解谜获得知识奖励(秘密、技巧、传说)。

主要能力

奖励类型包括:物品(武器、工具、宝物,用于战斗、探索)、金币(货币、贵重品,用于商业、任务)、增益(临时能力,用于英雄时刻)、头衔(如 LIGHT-BEARER、DRAGON-SLAYER,用于重大成就)、能力(新技能、技巧,用于学习、训练)、权限(钥匙、许可、信任,用于社交成就)、知识(秘密、传说、地图,用于调查)、传家宝(带有历史的物品,用于世代游玩)。

提供两种方法:

  • GRANT:发放奖励。参数为 recipient(获得者)、achievement(所做之事)、reward(所获之物,可自动生成)。效果为加入获得者物品栏或状态、记录到成就日志、叙述发放过程。
  • GENERATE:创建主题奖励。参数为 achievement(完成之事)、context(地点与方式)。效果为分析成就主题、生成合适奖励、附理由提出建议。

奖励生成逻辑示例:成就“从火中救出铁匠”,上下文为村庄火灾、英雄行为。主题分析:火→火相关物品?铁匠→锻造奖励?英雄→声望提升?生成奖励:防火斗篷(实用、主题契合)、终身免费修理(关系)、头衔 FLAME-WALKER(声望)、秘密:稀有矿石位置(知识)。

奖励缩放:小任务给小额代币、少量金币;重要任务给有用物品、头衔;重大成就给强力物品、能力;传奇壮举给独特神器、持久名声。

诅咒解除奖励:当诅咒被解除时,可应用特殊奖励,例如诅咒“黑暗诅咒”,解除条件“点亮 3 个黑暗之地”,解除奖励包括头衔 LIGHT-BEARER、能力“在黑暗中发光”、知识“暗影神殿的位置”。

延迟奖励:部分奖励随时间成熟,例如“种下的种子”在 3 个游戏日后变为“魔法果树”;关系奖励如“商人的好感”随重复交易增长,最终成为“独家供应商”。

状态结构包含 earned_rewards、pending_rewards、titles 以及 achievements_log(含日期、成就、奖励)。

使用方式

通过 invoke 调用 GRANT 或 GENERATE,并传入相应参数。GRANT 会直接发放奖励并记录;GENERATE 会分析成就与上下文,生成主题契合的奖励建议供选择。

适用场景

适用于角色扮演游戏、互动叙事、任务系统等需要根据成就动态发放奖励的场景。可与 scoring(分数决定奖励质量)、buff(部分奖励为增益)、economy(金币奖励)、character(奖励更新角色状态)、adventure(任务完成触发奖励)等技能集成。

限制

安全准则要求:比例适当(奖励与难度匹配)、保持一致(相似成就给相似奖励)、有意义(奖励应对故事重要)、无通胀(保持奖励价值)。具体实现细节、平台支持与收费情况暂未提供。