AI 对话要上手机端,接口连不通才是第一关

智能对话移动版 使用文档
智能对话移动版 使用文档

界面画好了,输入框发出去转了半天,最后弹一句「请求失败」。查日志发现是服务器访问不到外面的接口,而不是代码有问题。

智能对话移动版(ChatMobile)是基于 uniapp 的移动端对话前端,可以编译成 H5。它不实现 AI 能力本身,只负责界面、会话记录和调用调度,真正的请求交给注册的 AI 服务提供方。

三种接口连通方式

设置页上有一项「OpenAi接口」,三个选项:

  • 直连(默认):服务器直接访问官方接口。国内服务器基本走不通。
  • HTTP代理:额外填一个 HTTP 代理地址
  • 反向代理:填一个反向代理地址,把请求转发到官方接口

选后两种时才会出现对应的输入框。模块文档里有一份 Nginx.md,讲的是怎么用 Nginx 做反向代理,包含检测服务器能否访问接口、配置 location 转发、以及带 proxy_ssl_server_name on 的示例。如果你的机器访问不通,先照那份文档把链路打通,再来调界面。

API Key 那一项是多值的,可以填多个,说明写的是「多个 Key 支持随机取用」。量大的时候靠这个分摊限流。

设置页上还有一项「文心一言」,现在点开是一句「敬请期待~」,没有实际配置项。不要指望从这里接国内模型。

界面上就四个页面

前端 pages.json 里只注册了四个业务页面,没有底部导航:

  • pages/home:首页
  • pages/chat/category:智能应用分类
  • pages/chat/app:某个智能应用的对话页
  • pages/member:会员页

1.4.0 之后这一版做了屏幕大小自适应和界面调整,会员 VIP 页加了倒计时、最新开通和立减提示,也就是说它是带付费环节的。

智能应用是什么

后台「智能应用」是一张表,一条记录对应一个对话场景。字段有这些:

  • 分类,走 chat_app_category 树形选择
  • 标题、排序
  • 图标和图标图片二选一,两个都空会校验不过
  • 描述、示例(一组提示语)
  • AI 命令(aiPrompt):一段前缀提示词,会统一加在用户消息之前

最后这个字段是整套配置里最值钱的。写一个「帮写作文」的应用,AI 命令里就写清角色、字数、格式要求,用户只需要输入题目。同一个模型,AI 命令写得好不好,出来的结果差别很大。

应用支持复制(canCopy),改一个应用当模板再调 AI 命令,比从零建快。

分类是独立的一张表,有 pid 和 sort,可以做成两级。

后台智能应用列表,列为 ID、分类、标题、图标与排序

回复是异步的

用户发一条消息,模块不是当场等 AI 返回,而是往 chat_message_reply_job 插一条任务,状态置为队列中,然后派发到队列。任务执行时先用行锁取任务,确认状态还是「队列中」才改成「处理中」,重复触发不会跑两遍。

这么做的好处是请求不会因为 AI 响应慢而超时,坏处是必须有队列在跑。如果你的站点没配队列 worker,消息会一直停在「队列中」,前端表现为一直转圈。

任务表在后台「对话消息」里能看到,列为 ID、用户消息、AI 回复,可以按用户 ID 筛选,不可编辑。排查问题时先来这里看:如果一条任务的 AI 回复是空的,说明取 AI 服务提供方那一步就失败了,日志里会留一句 No ChatAiProvider。

数据落在哪几张表

会话相关的是 chat_room、chat_room_user、chat_message(含 isDeleted 软删标记);应用侧单独有一张 chat_app_message,存 request 和 response。用户是 chat_user,带 uid 和 memberUserId 两个标识,前者对未登录游客,后者对已登录会员。

移动端对话页,上方为机器人与用户的消息气泡,下方是输入框

上线前要确认的四件事

第一,服务器能不能访问到接口,用文档里的 curl 命令测一下,不通就先配代理。

第二,队列有没有在跑。这是最容易被漏掉的一项,本地开发同步执行看不出问题,上线就卡住。

第三,机器人名称和对话引导填了没有。名称在 Chat_Title,引导是 Chat_MessageTips,默认给了六条示例(帮写作文、帮做论文之类),这些是空输入框下面给用户看的提示,不换掉的话用户会以为这是个作文工具。机器人头像是固定的 robot.svg,要换得改静态资源。

第四,先建两个智能应用试效果。空应用列表的首页是没什么可点的,用户进来不知道能问什么。

更新: 2026-11-12 19:13:56
QQ
微信
客服