Microsoft Agent Framework Tryout

This repository contains a collection of focused C# sample projects for learning and experimenting with the Microsoft Agent Framework (MAF). Because MAF is sometimes feels buggy and certainly in combination with Microsoft Foundry it is important to have simple samples to test the evolution and progress of the framework in the .NET and Azure landscape.

Each sample lives in its own project folder and has its own markdown guide.

Goals

• Keep each sample isolated in its own C# project.
• Document every sample with a dedicated markdown file.
• Make it easy to run and compare patterns (tools, telemetry, orchestration, etc.).

Sample Index

Sample	Project Folder	Guide
OpenTelemetry + Aspire standalone dashboard	opentelemetry-aspire-dashboard	OpenTelemetry sample guide
Agents as tools (full API controllers)	agents-as-tools	Agents as tools sample guide
DevUI interactive test client	devui	DevUI sample guide

Planned Samples

Add new rows here as you create additional projects. Suggested sample ideas:

• Agent OpenTelemetry with standalone Aspire dashboard as receiver
• Agent framework devui test client
• Multi-agent coordination
• Agents as tools
• RAG (retrieval-augmented generation)
• Aspnet Core as AG-UI server to frontend
• Frontend AG-UI directly to agents (no Aspnet Core AG-UI server in between)
• Hybrid AG-UI
• Workflows
• Agentic workflows
• Foundry persisted agents

How to Add a New Sample

1. Create a new C# project folder for the sample and add it to the slnx solution file.
2. Add a markdown guide under samples/.
3. Add a row to the Sample Index table linking project folder and guide.
4. Keep each sample self-contained with prerequisites and run instructions.