开发说明 · 智能体
智能体功能规格:VIB 核心业务与通用对话
VIB 是智能体模块的核心业务,完整交付包括网站选择、账号绑定、分析、大厅、机器人信号和游戏结果。
通用模型聊天室提供补充对话能力。VIB 详细状态与游戏规则见 VIB 开发说明;
本页后续的型号选择、通用消息与模型 SDK 规则仅适用于通用聊天室。
1.0.0 · 初始草稿
草稿 · 未上线
核心 · VIB 完整业务流程
01 / 智能体
核心业务:VIB 的完整交付范围
| 业务环节 |
必须成立的规则 |
完成结果 |
|
产品入口与任务
|
「问我任何问题」与目录 VIB 均进入同一 VIB 页面,产品登录后回到目标;普通消息由模型回复,快捷按钮或完整匹配其多语言文案的消息触发对应游戏剧本。
|
用户进入明确的 VIB 业务任务,不能以通用聊天可用代替 VIB 流程完成。
|
|
网站与大厅绑定
|
未绑定点击「绑定 AI」直接进入对应大厅;大厅账号登录确认后更新绑定。
|
取消或直接返回不误绑定;账号绑定与机器人就绪分别展示。
|
|
分析与游戏入口
|
实时分析直达大厅;今日信号与账号分析按各自任务展示。绑定后留在大厅继续机器人流程;返回只恢复对话,不隐式发起分析。
|
今日信号候选直达大厅;账号分析涵盖等级、行为样本和信号关系,详情待确认。不加连接管理或聊天内信号详情弹框。
|
|
机器人信号
|
由大厅中的机器人展示分析、候选与配置,用户确认后激活;同一机会只对应一个游戏。
|
大厅使用信号先选择候选;游戏内使用信号直接显示当前游戏配置,就地激活,不重载游戏。单纯查看不消费机会。
|
|
游戏结果与返回
|
按有效操作确认完成并只结算一次;大厅返回停止游戏及机器人运行。
|
用户可以看到本次结果并继续或返回;取消、失败、重载不会重复激活或结算。
|
两类服务分别交付
VIB 原型已接入游戏机器人剧本;今日信号候选为展示数据,账号报告只展示等级、行为样本和信号关系的待接入范围。通用聊天室仍以固定文案展示回复,正式模型 SDK 后续接入。正式授权、分析数据、计费与信号资格待确认。
页面职责、状态转换、数据含义与验收结果详见 VIB 核心业务开发说明。
| 编号 |
规则 |
确定程度 |
| A01 · VIB |
VIB 为核心自有业务,全目录只保留一个入口,不设版本;覆盖网站绑定、分析、大厅与机器人信号,详见
VIB 功能规格
;不加入通用聊天室型号列表。
|
已确定 |
| A02 · 聊天范围 |
其余 10
个品牌支持文字输入、发送、流式展示与顶部模型选择。原型每次发送返回固定的较长文案,开头含发送时的完整模型名称。
|
已确定 |
| A03 · 真实服务 |
正式开发通过第三方 SDK
接入模型服务。具体服务商、SDK、模型标识与版本、鉴权和部署方式待确认;不把本地定时输出当作正式接入方案。
|
接入方向已确定;具体选型待确认 |
| A04 · 权限 |
目录公开浏览;进入 VIB
或聊天室前检查登录,登录或注册后回到目标。聊天示例不代表模型实际可用或有付费权限。
|
登录策略为本次建议 |
| A05 · 消息与切换 |
本次建议在同一段对话中保留已有消息,切换影响下一次发送;每条回复固定记录其发送时的型号。确认切换时终止未完成回复。
|
本次建议;正式上下文策略待确认 |
| A06 · 型号 |
目录只显示品牌名;聊天室顶部、型号卡片及回复署名显示具体型号。58
个型号为展示样例,不承诺上线、免费或专业版权限。
|
展示范围;正式名单待确认 |
| 页面 / 编号 |
展示内容 |
操作结果 |
| AGENT-01 · 目录 |
标题、动态标识、提问入口、四列 11 项目录、可展开面板和五栏导航。
|
列表内部滚动;「问我任何问题」与 VIB 目录项直达同一 VIB 页面,未登录时先登录并恢复目标,不先打开模型选择器。
|
| AGENT-02 · VIB |
VIB 对话、游戏分析、网站绑定、大厅跳转、机器人内信号流程、切换与返回。
|
普通消息由模型回复并支持停止;三类快捷按钮与完整匹配快捷文案的消息共用对应游戏剧本流程。按稳定操作标识适配多语言,详见 VIB 消息分流与多语言规则;绑定与游戏入口直接进入大厅。 |
| AGENT-03 · 聊天室 |
顶部返回、当前型号和箭头、演示标记;空态欢迎语与三条示例;消息区;五项横向快捷操作;输入、发送或停止按钮。
|
隐藏五栏导航。顶部和输入区固定,仅消息区滚动;用户消息在右,模型回复在左并标注真实所属型号。
|
| AGENT-04 · 模型选择 |
横向品牌条、两列型号卡片、选中状态、取消和固定底部确认按钮。
|
点击品牌仅切换展示范围,点击卡片仅改变待确认项;确认后生效。重复确认当前型号不清空草稿、不停止回复。
|
| AGENT-05 · 导航 |
目录显示五栏导航,各模块切换时导航高度和安全区保持一致,目录面板不覆盖导航。VIB 与其他聊天室使用顶部返回。 |
返回目录恢复面板展开状态、内部列表位置和所选入口焦点。
|
| 触发 |
处理 |
结果 |
| 选择聊天入口 |
校验品牌标识与登录;使用该品牌的默认展示型号,当前页面已选择同品牌型号时继续使用该型号。
|
登录与注册在底部弹层内切换,不丢失目标;取消后留在目录并恢复入口焦点。 |
| 快捷提问 |
把对应文字填入输入区并聚焦,允许编辑。 |
不自动发送,不消耗任何实际额度。 |
| 发送 |
去掉首尾空白;非空且不超过 2000
字符;确认当前登录有效。一次只运行一条回复。Enter 发送,Shift + Enter
换行,输入法组合中不触发发送。
|
立即显示用户消息,创建对应模型的回复位置,开始逐步显示。发送后清空输入;可先写下一条草稿。
|
| 流式更新 |
每次内容只追加到对应请求的回复;处于底部时跟随新内容,向上阅读时停止自动跟随。
|
提供回到最新消息操作;完成时撤销停止控件,恢复发送。 |
| 停止 |
中止当前回复并忽略之后到达的片段,保留已收到内容。 |
标记已停止;不得误触发草稿发送,也不得把部分回复视作完成。
|
| 模型选择确认 |
取消不变更;确认其他型号后先停止进行中的回复,再更新顶部型号。已有消息和草稿保留。
|
新消息锁定新型号,已有回复不被重新署名;切换本身不生成消息。
|
| 离开聊天室 |
停止未完成回复,保留已显示内容。 |
当前页面运行期间可返回查看;刷新后消息和草稿清空、型号回到当前品牌默认项。此为演示生命周期,正式历史策略待确认。
|
| 退出或换账号 |
终止进行中的回复,清除当前演示对话与草稿。 |
另一账号不能读取前一账号消息;登录状态失效时重新要求登录。
|
账号衔接
受限入口在目录上打开底部手机号登录弹层,可切换注册;直接打开聊天室链接也先展示目录与登录弹层。保留 +55 区号选择,手机号输入框只提示并接收 11 位数字。不提供邮箱登录或注册。演示不接入真实账号服务,账号缓存实现见维护附录。
| 状态 |
用户看到什么 |
恢复与约束 |
| 空对话 |
欢迎语、示例提问、快捷操作与可编辑输入区。 |
无内容时不能发送;示例只填入。 |
| 正在回复 |
文字逐步出现,当前型号署名,停止按钮。 |
防止重复发送;滚动阅读不被抢回底部,草稿可编辑。 |
| 回复完成 |
完整文本,恢复发送按钮。 |
后续输入可正常发送,不保留虚假的忙碌状态。 |
| 主动停止 / 切换 / 离开 |
已显示的文本和对应停止原因。 |
后续片段不覆盖页面,不误附加到新型号或新消息。 |
| 输入为空 / 超长 |
空输入禁用发送;达到 2000 字符给出分条提示。 |
保留输入;不把用户文字作为标记或脚本执行。 |
| 真实服务超时 / 中断 |
明确失败原因与已收到的部分内容。 |
保留提问;重试使用该条消息的型号并防重复。超时阈值、自动重试次数和计费回滚待确认;原型不模拟
SDK 成功。
|
| 模型下线 / 无权限 |
说明不可用原因并允许重新选择。 |
不能自动换到另一模型,不用展示样例替代正式可用名单。
|
| 目录为空 / 加载失败 / 未知入口 |
暂无智能体、暂时无法加载或入口不可用。 |
提供重新加载或返回目录;不伪造成功。 |
| 关闭选择器 |
回到原页面,焦点回到触发按钮。 |
关闭按钮、遮罩、Esc 均可取消,弹层内焦点循环。 |
06 / 智能体
通用模型数据与第三方 SDK 边界
| 数据 / 边界 |
要求 |
待确认 |
| 品牌与模型标识 |
区分品牌目录标识、展示型号和服务侧模型标识;只能从有效配置中选择,不用名称直接拼接服务地址。
|
服务商型号映射、上下线和权限配置来源。 |
| 消息 |
包含消息标识、会话归属、角色、文本、发送时间和状态;模型回复必须记录发送时的型号及请求标识。
|
正式持久化、保存期限、删除与跨设备同步。 |
| 进行中的请求 |
关联对应消息与模型,区分发送、接收中、完成、停止、失败。仅当前有效请求可更新对应回复。
|
SDK 的流事件、结束原因、取消方式和断线恢复语义。 |
| 鉴权与凭证 |
由可信服务或受限的临时凭证承接 SDK
调用;不在公开客户端或原型中内置真实长期密钥。账号权限与模型访问权限分别校验。
|
鉴权职责、凭证有效期、服务端与客户端分工。 |
| 上下文 |
切换后保留展示记录不等于必须把全部历史发送给新服务;发送范围需要明确。
|
多模型上下文策略、长度限制、隐私与内容处理规则。 |
| 用量和计费 |
以服务确认结果为依据,区分请求成功、回复完成、取消与扣费;演示不计费、不扣点数。
|
费用、额度、取消与失败后的计费规则。 |
| 演示与真实服务 |
演示只展示固定文案的逐步输出,不访问模型
SDK。正式接入后必须用真实流内容和真实完成/失败结果驱动界面。
|
选定 SDK 后补齐接口契约与联合验证。 |
- 移动端 H5 页面居中,桌面最大宽度 430px;方案文档独立适配电脑、平板和手机。
-
目录四列,选择器型号双列;长型号可换行,顶部名称可省略但辅助名称和选择卡片显示完整文本。箭头与控件右侧保留空隙。
-
聊天室内容和输入区不横向溢出。长消息与连续字符换行;多行输入限制高度后内部滚动,不挤掉整个消息区。
-
适配安全区与键盘引起的可见高度变化,发送、停止、返回和模型确认始终可达。短屏可隐藏快捷操作以保留输入空间。
-
流式回复跟随阅读位置;用户上滑时不自动跳回底部。停止、切换、离开后清理进行中的请求与监听。
-
模型选择器支持触屏、鼠标和键盘;取消恢复焦点,选中状态不只靠颜色。分片输出不逐字打断辅助阅读工具,提供开始、完成或停止状态。
-
减少动态效果偏好下取消闪烁与非必要动画。图标失效保留名称;文本不依赖图标才能辨认。
| 场景 |
应达到的结果 |
| 入口范围 |
「问我任何问题」与唯一 VIB 目录项进入同一页面,登录前后目标一致;其余 10 个入口可到聊天室,通用型号选择器不含 VIB。
|
| 发送与流式展示 |
有效消息立即出现在右侧,较长回复逐步显示且包含发送时的完整型号名;不同提问可使用同一演示文案,真实接入不能用此文案冒充结果。
|
| 空白 / 换行 / 输入法 |
空白不发送,Shift + Enter 换行,输入法确认不误发,长内容可读。
|
| 停止与重复操作 |
停止保留部分文字;回复时不会重复发送,停止不会顺带提交草稿;完成或停止后可以继续发送。
|
| 切换与取消 |
品牌筛选与待选卡片不提前更改当前模型;确认更新名称,取消不变。已有消息署名和草稿保留,切换中断当前回复。
|
| 滚动与布局 |
320px
窄屏、常用手机和桌面均可操作;消息滚动不带动顶部与输入区,上滑阅读后可手动回到最新。
|
| 返回 / 刷新 / 退出 |
返回目录恢复浏览位置;刷新恢复登录与品牌入口、清空演示消息;退出或换账号不显示前一账号消息。
|
| 正式 SDK 联调 |
在实际提供方环境验证权限、流事件、停止、超时、中断与请求隔离;仅页面可操作不代表
SDK 已接入或真实服务已验收。
|
以上为功能预期,实际完成的检查记入维护附录。真实服务尚未接入。
| 事项 |
需确定内容 |
影响 |
| VIB 自有业务 |
正式游戏账号授权、信号资格、计费与剧本版本。 |
决定核心业务的正式授权、信号可用范围及结果确认;详见 VIB 功能规格。 |
| 第三方 SDK |
具体服务商、版本、模型映射、鉴权、流协议与取消能力。
|
真实调用与异常反馈。 |
| 权限与付费 |
正式可用型号、游客体验、订阅、额度与扣费。 |
禁止据演示卡片推定免费或已订阅。 |
| 对话管理 |
保存期限、历史列表、删除、多设备、跨模型上下文。 |
当前演示内存生命周期不构成正式数据策略。 |
| 扩展输入 |
附件、语音、检索及内容处理规范。 |
本次不包含。 |
| 状态与上线 |
产品确认、服务联调与发布安排。 |
当前为 1.0.0 初始草稿,未上线。 |