快速结论:这个问题通常出现在自托管 Dify 源码环境中运行 Pydantic AI 示例脚本时:示例的配置加载器读取的是不带前缀的 DIFY_INNER_API_URL 和 DIFY_INNER_API_KEY,而模板里记录的是带 DIFY_AGENT_ 前缀的变量名,导致脚本在做必填检查时直接报缺变量。优先核对示例实际读取的变量名,而不是只改文档里的模板。
适用环境:Dify 源码部署(Self Hosted / Source),main 分支提交 ef7c7d620d;涉及 dify-agent 下的 run_pydantic_ai_agent.py 示例、dify-agent/.example.env 模板及 ServerSettings 配置类。Issue 未提供操作系统、Python、CUDA、显卡或依赖版本信息。
最快修复方案:在运行示例的进程环境中额外提供 DIFY_INNER_API_URL 和 DIFY_INNER_API_KEY,取值分别与对应的 DIFY_AGENT_INNER_API_URL、DIFY_AGENT_INNER_API_KEY 一致,无需改动原有 .env。这是 Issue 讨论中给出的临时规避方式。
注意事项:该方案只是绕过示例的变量名不一致,并未修正源码逻辑。若把变量写进 .env,应填实际值而不是 ${DIFY_AGENT_…} 引用,因为示例加载器只去除引号、不做变量引用展开。此外,该 key 应与 API/worker 的 INNER_API_KEY_FOR_PLUGIN 一致,而不是 INNER_API_KEY。
问题场景
用户在自托管 Dify 源码环境中,按 dify-agent/.example.env 模板配置好 DIFY_AGENT_INNER_API_URL 和 DIFY_AGENT_INNER_API_KEY,并补齐其他示例所需前置条件后,运行 run_pydantic_ai_agent.py。示例的配置加载器会把 .env 载入 os.environ,然后直接查找这两个不带前缀的变量名,因此文档中的变量无法满足示例的必填检查,在发出任何请求之前就报错。
报错原文
Pydantic AI example ignores the documented Inner API environment names
按 Issue 复现描述,用包含文档变量(DIFY_AGENT_INNER_API_URL、DIFY_AGENT_INNER_API_KEY)的临时文件运行示例的配置加载器与必填值检查时,会在发出请求前先后触发两个缺失变量错误。
原因分析
问题范围仅限于该示例的配置路径:示例加载 .env 后直接查找 DIFY_INNER_API_URL 和 DIFY_INNER_API_KEY,而没有走 ServerSettings——后者带有 DIFY_AGENT_ 前缀,与模板一致。因此模板中记录的 DIFY_AGENT_* 变量不会被示例的检查识别。这属于示例与配置模板命名不一致,而不是 Inner API 服务本身不可用。
环境排查
- 确认 Dify 为源码自托管部署,且代码位于
main分支ef7c7d620d或包含同一示例逻辑的版本。 - 检查
dify-agent/.example.env中 Inner API 相关变量名是否为DIFY_AGENT_INNER_API_URL与DIFY_AGENT_INNER_API_KEY。 - 检查
run_pydantic_ai_agent.py实际读取的变量名是否为DIFY_INNER_API_URL与DIFY_INNER_API_KEY。 - 确认 API/worker 侧的
INNER_API_KEY_FOR_PLUGIN取值,并核对待填 key 是否与之匹配,而非INNER_API_KEY。 - Issue 未提供 Python、CUDA、PyTorch、显卡或节点版本,相关版本问题不在本次排查范围内。
解决步骤
- 从
dify-agent/.example.env读取DIFY_AGENT_INNER_API_URL和DIFY_AGENT_INNER_API_KEY的实际值。 - 在运行
run_pydantic_ai_agent.py的进程环境中设置DIFY_INNER_API_URL,值与DIFY_AGENT_INNER_API_URL相同。 - 在同一进程环境中设置
DIFY_INNER_API_KEY,值与DIFY_AGENT_INNER_API_KEY相同,且该 key 应对应 API/worker 的INNER_API_KEY_FOR_PLUGIN。 - 如果选择写入
.env,填入实际字符串值,不要使用${DIFY_AGENT_…}之类的引用写法,示例加载器不会展开引用。 - 保持原有
DIFY_AGENT_*配置不变,重新运行示例。
验证方法
重新运行示例后,配置加载器与必填值检查应能通过那两个变量的校验,不再在发出请求前触发缺失变量错误;后续请求应正常发起。若仍报缺变量,先确认新变量确实存在于示例进程的环境中,而非仅写在未被加载的文件里。
参考来源
AI 工具推荐
想把多个 AI 模型放在一个入口?
GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型,适合写作、绘图、视频和日常 AI 工作流。
推广链接:通过此链接购买,我可能获得佣金,不影响你的价格。
这个方案解决了吗?
可以继续搜索完整报错,或查看同一工具的其他排查指南。


