Python / .NET Samples - Restructure and Improve Samples (Feature Branc… (#4092)

* Python: .NET Samples - Restructure and Improve Samples (Feature Branch) (#4091) * Moved by agent (#4094) * Fix readme links * .NET Samples - Create `04-hosting` learning path step (#4098) * Agent move * Agent reorderd * Remove A2A section from README Removed A2A section from the Getting Started README. * Agent fixed links * Fix broken sample links in durable-agents README (#4101) * Initial plan * Fix broken internal links in documentation Co-authored-by: crickman <66376200+crickman@users.noreply.github.com> * Revert template link changes; keep only durable-agents README fix Co-authored-by: crickman <66376200+crickman@users.noreply.github.com> --------- Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com> Co-authored-by: crickman <66376200+crickman@users.noreply.github.com> * .NET Samples - Create `03-workflows` learning path step (#4102) * Fix solution project path * Python: Fix broken markdown links to repo resources (outside /docs) (#4105) * Initial plan * Fix broken markdown links to repo resources Co-authored-by: crickman <66376200+crickman@users.noreply.github.com> * Update README to rename .NET Workflows Samples section --------- Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com> Co-authored-by: crickman <66376200+crickman@users.noreply.github.com> * .NET Samples - Create `02-agents` learning path step (#4107) * .NET: Fix broken relative link in GroupChatToolApproval README (#4108) * Initial plan * Fix broken link in GroupChatToolApproval README Co-authored-by: crickman <66376200+crickman@users.noreply.github.com> --------- Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com> Co-authored-by: crickman <66376200+crickman@users.noreply.github.com> * Update labeler configuration for workflow samples * .NET - Reorder Agents samples to start from Step01 instead of Step04 (#4110) * Fix solution * Resolve new sample paths * Move new AgentSkills and AgentWithMemory_Step04 samples * Fix link * Fix readme path * fix: update stale dotnet/samples/Durable path reference in AGENTS.md Co-authored-by: crickman <66376200+crickman@users.noreply.github.com> * Moved new sample * Update solution * Resolve merge (new sample) * Sync to new sample - FoundryAgents_Step21_BingCustomSearch * Updated README * .NET Samples - Configuration Naming Update (#4149) * .NET: Restore AzureFunctions index parity with ConsoleApps under DurableAgents samples (#4221) * Clean-up `05_host_your_agent` * Config setting consistency * Refine samples * AGENTS.md * Move new samples * Re-order samples * Move new project and fixup solution * Fixup model config * Fix up new UT project --------- Co-authored-by: Copilot <198982749+Copilot@users.noreply.github.com>
2026-06-16 21:04:09 +08:00 · 2026-02-26 00:56:10 +00:00
parent 425f27f989
commit 904a5b843e
764 changed files with 1746 additions and 1373 deletions
@@ -0,0 +1,41 @@
+// Copyright (c) Microsoft. All rights reserved.
+
+using Microsoft.Agents.AI.Workflows;
+
+namespace WorkflowVisualizationSample;
+
+/// <summary>
+/// Sample demonstrating workflow visualization using Mermaid and DOT (Graphviz) formats.
+/// </summary>
+/// <remarks>
+/// This sample shows how to use the ToMermaidString() and ToDotString() extension methods
+/// to generate visual representations of workflow graphs. The visualizations can be used
+/// for documentation, debugging, and understanding complex workflow structures.
+/// </remarks>
+internal static class Program
+{
+    /// <summary>
+    /// Entry point that generates and displays workflow visualizations in Mermaid and DOT formats.
+    /// </summary>
+    /// <param name="args">Command line arguments (not used).</param>
+    private static void Main(string[] args)
+    {
+        // Step 1: Build the workflow you want to visualize
+        Workflow workflow = WorkflowMapReduceSample.Program.BuildWorkflow();
+
+        // Step 2: Generate and display workflow visualization
+        Console.WriteLine("Generating workflow visualization...");
+
+        // Mermaid
+        Console.WriteLine("Mermaid string: \n=======");
+        var mermaid = workflow.ToMermaidString();
+        Console.WriteLine(mermaid);
+        Console.WriteLine("=======");
+
+        // DOT
+        Console.WriteLine("DiGraph string: *** Tip: To export DOT as an image, install Graphviz and pipe the DOT output to 'dot -Tsvg', 'dot -Tpng', etc. *** \n=======");
+        var dotString = workflow.ToDotString();
+        Console.WriteLine(dotString);
+        Console.WriteLine("=======");
+    }
+}
@@ -0,0 +1,39 @@
+# Workflow Visualization Sample
+
+This sample demonstrates how to visualize workflows using `ToMermaidString()` and `ToDotString()` extension methods. It uses a map-reduce workflow with fan-out/fan-in patterns as an example.
+
+## Running the Sample
+
+```bash
+dotnet run
+```
+
+## Output Formats
+
+The sample generates two visualization formats:
+
+### Mermaid
+Paste the output into any Mermaid-compatible viewer (GitHub, Mermaid Live Editor, etc.):
+
+![Mermaid Visualization](Resources/mermaid_render.png)
+
+### DOT (Graphviz)
+Render with Graphviz (requires `graphviz` to be installed):
+
+```bash
+dotnet run | tail -n +20 | dot -Tpng -o workflow.png
+```
+
+![Graphviz Visualization](Resources/graphviz_render.png)
+
+## Usage
+
+```csharp
+Workflow workflow = BuildWorkflow();
+
+// Generate Mermaid format
+string mermaid = workflow.ToMermaidString();
+
+// Generate DOT format
+string dotString = workflow.ToDotString();
+```
@@ -0,0 +1,16 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <OutputType>Exe</OutputType>
+    <TargetFrameworks>net10.0</TargetFrameworks>
+
+    <Nullable>enable</Nullable>
+    <ImplicitUsings>enable</ImplicitUsings>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <ProjectReference Include="..\..\..\src\Microsoft.Agents.AI.Workflows\Microsoft.Agents.AI.Workflows.csproj" />
+    <ProjectReference Include="..\Concurrent\MapReduce\MapReduce.csproj" />
+  </ItemGroup>
+
+</Project>