Microsoft PromptFlow 项目实战：为DAG工作流添加条件控制逻辑-CSDN博客

本文链接：https://blog.csdn.net/gitblog_00947/article/details/148415666

Microsoft PromptFlow 项目实战：为DAG工作流添加条件控制逻辑

前言

在构建复杂的工作流时，条件控制是不可或缺的功能。Microsoft PromptFlow 作为一款强大的工作流编排工具，提供了灵活的条件控制机制，允许开发者基于特定条件动态控制节点的执行路径。本文将深入解析如何利用 activate 配置实现工作流的条件分支控制。

条件控制功能概述

PromptFlow 的 activate 配置是一个实验性功能（截至当前版本），它支持两种主要的条件控制模式：

if-else 条件分支：基于布尔条件决定节点是否执行
switch 多路分支：基于特定值的匹配决定执行路径

环境准备

使用条件控制功能需要满足：

PromptFlow 版本 ≥ 0.1.0b5
建议在开发环境中进行充分测试

核心配置详解

每个节点都可以通过 activate 配置项添加条件控制，包含两个关键参数：

activate:
  when: ${node.output}  # 条件判断依据
  is: true             # 匹配的目标值

配置方式对比

YAML 手动配置

直接编辑 flow.dag.yaml 文件，在目标节点下添加 activate 配置节。

VS Code 可视化配置

打开 flow.dag.yaml 文件
点击"Visual editor"进入可视化界面
选择目标节点的"Activation config"选项
填写 when 和 is 参数

最佳实践与注意事项

输入参数处理

当节点引用可能被跳过的上游节点输出时：

强烈建议为输入参数设置默认值
未设置默认值时，系统会自动传入 None

@tool
def process_data(input_data: str = "default_value"):  # 推荐设置默认值
    # 处理逻辑

输出连接规范

避免将被跳过节点的输出直接连接到工作流最终输出
如果必须连接，系统会输出 None 并产生警告

节点跳过场景分析

系统会在三种情况下跳过节点执行：

条件不满足
activate.when 的值 ≠ activate.is 的设定值
强制执行技巧：设置 when: dummy 和 is: dummy 使条件恒成立
依赖节点被跳过
当 activate.when 引用的上游节点被跳过时
隐式依赖跳过
节点无 activate 配置，但依赖的上游节点被跳过

典型应用场景示例

条件审批流实现

nodes:
- name: check_approval
  # ...(常规配置)

- name: manager_approval
  activate:
    when: ${check_approval.result}
    is: "needs_manager"
  # ...(审批节点配置)

- name: auto_approval
  activate:
    when: ${check_approval.result}
    is: "auto_pass"
  # ...(自动处理配置)

多阶段处理流程

nodes:
- name: detect_language
  # ...(语言检测配置)

- name: process_chinese
  activate:
    when: ${detect_language.result}
    is: "zh"
  # ...(中文处理逻辑)

- name: process_english
  activate:
    when: ${detect_language.result}
    is: "en"
  # ...(英文处理逻辑)