VSCode测试Azure Promptflow自定义数据问答流遇模块缺失错误

问题根源 #

Azure Promptflow云端环境自带专属运行时组件，promptflow.runtime属于云端内部依赖，不在公开PyPI库中，本地环境默认没有。你使用的Vector Index Lookup是云端托管工具，本地调用时会尝试加载这个云端专属模块，因此出现报错。

解决步骤 #

1. 替换云端工具为本地兼容版本 #

Vector Index Lookup是云端专属工具，本地无法直接运行，需替换为本地支持的检索工具：

• 打开VSCode的Promptflow可视化编辑器，找到search_question_from_indexed_docs节点
• 删除原Vector Index Lookup工具，替换为Azure Cognitive Search这类本地可运行的工具
• 配置工具参数（搜索服务端点、API密钥、索引名称），与云端使用的索引信息保持一致

2. 强制指定本地计算目标 #

确保测试时使用本地计算，避免调用云端专属组件：

• 在VSCode的Promptflow面板中，将计算目标切换为Local
• 或在命令行中显式指定：

  pf flow test --flow <flow-name> --compute local
  

3. 补全本地Promptflow依赖 #

安装包含所有本地工具的完整依赖包：

pip install promptflow[all]

注意：无需尝试寻找promptflow.runtime，该包不对外发布，本地无法通过常规渠道安装。

4. 检查flow.dag.yaml配置 #

确保配置未引用云端专属工具：

• 打开flow.dag.yaml，找到search_question_from_indexed_docs节点的tool配置项
• 若为package类型（云端工具的标记），修改为local类型，替换为本地工具的路径或内置工具

验证 #

完成调整后重新运行测试命令：

pf flow test --flow <flow-name>

配置正确的情况下，本地即可正常执行向量检索与问答流程。

内容的提问来源于stack exchange，提问作者MajorLex