1. 从一次“搜不到”的尴尬说起为什么要在 CCE 上给 DeepSeek 装博查插件你有没有遇到过这种场景在华为云 Flexus 云服务器上把 DeepSeek 跑起来了Dify 也登录进去了模型对话一切正常可一旦问它“今天有什么新发布的 AI 模型”“帮我查一下某个库最新版本号”它就开始一本正经地胡说八道。原因很简单——大模型的知识有截止时间它不知道此刻互联网上发生了什么。要解决这个问题就得给模型接上“实时搜索”这条腿。博查BochaAI 搜索是一个基于大模型和实时搜索技术的答案引擎你用自然语言提问它会理解意图、拆分检索、再生成答案并且提供可追溯的参考源。把它作为插件挂到 Dify 上DeepSeek 就从“闭卷考试”变成了“开卷考试”。这篇内容聚焦的是华为云 Flexus DeepSeek 组合下通过博查插件搭建多模态 AI 搜索的完整落地路径。适合已经在 CCE 或 Flexus 单机上部署过 Dify、想进一步把联网检索能力接进来的开发者。我会给出可复制的插件安装命令、CC Switch 与 settings.json 的配置骨架以及搜索链路连通性的验证动作让你在 CCE 环境里快速复现企业级多模态检索能力。需要提前说明的是博查插件本身是在 Dify 的插件市场里安装的但真正决定它能不能跑通的是底层网络出口、API Key 注入和容器环境变量这三件事。很多人卡住不是因为插件装不上而是装上了却一直报“连接超时”或“401”。下面按顺序拆开讲。2. 前置准备TaoToken 与华为云环境的对接思路在动手之前先把“模型从哪来、搜索从哪来”这两条链路理清楚。DeepSeek 的推理服务可以走华为云 ModelArts Studio 的在线推理也可以走兼容 OpenAI 协议的聚合入口。如果你希望用一套 Key 同时管理对话模型和后续的编码类模型可以了解下 TaoToken 这个入口官网是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 地址是 https://taotoken.net/api 这个不加 UTM。它的定位是兼容 OpenAI 接口规范的模型调用入口好处是你不用为每个模型单独改代码Dify 里配置一个 OpenAI 兼容的模型供应商就能切换。对于本篇要做的“模态 AI 搜索”模型负责理解和总结博查负责实时检索两者通过 Dify 的工作流串起来。在华为云侧你需要确认三件事已经就绪第一Flexus 云服务器 X 实例或 CCE 集群已经部署好 Dify能通过公网 IP 正常登录。第二ModelArts Studio 控制台里已经开通了 DeepSeek-V3 或 R1 的在线推理拿到了模型名称和 API Key。第三服务器的出网能力正常因为博查插件要访问外部搜索 API如果 CCE 集群只配了内网需要确认 NAT 网关或 EIP 已经放通。提示CCE 高可用部署场景下Pod 的出网走的是 NAT 网关不是节点 EIP。如果你在单机上测试能通、搬到 CCE 就不通八成是 NAT 规则没放行。拿到模型侧的信息后建议先在本地用 curl 验证一次模型接口确认 Key 和地址没问题再去 Dify 里配置。这样能把“模型问题”和“插件问题”分开排查。3. 可复制配置博查插件安装与 CC Switch / settings.json 骨架这一节是核心操作区。博查插件在 Dify 里的安装路径是进入 Dify 工作台点击左侧“插件”选择“探索插件市场”搜索“博查”或“Bocha”点击安装。安装完成后需要在插件配置里填入博查的 API Key这个 Key 要去博查官网的搜索 API 页面创建。但如果你是在 CCE 环境里做批量部署或者想让配置可版本化管理光靠界面点是不够的。下面给出一套可复制的配置骨架。先看环境变量注入。在 CCE 的“配置项与密钥”里新建一个 Secret把博查的 Key 和模型 Key 都放进去避免硬编码apiVersion: v1 kind: Secret metadata: name: dify-search-secret namespace: default type: Opaque stringData: BOCHA_API_KEY: 你的博查APIKey MODEL_API_KEY: 你的模型APIKey MODEL_BASE_URL: https://taotoken.net/api然后在 Dify 的 Deployment 里引用这个 Secretenv: - name: BOCHA_API_KEY valueFrom: secretKeyRef: name: dify-search-secret key: BOCHA_API_KEY - name: MODEL_API_KEY valueFrom: secretKeyRef: name: dify-search-secret key: MODEL_API_KEY接下来是 CC Switch 的配置。CC Switch 在这里的作用是切换不同的模型供应商配置方便你在 DeepSeek 官方接口和聚合入口之间来回切。它的配置文件通常放在~/.cc-switch/config.json骨架如下{ providers: [ { name: taotoken, baseUrl: https://taotoken.net/api, apiKeyEnv: MODEL_API_KEY, models: [deepseek-v3, deepseek-r1] }, { name: huawei-maas, baseUrl: https://你的ModelArts推理地址, apiKeyEnv: MAAS_API_KEY, models: [DeepSeek-V3] } ], active: taotoken }如果你更习惯用 settings.json 统一管理可以放在 Dify 插件的工作目录下结构类似{ plugin: bocha, search: { endpoint: https://api.bochaai.com/v1/web-search, apiKeyEnv: BOCHA_API_KEY, timeout: 15000, maxResults: 8 }, model: { provider: openai-compatible, baseUrl: https://taotoken.net/api, modelName: deepseek-v3 } }这里的关键参数有三个endpoint是博查的搜索接口地址timeout建议给到 15 秒因为多模态搜索要抓取视频和图片的元信息比纯文本慢maxResults控制在 8 条以内太多会拖长模型总结时间。注意博查的 API Key 只在创建时显示一次务必当场复制保存。如果丢了只能重新创建。配置写完后重启 Dify 的相关 Pod 让环境变量生效kubectl rollout restart deployment dify-api -n default kubectl rollout restart deployment dify-worker -n default4. 验证请求确认搜索链路真的通了配置完不代表通了必须做连通性验证。分两步走先验博查接口本身再验 Dify 工作流里的插件调用。第一步在服务器上直接 curl 博查接口排除网络问题curl -X POST https://api.bochaai.com/v1/web-search \ -H Authorization: Bearer $BOCHA_API_KEY \ -H Content-Type: application/json \ -d { query: 华为云 Flexus 最新实例规格, count: 5, freshness: oneWeek }如果返回里能看到webPages数组和若干条带name、url、snippet的结果说明博查侧通了。如果返回 401检查 Key 是否有多余空格如果超时检查 CCE 的 NAT 出网规则。第二步在 Dify 里建一个最小工作流开始节点 → 博查搜索节点 → DeepSeek 模型节点 → 结束节点。搜索节点填查询变量模型节点把搜索结果拼进提示词。运行一次输入“最近一周 AI 领域有什么新模型发布”观察输出。实测下来正常链路的表现是搜索节点耗时 1 到 3 秒模型总结耗时 2 到 5 秒最终答案里会带上参考链接。如果模型节点报“context length exceeded”说明搜索结果太长把maxResults调小到 5。第三步验证多模态能力。博查支持视频和图片搜索你可以在查询里明确写“找一段关于 CCE 部署的教学视频”看返回结果里是否包含视频类条目。这一步能确认你用的是完整版搜索能力而不是被降级的纯文本接口。5. 本篇常见错排查从 401 到超时的六种情况排障这块我按出现频率从高到低列基本覆盖了绝大多数人的踩坑点。错误一插件安装后显示“未授权”。这是最常见的问题原因是博查 Key 没有正确注入。先去 Dify 插件页面点开博查插件确认 Key 填的是搜索 API 的 Key不是账号登录密码。如果用了 Secret 注入进 Pod 里echo $BOCHA_API_KEY看是否为空。错误二搜索请求返回 401 Unauthorized。两种可能Key 过期或者请求头格式不对。博查要求Authorization: Bearer key注意 Bearer 后面有一个空格。用 curl 复现一次就能定位。错误三CCE 里 Pod 出网超时。单机能通、CCE 不通基本是 NAT 网关没配 SNAT 规则。去 NAT 网关控制台确认 SNAT 规则绑定了正确的子网并且弹性公网 IP 有余量。错误四模型节点报 context 超限。博查返回的网页摘要比较长8 条结果拼起来可能超过模型上下文。解决办法是在工作流里加一个文本截断节点或者把maxResults降到 5snippet只取前 200 字。错误五搜索结果为空但接口返回 200。检查freshness参数如果设成oneDay而查询词又很冷门可能确实没有近期结果。改成oneMonth或去掉该参数再试。错误六Dify 工作流里插件节点报“plugin not found”。插件装了但工作流没刷新。退出工作流编辑页重新进入或者在插件管理里点一次“重新加载”。提示排障时优先用 curl 验证博查接口再用 Dify 的“测试节点”功能单独跑搜索节点最后才跑完整工作流。逐层缩小范围比一上来就怀疑模型快得多。如果你在接入文档里找不到对应报错可以去 TaoToken 的接入文档页对照 OpenAI 兼容接口的返回格式很多 401 和 404 其实是 baseUrl 多写或少写了/v1。模型对话相关的验证可以直接在模型对话页做一次快速提问确认模型侧本身是通的。6. 语义一致 CTA把搜索能力沉淀成长期可用的工作流博查插件跑通之后真正的价值不在于“能搜一次”而在于把它固化成一个可复用的工作流。我的建议是在 Dify 里建一个“实时问答助手”应用把博查搜索作为固定前置节点DeepSeek 作为总结节点然后把这个应用发布成 API接到你的内部工具或客服系统里。如果你后续要做更复杂的编码类 Agent比如让模型自己决定什么时候搜索、什么时候直接回答那就需要更稳定的模型调用配额和更灵活的供应商切换能力。这种情况下可以了解下 Coding Plan 这类面向长期编码场景的方案配合 CC Switch 做多供应商热切换避免单一接口限流导致工作流中断。另外提醒一句博查的搜索 API 是按调用量计费的调试阶段建议把maxResults设小、freshness设窄既能省钱又能加快响应。等提示词调稳了再放开。最后留一个我实际踩过的坑CCE 环境里如果开了 Pod 的 readiness 探针而 Dify 启动时又要去拉插件配置网络慢的时候探针会误判 Pod 没就绪导致反复重启。把initialDelaySeconds调到 30 秒以上就能避开。这个细节在单机上不会遇到但企业级部署里很常见。