Agent Node InvokeError: [models] Error: ‘required’

问题场景

用户在使用 Dify 1.16.0（Docker 自托管）构建工作流时，配置了 Agent 节点并关联模型，运行后 Agent 节点报错 InvokeError，提示模型验证失败。

报错原文

Agent Node InvokeError: [models] Error: 'required'

原因分析

可能原因是 Agent 节点在通过插件系统调用模型时，模型配置校验未通过。校验要求 plugin_id、model_provider、model 等字段必须完整，若任一字段为空或保存不完整，会触发此 'required' 错误。此外，模型提供商所需的凭证（如 API Key）若缺失也可能导致类似错误。

环境排查

• 确认 Dify 版本是否为 1.16.0（用户报告版本）。
• 确认部署方式为 Docker 自托管，可检查容器日志。
• 确认 Agent 节点中已选定的模型提供商（如 OpenAI、Anthropic 等）及其凭证是否已正确填入并保存。

解决步骤

1. 进入工作流编辑页面，打开报错的 Agent 节点配置。
2. 检查“模型”下拉框是否已选中具体的模型提供商和模型名称（如 gpt-4o）。若为空或显示异常，重新选择并点击“保存”。
3. 确保模型提供商的所有必填凭证字段（如 API Key、Endpoint 等）已填写完整，并测试连接通过。
4. 如果仍然报错，查看后端日志获取更详细的缺失字段信息：

   docker compose logs agent_backend
   docker compose logs plugin_daemon

5. 根据日志中提示的缺失字段，在对应提供商的配置页面补充完整。

验证方法

重新运行包含该 Agent 节点的工作流，观察是否正常输出模型回复，不再出现 InvokeError。

参考来源

langgenius/dify #39274

AI 工具推荐

想把多个 AI 模型放在一个入口？

GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型，适合写作、绘图、视频和日常 AI 工作流。

了解 GamsGo AI

推广链接：通过此链接购买，我可能获得佣金，不影响你的价格。