必须完成配置文件修改、环境变量设置、知识库创建三步闭环操作——缺一不可，否则知识库上传后无向量写入、检索返回空结果；需在Pinecone控制台获取v3版API Key与Environment，手动创建dify-kb索引（维度768、cosine距离），修改.env启用pinecone并填入参数，重启服务后验证连接，最后创建知识库并选择匹配维度的embedding模型触发向量化。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在Dify中成功启用Pinecone作为向量数据库，必须完成配置文件修改、环境变量设置、知识库创建三步闭环操作——缺一不可，否则知识库上传后无向量写入，检索返回空结果。
确认Pinecone服务已就绪
登录Pinecone控制台，进入Projects页面，复制当前项目的API Key和Environment（如gcp-us-central1），这两项将在后续配置中直接使用。
注意：Pinecone不再支持旧版API Key格式，若看到以sk-开头的密钥，请立即在控制台重新生成v3版本密钥。
在同一个Project内，手动创建一个Index，名称设为【dify-kb】，维度设为【768】（对应BGE-base-zh或text-embedding-ada-002等主流嵌入模型输出维度），距离度量选cosine。这一步不能跳过，Dify不会自动创建Index，未预建将导致向量化失败并静默报错。
修改Dify的.env配置文件
进入Dify项目根目录，执行cp .env.example .env创建配置副本。
用编辑器打开.env，定位到向量存储相关字段：
将VECTOR_STORE=weaviate改为VECTOR_STORE=pinecone；
取消注释以下四行，并填入Pinecone实际参数：
PINECONE_API_KEY=your_actual_api_key_here
PINECONE_ENVIRONMENT=gcp-us-central1
PINECONE_INDEX=dify-kb
PINECONE_PROJECT_ID=your_project_id_if_needed（仅当使用企业版多Project场景时填写，社区版留空即可）
务必删除PINECONE_PROJECT_ID行末尾的空格或不可见Unicode字符，否则启动时会因YAML解析失败而卡在初始化阶段
重启Dify服务并验证连接
执行docker compose down && docker compose up -d重启服务。
等待约90秒，访问http://localhost:3000进入Dify控制台，在右上角点击头像→「管理后台」→「系统状态」，查看「向量数据库」一栏是否显示pinecone (connected)。
若显示disconnected，请立即检查容器日志：docker logs dify-api | grep -i pinecone，常见错误是Invalid API key或Index。
创建知识库并触发向量化
第一步：进入「数据集」→「新建数据集」，填写名称与描述，选择「外部向量数据库」类型；
第二步：在「向量嵌入模型」下拉菜单中，必须选择维度为768的模型（如BGE-base-zh或text-embedding-ada-002），否则向量维度不匹配，上传文档后无法写入Pinecone；
第三步：点击「保存」后，上传PDF/Markdown等文件，Dify将自动调用嵌入模型生成向量，并写入Pinecone的dify-kb索引中。
