💡 Practical GenAI-Eshop application using Semantic Kernel, multi-agent orchestrations, Mcp tools, A2A Agents, Semantic Search and more.

Note

We migrated the GenAI-Eshop application to use the microsoft/agent-framework instead of Semantic Kernel in the mehdihadeli/genai-eshop repository. You can check their differences in a practical application there.

Note

🎥 See my talk at JetBrains .NET Day 2025, where I explain Generative AI and demonstrate this practical example.

Features

• ✅ Using microsoft/semantic-kernel for multi-agent orchestrations and AI related services
• ✅ Using Qdrant Semantic Kernel Connector for storing vector data for doing Semantic Meaning Search and Hybrid Search using vector data and semantic kernel
• ✅ Using Semantic Kernel EmbeddingGenerator based on chosen providers like Ollama, AzureOpenAI, and OpenAI for generating vector data for semantic search
• ✅ Using Semantic Kernel ChatCompletion based on chosen providers like Ollama, AzureOpenAI, and OpenAI for communicating with different models for generating responses
• ✅ Using Mcp tools based on http and json-rpc for calling endpoints in our Mcp server and calling third party tools by LLMs for Fine-grained functions
• ✅ Using Multi-Agent Orchestrations for local and external agents communication using agents parent child agent relationships and different Semantic Kernel’s Agent Orchestration Patterns like Parent-Child, GroupChat and Sequential orchestration
• ✅ Using Agent2Agent Protocol (A2A) protocol based on http and json-rpc for calling and using external agents
• ✅ Using Vertical Slice Architecture as a high-level architecture
• ✅ Using Minimal APIs for handling requests
• ✅ Using OpenTelemetry for collecting Logs, Metrics and Distributed Traces
• ✅ Using .NET Aspire for cloud-native application orchestration and enhanced developer experience

Architecture Diagram

Getting Started

Prerequisites

• .NET 9.0 SDK
• Docker
• Aspire CLI

Install an IDE

You can use any of the following IDEs for development:

• JetBrains Rider (Recommended)
• Visual Studio 2022
• Visual Studio Code

Ensure the IDE includes support for .NET Core and plugins for C#.

Run Application

Aspire

Install the Aspire CLI tool:

# Bash
dotnet tool install -g Aspire.Cli

To run the application using the Aspire App Host and using Aspire dashboard in the development mode run following command:

aspire run

Note:The Aspire dashboard will be available at: https://localhost:17056 and http://localhost:15234

Using Docker-Compose

# Start docker-compose
docker-compose -f .\deployments\docker-compose\docker-compose.yaml up -d

# Stop docker-compose
docker-compose -f .\deployments\docker-compose\docker-compose.yaml down

This command will run the required infrastructure for the application

Open the solution file genai-eshop-semantic-kernel.sln in your preferred IDE (e.g., Rider or Visual Studio).

Now you can run each microservice using the IDE.

License

The project is under MIT license.