wehub-resource-sync
e768098d0e
Flake8 Lint / flake8 (push) Waiting to run
Publish Promptflow Doc / Build (push) Waiting to run
Publish Promptflow Doc / Deploy (push) Blocked by required conditions
Spell check CI / Spell_Check (push) Waiting to run
tools_continuous_delivery / Private PyPI main branch release (push) Waiting to run
tools_continuous_delivery / Private PyPI non-main branch release (push) Waiting to run
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 logincompleted)
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.