wehub-resource-sync
80 lines
3.1 KiB
Markdown
80 lines
3.1 KiB
Markdown
# 🤝 Enterprise Multi-Agent Workflow Systems (.NET)
|
|
|
|
## 📋 Learning Objectives
|
|
|
|
This notebook demonstrates how to build sophisticated enterprise-grade multi-agent systems using the Microsoft Agent Framework in .NET with GitHub Models. You'll learn to orchestrate multiple specialized agents working together through structured workflows, leveraging .NET's enterprise features for production-ready solutions.
|
|
|
|
**Enterprise Multi-Agent Capabilities You'll Build:**
|
|
- 👥 **Agent Collaboration**: Type-safe agent coordination with compile-time validation
|
|
- 🔄 **Workflow Orchestration**: Declarative workflow definition with .NET's async patterns
|
|
- 🎭 **Role Specialization**: Strongly-typed agent personalities and expertise domains
|
|
- 🏢 **Enterprise Integration**: Production-ready patterns with monitoring and error handling
|
|
|
|
## ⚙️ Prerequisites & Setup
|
|
|
|
**Development Environment:**
|
|
- .NET 9.0 SDK or higher
|
|
- Visual Studio 2022 or VS Code with C# extension
|
|
- Azure subscription (for persistent agents)
|
|
|
|
**Required NuGet Packages:**
|
|
```xml
|
|
<PackageReference Include="Microsoft.Extensions.AI.Abstractions" Version="9.9.0" />
|
|
<PackageReference Include="Azure.AI.Agents.Persistent" Version="1.2.0-beta.4" />
|
|
<PackageReference Include="Azure.Identity" Version="1.15.0" />
|
|
<PackageReference Include="System.Linq.Async" Version="6.0.3" />
|
|
<PackageReference Include="Microsoft.Extensions.AI" Version="9.8.0" />
|
|
<PackageReference Include="DotNetEnv" Version="3.1.1" />
|
|
<PackageReference Include="Microsoft.Extensions.AI.OpenAI" Version="9.9.0-preview.1.25458.4" />
|
|
```
|
|
|
|
## Code Sample
|
|
|
|
The complete working code for this lesson is available in the accompanying C# file: [`08-dotnet-agent-framework.cs`](./08-dotnet-agent-framework.cs)
|
|
|
|
To run the sample:
|
|
|
|
```bash
|
|
# Make the file executable (Linux/macOS)
|
|
chmod +x 08-dotnet-agent-framework.cs
|
|
|
|
# Run the sample
|
|
./08-dotnet-agent-framework.cs
|
|
```
|
|
|
|
Or using the .NET CLI:
|
|
|
|
```bash
|
|
dotnet run 08-dotnet-agent-framework.cs
|
|
```
|
|
|
|
## What This Sample Demonstrates
|
|
|
|
This multi-agent workflow system creates a hotel travel recommendation service with two specialized agents:
|
|
|
|
1. **FrontDesk Agent**: A travel agent that provides activity and location recommendations
|
|
2. **Concierge Agent**: Reviews recommendations to ensure authentic, non-touristy experiences
|
|
|
|
The agents work together in a workflow where:
|
|
- The FrontDesk agent receives the initial travel request
|
|
- The Concierge agent reviews and refines the recommendation
|
|
- The workflow streams responses in real-time
|
|
|
|
## Key Concepts
|
|
|
|
### Agent Coordination
|
|
The sample demonstrates type-safe agent coordination using the Microsoft Agent Framework with compile-time validation.
|
|
|
|
### Workflow Orchestration
|
|
Uses declarative workflow definition with .NET's async patterns to connect multiple agents in a pipeline.
|
|
|
|
### Streaming Responses
|
|
Implements real-time streaming of agent responses using async enumerables and event-driven architecture.
|
|
|
|
### Enterprise Integration
|
|
Shows production-ready patterns including:
|
|
- Environment variable configuration
|
|
- Secure credential management
|
|
- Error handling
|
|
- Asynchronous event processing
|