Open WebUI 聊天与知识库接入
聊天模型与 Embedding 是两个配置。官方连接和知识库资料已核验；本机未安装 Open WebUI，知识库端到端执行尚未实测。下面给出分开验证的流程。2026-09-28，text-embedding-3-small 独立接口真实返回 HTTP 200 和 1536 维向量，usage.total_tokens=6；这不代表文档导入和检索已经通过。
第 1 步：配置聊天连接
进入 apizt 控制台 → API 令牌 → 新建，选择支持目标模型及协议的分组，设置额度后复制令牌。已有令牌可继续使用；模型目录和权限不是同一回事。查看创建分组令牌的图文步骤。
头像 → Settings → Admin → Connections → Manage OpenAI API Connections，新增 URL=https://api.apizt.com/v1、Key=apizt 令牌。保存后选择支持 Chat 的模型，先用 gpt-4o 发短文本。管理员与用户的直连设置不要混用，确认配置保存于实际运行实例。
第 2 步：单独配置 Embedding
进入 Settings → Admin → Documents；Embedding Engine 选 OpenAI，Embedding API 基址为 https://api.apizt.com/v1，Key 使用支持嵌入模型的令牌，Embedding Model 填 text-embedding-3-small。字段名称按版本核对。
| 功能 | 模型示例 | 接口 | 验证目标 |
|---|---|---|---|
| 聊天 | gpt-4o | /v1/chat/completions | 返回非空聊天文本 |
| Embedding | text-embedding-3-small | /v1/embeddings | 返回非空 embedding 数组并记录维度 |
| 检索回答 | 聊天 + 同一 Embedding 模型 | 应用的知识库检索流程 | 问题能命中自己导入的片段与引用 |
第 3 步：导入可核对的小文档
创建测试文档，例如“项目代号：蓝鲸；客服营业时间：09:00–18:00”。在 Workspace → Knowledge 建立知识库并上传，等待处理与索引完成；在新聊天关联该知识库后问“项目代号和客服时间是什么？”。核对引用片段，而不是只看模型答案看起来正确。
第 4 步：分层排查失败
| 问题 | 检查与修复 |
|---|---|
| 聊天成功但导入失败 | 检查 Documents 中 Embedding 引擎、Key 和模型，不只看 Connections |
| 上传完成但检索不到 | 检查提取结果、索引状态、知识库绑定与用户访问权限 |
| 更换 Embedding 后异常 | 新旧向量空间不可混用；在管理员 Documents 中重新索引已有文档 |
| 有答案却无正确引用 | 用独有测试事实核对检索结果；调整文档提取、分块和检索配置 |
接口与进一步配置
Open WebUI 基础图文配置 · Embedding 请求参数 · Embedding 返回对象 · 聊天与嵌入费用。
官方 OpenAI Compatible 连接 · 官方知识库与 Embedding · 官方重新索引排错。
开始实践：注册并创建 API Key · 已有账号，进入控制台 · 查看当前模型价格。