Pydantic AI example ignores the documented Inner API environment names

这个问题通常出现在自托管 Dify 源码环境中运行 Pydantic AI 示例脚本时:示例的配置加载器读取的是不带前缀的 DIFY_INNER_API_URL 和 DIFY_INNER_API_KEY ,而模板里记录的是带 DIFY_AGENT_ 前缀的变量名,导致脚本在做必填检查时直接报缺变量。

快速结论:这个问题通常出现在自托管 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、显卡或节点版本,相关版本问题不在本次排查范围内。

解决步骤

  1. 从 dify-agent/.example.env 读取 DIFY_AGENT_INNER_API_URL 和 DIFY_AGENT_INNER_API_KEY 的实际值。
  2. 在运行 run_pydantic_ai_agent.py 的进程环境中设置 DIFY_INNER_API_URL,值与 DIFY_AGENT_INNER_API_URL 相同。
  3. 在同一进程环境中设置 DIFY_INNER_API_KEY,值与 DIFY_AGENT_INNER_API_KEY 相同,且该 key 应对应 API/worker 的 INNER_API_KEY_FOR_PLUGIN。
  4. 如果选择写入 .env,填入实际字符串值,不要使用 ${DIFY_AGENT_…} 之类的引用写法,示例加载器不会展开引用。
  5. 保持原有 DIFY_AGENT_* 配置不变,重新运行示例。

验证方法

重新运行示例后,配置加载器与必填值检查应能通过那两个变量的校验,不再在发出请求前触发缺失变量错误;后续请求应正常发起。若仍报缺变量,先确认新变量确实存在于示例进程的环境中,而非仅写在未被加载的文件里。

参考来源

langgenius/dify #46575

GamsGo AI

AI 工具推荐

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

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

了解 GamsGo AI

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

这个方案解决了吗?

celebrityanime
celebrityanime
文章: 36185

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注