开发说明 · 智能体

智能体功能规格:VIB 核心业务与通用对话

VIB 是智能体模块的核心业务,完整交付包括网站选择、账号绑定、分析、大厅、机器人信号和游戏结果。 通用模型聊天室提供补充对话能力。VIB 详细状态与游戏规则见 VIB 开发说明; 本页后续的型号选择、通用消息与模型 SDK 规则仅适用于通用聊天室。

1.0.0 · 初始草稿 草稿 · 未上线 核心 · VIB 完整业务流程
01 / 智能体

核心业务:VIB 的完整交付范围

业务环节 必须成立的规则 完成结果
产品入口与任务 「问我任何问题」与目录 VIB 均进入同一 VIB 页面,产品登录后回到目标;普通消息由模型回复,快捷按钮或完整匹配其多语言文案的消息触发对应游戏剧本。 用户进入明确的 VIB 业务任务,不能以通用聊天可用代替 VIB 流程完成。
网站与大厅绑定 未绑定点击「绑定 AI」直接进入对应大厅;大厅账号登录确认后更新绑定。 取消或直接返回不误绑定;账号绑定与机器人就绪分别展示。
分析与游戏入口 实时分析直达大厅;今日信号与账号分析按各自任务展示。绑定后留在大厅继续机器人流程;返回只恢复对话,不隐式发起分析。 今日信号候选直达大厅;账号分析涵盖等级、行为样本和信号关系,详情待确认。不加连接管理或聊天内信号详情弹框。
机器人信号 由大厅中的机器人展示分析、候选与配置,用户确认后激活;同一机会只对应一个游戏。 大厅使用信号先选择候选;游戏内使用信号直接显示当前游戏配置,就地激活,不重载游戏。单纯查看不消费机会。
游戏结果与返回 按有效操作确认完成并只结算一次;大厅返回停止游戏及机器人运行。 用户可以看到本次结果并继续或返回;取消、失败、重载不会重复激活或结算。
两类服务分别交付

VIB 原型已接入游戏机器人剧本;今日信号候选为展示数据,账号报告只展示等级、行为样本和信号关系的待接入范围。通用聊天室仍以固定文案展示回复,正式模型 SDK 后续接入。正式授权、分析数据、计费与信号资格待确认。

页面职责、状态转换、数据含义与验收结果详见 VIB 核心业务开发说明。

02 / 智能体

范围与关键规则

编号 规则 确定程度
A01 · VIB VIB 为核心自有业务,全目录只保留一个入口,不设版本;覆盖网站绑定、分析、大厅与机器人信号,详见 VIB 功能规格 ;不加入通用聊天室型号列表。 已确定
A02 · 聊天范围 其余 10 个品牌支持文字输入、发送、流式展示与顶部模型选择。原型每次发送返回固定的较长文案,开头含发送时的完整模型名称。 已确定
A03 · 真实服务 正式开发通过第三方 SDK 接入模型服务。具体服务商、SDK、模型标识与版本、鉴权和部署方式待确认;不把本地定时输出当作正式接入方案。 接入方向已确定;具体选型待确认
A04 · 权限 目录公开浏览;进入 VIB 或聊天室前检查登录,登录或注册后回到目标。聊天示例不代表模型实际可用或有付费权限。 登录策略为本次建议
A05 · 消息与切换 本次建议在同一段对话中保留已有消息,切换影响下一次发送;每条回复固定记录其发送时的型号。确认切换时终止未完成回复。 本次建议;正式上下文策略待确认
A06 · 型号 目录只显示品牌名;聊天室顶部、型号卡片及回复署名显示具体型号。58 个型号为展示样例,不承诺上线、免费或专业版权限。 展示范围;正式名单待确认
03 / 智能体

页面与展示要求

页面 / 编号 展示内容 操作结果
AGENT-01 · 目录 标题、动态标识、提问入口、四列 11 项目录、可展开面板和五栏导航。 列表内部滚动;「问我任何问题」与 VIB 目录项直达同一 VIB 页面,未登录时先登录并恢复目标,不先打开模型选择器。
AGENT-02 · VIB VIB 对话、游戏分析、网站绑定、大厅跳转、机器人内信号流程、切换与返回。 普通消息由模型回复并支持停止;三类快捷按钮与完整匹配快捷文案的消息共用对应游戏剧本流程。按稳定操作标识适配多语言,详见 VIB 消息分流与多语言规则;绑定与游戏入口直接进入大厅。
AGENT-03 · 聊天室 顶部返回、当前型号和箭头、演示标记;空态欢迎语与三条示例;消息区;五项横向快捷操作;输入、发送或停止按钮。 隐藏五栏导航。顶部和输入区固定,仅消息区滚动;用户消息在右,模型回复在左并标注真实所属型号。
AGENT-04 · 模型选择 横向品牌条、两列型号卡片、选中状态、取消和固定底部确认按钮。 点击品牌仅切换展示范围,点击卡片仅改变待确认项;确认后生效。重复确认当前型号不清空草稿、不停止回复。
AGENT-05 · 导航 目录显示五栏导航,各模块切换时导航高度和安全区保持一致,目录面板不覆盖导航。VIB 与其他聊天室使用顶部返回。 返回目录恢复面板展开状态、内部列表位置和所选入口焦点。
04 / 智能体

通用聊天流程与产品账号

触发 处理 结果
选择聊天入口 校验品牌标识与登录;使用该品牌的默认展示型号,当前页面已选择同品牌型号时继续使用该型号。 登录与注册在底部弹层内切换,不丢失目标;取消后留在目录并恢复入口焦点。
快捷提问 把对应文字填入输入区并聚焦,允许编辑。 不自动发送,不消耗任何实际额度。
发送 去掉首尾空白;非空且不超过 2000 字符;确认当前登录有效。一次只运行一条回复。Enter 发送,Shift + Enter 换行,输入法组合中不触发发送。 立即显示用户消息,创建对应模型的回复位置,开始逐步显示。发送后清空输入;可先写下一条草稿。
流式更新 每次内容只追加到对应请求的回复;处于底部时跟随新内容,向上阅读时停止自动跟随。 提供回到最新消息操作;完成时撤销停止控件,恢复发送。
停止 中止当前回复并忽略之后到达的片段,保留已收到内容。 标记已停止;不得误触发草稿发送,也不得把部分回复视作完成。
模型选择确认 取消不变更;确认其他型号后先停止进行中的回复,再更新顶部型号。已有消息和草稿保留。 新消息锁定新型号,已有回复不被重新署名;切换本身不生成消息。
离开聊天室 停止未完成回复,保留已显示内容。 当前页面运行期间可返回查看;刷新后消息和草稿清空、型号回到当前品牌默认项。此为演示生命周期,正式历史策略待确认。
退出或换账号 终止进行中的回复,清除当前演示对话与草稿。 另一账号不能读取前一账号消息;登录状态失效时重新要求登录。

账号衔接

受限入口在目录上打开底部手机号登录弹层,可切换注册;直接打开聊天室链接也先展示目录与登录弹层。保留 +55 区号选择,手机号输入框只提示并接收 11 位数字。不提供邮箱登录或注册。演示不接入真实账号服务,账号缓存实现见维护附录。

05 / 智能体

通用聊天与目录的状态异常

状态 用户看到什么 恢复与约束
空对话 欢迎语、示例提问、快捷操作与可编辑输入区。 无内容时不能发送;示例只填入。
正在回复 文字逐步出现,当前型号署名,停止按钮。 防止重复发送;滚动阅读不被抢回底部,草稿可编辑。
回复完成 完整文本,恢复发送按钮。 后续输入可正常发送,不保留虚假的忙碌状态。
主动停止 / 切换 / 离开 已显示的文本和对应停止原因。 后续片段不覆盖页面,不误附加到新型号或新消息。
输入为空 / 超长 空输入禁用发送;达到 2000 字符给出分条提示。 保留输入;不把用户文字作为标记或脚本执行。
真实服务超时 / 中断 明确失败原因与已收到的部分内容。 保留提问;重试使用该条消息的型号并防重复。超时阈值、自动重试次数和计费回滚待确认;原型不模拟 SDK 成功。
模型下线 / 无权限 说明不可用原因并允许重新选择。 不能自动换到另一模型,不用展示样例替代正式可用名单。
目录为空 / 加载失败 / 未知入口 暂无智能体、暂时无法加载或入口不可用。 提供重新加载或返回目录;不伪造成功。
关闭选择器 回到原页面,焦点回到触发按钮。 关闭按钮、遮罩、Esc 均可取消,弹层内焦点循环。
06 / 智能体

通用模型数据与第三方 SDK 边界

数据 / 边界 要求 待确认
品牌与模型标识 区分品牌目录标识、展示型号和服务侧模型标识;只能从有效配置中选择,不用名称直接拼接服务地址。 服务商型号映射、上下线和权限配置来源。
消息 包含消息标识、会话归属、角色、文本、发送时间和状态;模型回复必须记录发送时的型号及请求标识。 正式持久化、保存期限、删除与跨设备同步。
进行中的请求 关联对应消息与模型,区分发送、接收中、完成、停止、失败。仅当前有效请求可更新对应回复。 SDK 的流事件、结束原因、取消方式和断线恢复语义。
鉴权与凭证 由可信服务或受限的临时凭证承接 SDK 调用;不在公开客户端或原型中内置真实长期密钥。账号权限与模型访问权限分别校验。 鉴权职责、凭证有效期、服务端与客户端分工。
上下文 切换后保留展示记录不等于必须把全部历史发送给新服务;发送范围需要明确。 多模型上下文策略、长度限制、隐私与内容处理规则。
用量和计费 以服务确认结果为依据,区分请求成功、回复完成、取消与扣费;演示不计费、不扣点数。 费用、额度、取消与失败后的计费规则。
演示与真实服务 演示只展示固定文案的逐步输出,不访问模型 SDK。正式接入后必须用真实流内容和真实完成/失败结果驱动界面。 选定 SDK 后补齐接口契约与联合验证。
07 / 智能体

适配与体验要求

  • 移动端 H5 页面居中,桌面最大宽度 430px;方案文档独立适配电脑、平板和手机。
  • 目录四列,选择器型号双列;长型号可换行,顶部名称可省略但辅助名称和选择卡片显示完整文本。箭头与控件右侧保留空隙。
  • 聊天室内容和输入区不横向溢出。长消息与连续字符换行;多行输入限制高度后内部滚动,不挤掉整个消息区。
  • 适配安全区与键盘引起的可见高度变化,发送、停止、返回和模型确认始终可达。短屏可隐藏快捷操作以保留输入空间。
  • 流式回复跟随阅读位置;用户上滑时不自动跳回底部。停止、切换、离开后清理进行中的请求与监听。
  • 模型选择器支持触屏、鼠标和键盘;取消恢复焦点,选中状态不只靠颜色。分片输出不逐字打断辅助阅读工具,提供开始、完成或停止状态。
  • 减少动态效果偏好下取消闪烁与非必要动画。图标失效保留名称;文本不依赖图标才能辨认。
08 / 智能体

验收结果预期

场景 应达到的结果
入口范围 「问我任何问题」与唯一 VIB 目录项进入同一页面,登录前后目标一致;其余 10 个入口可到聊天室,通用型号选择器不含 VIB。
发送与流式展示 有效消息立即出现在右侧,较长回复逐步显示且包含发送时的完整型号名;不同提问可使用同一演示文案,真实接入不能用此文案冒充结果。
空白 / 换行 / 输入法 空白不发送,Shift + Enter 换行,输入法确认不误发,长内容可读。
停止与重复操作 停止保留部分文字;回复时不会重复发送,停止不会顺带提交草稿;完成或停止后可以继续发送。
切换与取消 品牌筛选与待选卡片不提前更改当前模型;确认更新名称,取消不变。已有消息署名和草稿保留,切换中断当前回复。
滚动与布局 320px 窄屏、常用手机和桌面均可操作;消息滚动不带动顶部与输入区,上滑阅读后可手动回到最新。
返回 / 刷新 / 退出 返回目录恢复浏览位置;刷新恢复登录与品牌入口、清空演示消息;退出或换账号不显示前一账号消息。
正式 SDK 联调 在实际提供方环境验证权限、流事件、停止、超时、中断与请求隔离;仅页面可操作不代表 SDK 已接入或真实服务已验收。

以上为功能预期,实际完成的检查记入维护附录。真实服务尚未接入。

09 / 智能体

待确认与交接

事项 需确定内容 影响
VIB 自有业务 正式游戏账号授权、信号资格、计费与剧本版本。 决定核心业务的正式授权、信号可用范围及结果确认;详见 VIB 功能规格。
第三方 SDK 具体服务商、版本、模型映射、鉴权、流协议与取消能力。 真实调用与异常反馈。
权限与付费 正式可用型号、游客体验、订阅、额度与扣费。 禁止据演示卡片推定免费或已订阅。
对话管理 保存期限、历史列表、删除、多设备、跨模型上下文。 当前演示内存生命周期不构成正式数据策略。
扩展输入 附件、语音、检索及内容处理规范。 本次不包含。
状态与上线 产品确认、服务联调与发布安排。 当前为 1.0.0 初始草稿,未上线。