mirror of
https://github.com/microsoft/agent-framework.git
synced 2026-06-16 21:04:09 +08:00
* Adding support for "wait for response" when invoking workflow http endpoint. * update changelog. * PR comment fixes. * Address PR review feedback. - Return 404 Not Found when no orchestration with the given ID exists - Return 200 OK for failed workflows (the HTTP operation succeeded; the workflow outcome is conveyed via the response body) - Rename 'status' to 'workflowStatus' in WorkflowRunResponse to avoid inconsistency with AgentRunSuccessResponse which uses integer status - Add optional 'error' field (omitted from JSON when null) to WorkflowRunResponse for failed workflow details
Durable Workflow Samples
This directory contains samples demonstrating how to build durable workflows using the Microsoft Agent Framework.
Environment Setup
Prerequisites
- .NET 10 SDK or later
- Durable Task Scheduler running locally or in Azure
Running the Durable Task Scheduler Emulator
To run the emulator locally using Docker:
docker run -d -p 8080:8080 --name durabletask-emulator mcr.microsoft.com/durabletask/emulator:latest
Set the connection string environment variable to point to the local emulator:
# Linux/macOS
export DURABLE_TASK_SCHEDULER_CONNECTION_STRING="AccountEndpoint=http://localhost:8080"
# Windows (PowerShell)
$env:DURABLE_TASK_SCHEDULER_CONNECTION_STRING = "AccountEndpoint=http://localhost:8080"
Samples
Console Apps
| Sample | Description |
|---|---|
| 01_SequentialWorkflow | Basic sequential workflow with ordered executor steps |
| 02_ConcurrentWorkflow | Fan-out/fan-in concurrent workflow execution |
| 03_ConditionalEdges | Workflows with conditional routing between executors |
| 05_WorkflowEvents | Publishing and subscribing to workflow events |
| 06_WorkflowSharedState | Sharing state across workflow executors |
| 07_SubWorkflows | Nested sub-workflow composition |
| 08_WorkflowHITL | Human-in-the-loop workflow with approval gates |
Azure Functions
| Sample | Description |
|---|---|
| 01_SequentialWorkflow | Sequential workflow hosted in Azure Functions |
| 02_ConcurrentWorkflow | Concurrent workflow hosted in Azure Functions |
| 03_WorkflowHITL | Human-in-the-loop workflow hosted in Azure Functions |
| 04_WorkflowMcpTool | Workflow exposed as an MCP tool |