AI 助手
门户右下角已经接入 AI 助手,入口复用了主题自带的右下角评论按钮位。它适合用来快速理解当前页面内容、区分 starter / server / demo 的职责,或者追问 e 签宝接入路线。
当前能力
- 支持多轮对话
- 支持流式输出
- 自动带上当前页面标题、路径和正文摘录
- 会先在门户文档中做本地检索,再结合检索结果回答
- 默认按中文回答
- 通过服务端接口转发模型请求,避免在前端暴露密钥
环境变量
部署到 Vercel 时,至少需要配置下面这些环境变量:
bash
OPENAI_API_KEY=你的模型服务密钥
OPENAI_BASE_URL=https://api.openai.com/v1
OPENAI_MODEL=gpt-4o-mini如果你使用的是 OpenAI 兼容接口,比如某个企业网关、DeepSeek 兼容入口或其他模型平台代理,只需要把 OPENAI_BASE_URL 和 OPENAI_MODEL 改成对应值即可。
接口说明
门户前端调用同域接口:
text
POST /api/ai/chat请求体会携带最近几轮消息,以及当前页面上下文。服务端会先从门户 Markdown 文档里做一次本地检索,再把命中的知识片段和上下文一起发给上游模型服务,并以流式方式回传回答。
使用建议
- 适合问“我应该先看哪一页”“这个模块解决什么问题”“当前页面有哪些关键能力”
- 如果你想让回答更贴近业务,可以继续在系统提示词里补充团队术语和约束
- 如果后续需要接更强的知识库检索,可以继续在
/api/ai/knowledge.js里扩展召回逻辑