必须同时满足api协议兼容性、向量维度匹配与知识库索引重建三个条件才能启用text-embedding-3模型；需dify v1.5.2+版本，确认/embeddings响应含dimensions字段，配置openai或兼容网关模型后，绑定知识库并强制重新索引。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在Dify中启用OpenAI最新text-embedding-3系列模型（如text-embedding-3-small或text-embedding-3-large），必须同时满足API协议兼容性、向量维度匹配与知识库索引重建三个硬性条件，缺一不可；否则知识库检索将返回空结果或严重降质。
确认Dify版本与OpenAI API支持状态
进入Dify控制台右上角头像 → 「关于」页面，核对版本号是否为 【v1.5.2 或更高】。低于该版本的Dify无法识别text-embedding-3模型返回的dimension字段，会导致嵌入失败且无报错提示。
Dify 3.9.2更新重点增强系统安全性，引入 Chainguard 安全基础镜像并同步社区版 CVE 修复，同时优化 OpenSearch 向量存储兼容性、插件参数传输机制及 Helm 部署配置。新增工作流模型节点缓存能力，可减少重复凭证查询，显著提升复杂工作流初始化速度，为企业级 AI 应用提供更稳定、高效的运行体验。
打开浏览器开发者工具（F12）→ Network标签页 → 在知识库页面触发一次“重新索引”，观察/embeddings接口请求响应体。若返回中包含"dimensions":256或"dimensions":1024字段，说明后端已支持OpenAI v1/embeddings新协议；否则需升级Dify或切换至兼容网关。
配置text-embedding-3模型作为Embedding供应商
方法一：直连OpenAI官方API（推荐用于生产环境）
① 登录Dify → 右上角头像 → 「设置」→ 左侧「模型供应商」→ 点击「+ 添加模型供应商」→ 选择「OpenAI-API-compatible」
② 填写以下三项：
• API Key：sk-proj-开头的密钥（务必使用具备embedding权限的Key）
• Base URL：https://api.openai.com/v1
• 模型名称：【text-embedding-3-small】（成本最低，适合高频查询场景）或 【text-embedding-3-large】（检索率最高，适合长文档/专业术语密集场景）
③ 点击「保存」，Dify将自动发起测试请求并拉取模型元信息。若界面显示“✅ 已连接”，说明配置成功。
方法二：通过OpenAI兼容聚合网关（适合多模型切换或私有化部署）
在「模型供应商」中同样选择「OpenAI-API-compatible」，但Base URL填聚合网关地址（如https://llm-gateway.your-company.com/v1），API Key填网关统一Token。此时模型名称必须严格填写网关映射后的别名（例如embed-3-large），而非原始OpenAI模型名。
绑定Embedding模型到知识库并重建索引
第一步：进入「知识库」列表 → 点击目标知识库右侧「编辑」→ 「嵌入模型」下拉框中选择刚配置的text-embedding-3模型
第二步：重点检查分块策略 —— text-embedding-3-large支持32768 token上下文，但Dify默认分块大小为500字符。若原文档含大段技术参数表或代码块，必须将「分块大小」调至【2000】并勾选「重叠分块」，否则语义断裂导致检索率断崖下跌。
第三步：点击「保存并重新索引」→ 等待状态变为「已完成」。注意：此操作【会清空原有向量索引并不可逆重建】，期间知识库不可用。
这一步不能跳过，也不能仅点击“保存”就认为生效——未触发重新索引的知识库仍使用旧模型向量，新模型配置形同虚设。
