# 一份最小智能体设计

项目	要回答的问题
身份与规则	智能体是谁，永远不能做什么
状态提示	每回合读取哪些已整理状态
输入模式	选项、自由输入或两者并用
输出结构	玩家文本、候选项、允许的状态变化
长度限制	玩家输入和输出最大规模
写回目标	最新输出、摘要或结构化结果保存到哪里
生命周期	输入前、输出后、后悔、重置如何处理

不要把全部原始属性、对象和表格塞进状态提示。先用组合属性和动态字符串整理成稳定摘要。

# 提示词职责

区域	责任
系统提示词	身份、世界规则、输出协议和禁止项
状态提示词	当前回合的权威状态快照
开场白/开场选项	第一次进入的确定内容
选项提示词	候选项数量、格式和约束
输入检查	拒绝越界或无法处理的玩家输入
属性/对象转化	允许的变化范围，不执行任意脚本

# 输入模式

• 选项：可控性最高，适合关键剧情和移动端。
• 自由：表达力高，需要长度、内容和隐私限制。
• 自由 + 选项：同时提供建议路径和开放输入，成本与测试面更大。

# 状态写回

“最新输出保存到字符串目标”适合保存最近一条玩家可见结果。目标必须允许修改。结构化变化应经运行时验证后写入属性/对象，不要在输出后脚本里用正则猜自然语言。

# 后悔与重置

会话回退不会自动撤销会话外副作用。输入前扣费、创建对象、成就和表格日志都要在后悔脚本中补偿。重置要明确保留哪些长期状态，并保证重复点击不会重复返还或奖励。

# 放入纯 AI 页面

智能体仍是运行时系统；渲染布局可以提供自定义对话面板，但输入、选项和状态变化必须绑定到稳定控件或 tools API。不要在页面 JavaScript 中直接请求模型。

# 验收矩阵

测试至少包括：

• 首次进入、自由输入和选项输入；
• 过长/非法输入；
• 正常输出、空输出、结构错误和网络失败；
• 连续快速发送；
• 后悔一回合、连续后悔、重置两次；
• 刷新与云存档恢复；
• 匿名、积分不足和离线状态。

继续阅读：AI 智能体脚本与调用 API 和 积分与钻石系统。