Skip to content

PromptFlow-to-MAF

Directory actions

More options

Directory actions

More options

Latest commit

 

History

History

PromptFlow-to-MAF

README.md

Migrating from Prompt Flow to Microsoft Agent Framework (MAF)

Prompt Flow is being retired. Feature development ended 20 April 2026, with full retirement on 20 April 2027. This repo is a hands-on migration guide with runnable code samples for every step of the move to Microsoft Agent Framework 1.0 (GA as of 2 April 2026, Python & .NET).

Who this is for

Teams running Prompt Flow workloads on Microsoft Foundry or Azure Machine Learning who want a structured, low-risk path to MAF.

The 5-Phase Migration Plan

Phase What you do Folder
1 — Audit & Map Export your PF flow YAML; map every node to its MAF equivalent phase-1-audit/
2 — Rebuild in MAF Re-implement the workflow using WorkflowBuilder and Executor phase-2-rebuild/
3 — Validate Parity Run PF and MAF side-by-side; score similarity with Azure AI Evaluation SDK phase-3-validate/
4 — Migrate Ops Wire up tracing (OTel), deploy as managed online endpoint (Azure ML / AI Foundry), add CI/CD quality gate phase-4-migrate-ops/
5 — Cut Over Switch traffic to MAF; decommission PF endpoints and connections phase-5-cutover/

Work through the phases in order. Each folder has its own README with context, prerequisites, and expected outputs.

Prerequisites

  • Python 3.10+
  • An Azure subscription with:
    • Azure OpenAI resource (or Microsoft Foundry project)
    • Azure AI Search index (for RAG samples only)
    • Application Insights instance (for tracing samples)
  • Azure CLI (az login completed)

Setup

git clone https://github.com/shshubhe/promptflow-migration-guide
cd promptflow-migration-guide/migration-guide/PromptFlow-to-MAF

# GA packages
pip install agent-framework>=1.0.1 agent-framework-foundry>=1.0.1

# Preview packages (orchestrations for multi-agent, Azure AI Search for RAG)
pip install agent-framework-orchestrations agent-framework-azure-ai-search --pre

# Remaining dependencies (evaluation, deployment, tracing)
pip install -r requirements.txt

cp .env.example .env   # then fill in your values

Migrated Examples

See EXAMPLES.md for a full catalog of migrated flows with links to both the original Prompt Flow and MAF versions.

Next Steps

Start with Phase 1 — Audit & Map to export and map your existing Prompt Flow.