帮帮搬办AI Gateway
登录 注册
Tutorial / 微信小程序接入

微信小程序接入 AI 对话教程：用 OpenAI 兼容接口接聊天、助手与业务问答

微信小程序里接 AI，最重要的不是“把接口打通”，而是把密钥放在服务端、把会话和业务逻辑拆清楚。这样你才能把聊天、客服、知识问答和业务助手做得稳定，又不会把令牌暴露在前端。

这篇教程适合谁？

如果你正在搜索 微信小程序接 AI、小程序接 OpenAI 接口、微信小程序 AI 对话，这篇就是给你的。重点不是做一个会说话的 demo，而是把业务可上线的结构搭好。

一、为什么小程序接 AI 一定要走服务端

  • API Key 不能直接写进小程序前端
  • 服务端可以统一做鉴权、限流和日志
  • 后面想切模型、做风控、做审计都更方便
  • 客服、知识问答、内容助手都更适合走后端中转

二、推荐的整体结构

最稳的方式，是把小程序前端、业务后端和 AI Gateway 分开：

  1. 小程序前端发起会话请求
  2. 你的业务后端先做登录态、用户身份和权限判断
  3. 后端再调用 AI Gateway 的 OpenAI 兼容接口
  4. 模型结果再返回给小程序前端展示

三、最核心的调用方式

服务端可以按 OpenAI 兼容接口去调，先把接口统一成一个入口。

Base URL: https://api.bangban.xin/v1
Authorization: Bearer sk-your-token

四、一个最常见的小程序 AI 场景

  • 首页一个“AI 助手”入口
  • 用户输入问题后，先发到业务后端
  • 后端补充上下文，再调用模型
  • 前端显示结果，必要时支持继续追问

五、建议先做的三个功能

  1. 客服问答
  2. 知识库查询
  3. 业务表单自动总结

这三个功能最容易验证业务价值，也最容易看出模型、提示词和知识准备是否到位。

六、前端请求可以怎么设计

小程序前端建议只负责展示，不直接碰密钥。请求体里尽量带上最少但足够的信息：

{
  "session_id": "u_123",
  "question": "我想咨询产品价格",
  "scene": "customer_service"
}

七、服务端调用建议

  • 做统一会话 ID，方便追踪
  • 把用户身份、场景、历史消息放进上下文
  • 对高风险问题做拒答或转人工
  • 保存关键日志，方便后续调试

八、最常见的 5 个问题

1. 401 Unauthorized

通常是后端传错了 Token，或者授权头格式不对。

2. 404 Not Found

多半是 API Base 少了 /v1，或者路径写错。

3. 小程序请求超时

建议把长对话做成流式或异步方案，不要每次都死等完整结果。

4. AI 答非所问

先检查提示词和场景上下文，不要只盯着模型。

5. 密钥泄露风险

只要把密钥放前端，就有风险；必须放服务端。

九、适合承接的 SEO 关键词

  • 微信小程序接 AI
  • 小程序接 OpenAI 接口
  • 微信小程序 AI 对话
  • 小程序客服机器人
  • 小程序知识问答