Dify 插件装好后仍可能不能用，常见原因是装错工作区、没有配置凭证，或工具没有加入当前应用。正确流程应包含“确认来源—安装—授权—加入应用—冒烟测试—记录版本”六步。
先分清插件从哪里来
Dify 的 Integrations 可从三处安装：Marketplace、公开 GitHub 仓库和本地上传的插件包。Marketplace 适合常见模型、工具与数据源；GitHub 安装要确认仓库所有者和版本；本地包适合内部插件，但你需要自己审查代码、网络访问和密钥使用。
进入工作区的 Integrations，先检查右上角当前工作区。安装是工作区级操作，同一插件安装一次后可供该工作区内的应用选择，并不自动出现在其他工作区。
安装并完成凭证配置
- 在 Integrations 中按类型查找插件，打开详情，查看发布者、权限和版本。
- 点击安装；如果页面跳到了另一个 Dify 环境，按官方提示检查 Install Preference 中保存的地址。
- 安装后进入插件配置页，新增凭证。API Key、OAuth 或服务地址只填在凭证界面，不写入提示词。
- 打开目标 Workflow 或 Agent，把插件对应的 Tool 加入画布或能力列表，再选择刚才的凭证。
工作区管理员可把“谁能安装和管理 Integrations”以及“谁能调试 Integrations”分别设为 Everyone、Admins 或 No one。团队环境建议把安装与调试权限收紧到管理员，普通编辑者只使用已审核的插件。
用最小输入做冒烟测试
不要直接拿真实客户数据测试。以搜索类工具为例，输入一个不会泄露隐私的问题，例如“返回 Dify 官方文档首页标题和 URL”，并临时把后续 LLM 节点移除，先观察工具节点原始输出。
插件通过的标准是：节点运行成功，输出结构中包含预期字段，凭证没有出现在日志或回答中；把工具接回 LLM 后，回答仍能保留来源 URL。若节点成功但应用不调用工具，检查工具是否已经加入应用、Agent 指令是否写清调用条件，以及所选模型是否支持工具调用。
更新策略不要一律追最新
Dify 支持按集成类型设置关闭自动更新、仅补丁版本或始终最新。生产应用更适合先记录当前版本和一组固定测试，再在测试应用升级；确认输入输出字段没有变化后，才更新生产工作区。插件移除前还要搜索哪些应用正在引用它。
失败边界与检查清单
- 安装按钮不可用：确认你的工作区角色和管理员设置。
- 401 或 403：重新核对凭证所属账号、权限范围和服务地址。
- 找不到工具：确认安装的是 Tool 类型，并已在当前应用中添加。
- 升级后字段变化：切回记录的版本或恢复应用配置，再按固定样例回归。
本文没有替你审计第三方插件。Marketplace 的审核不能代替你对数据去向、许可和权限的判断；内部敏感数据只交给已批准的插件。安装来源与权限说明以 Dify Integrations 官方文档为准，核验日期为 2026-10-01。
Ai菜鸟网。发布者：AI小管家，转载请注明出处：https://www.alyyhw.com/32281.html
