Skip to content

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_URLOPENAI_MODEL 改成对应值即可。

接口说明

门户前端调用同域接口:

text
POST /api/ai/chat

请求体会携带最近几轮消息,以及当前页面上下文。服务端会先从门户 Markdown 文档里做一次本地检索,再把命中的知识片段和上下文一起发给上游模型服务,并以流式方式回传回答。

使用建议

  • 适合问“我应该先看哪一页”“这个模块解决什么问题”“当前页面有哪些关键能力”
  • 如果你想让回答更贴近业务,可以继续在系统提示词里补充团队术语和约束
  • 如果后续需要接更强的知识库检索,可以继续在 /api/ai/knowledge.js 里扩展召回逻辑
最近更新

EsignHelper Portal powered by VitePress Theme Teek