Samples

Complete MentorAgent projects that you can download and run. Each one lists its channel and its packages.

On this page

The samples are complete projects under the MIT license. Download one, add your model key and run it. They reference MentorAgent 1.2.0, the version this documentation describes.

Quickstart: Cases

Cases is the app you build in the Quickstart: a Blazor Server app for support cases. Its agent reads the status of a case whenever it needs to, and adds a note to a case only after you confirm.

Download: mentoragent-quickstart.zip
Channel: Blazor Server, with every page interactive
Packages: Novior.MentorAgent and Microsoft.Extensions.AI.OpenAI
What it shows: an action the agent calls freely, an action it runs only after you confirm, the model connection and the chat widget
What you need: the .NET 10 SDK and an OpenAI API key

The zip holds a Cases folder with Program.cs, CaseService.cs, the Blazor components, a README.md and the license. Unzip it and open a terminal in the Cases folder. In the second command, replace <your-key> with your OpenAI API key:

Terminal

dotnet user-secrets init
dotnet user-secrets set OpenAI:Key <your-key>
dotnet run

Open the address shown in the terminal, click the widget button and type "Add a note to case C-1: documents received". The agent asks you to confirm before it adds the note. To use Azure OpenAI or a local model instead, see Model providers.

MCP server: Cases for MCP clients

Cases MCP server publishes the same case actions as tools for MCP clients, such as VS Code or Claude Desktop. The client's own model decides which tool to call, so you need no model key to try it.

Download: mentoragent-mcp-server.zip
Channel: MCP server, on plain ASP.NET Core with no pages
Packages: Novior.MentorAgent, Novior.MentorAgent.Server and Anthropic
What it shows: a read that MCP clients can call, a write that the server withholds because it asks for confirmation, and Claude as the app's model
What you need: the .NET 10 SDK, and an MCP client such as VS Code or Claude Desktop

The zip holds a CasesMcp folder with Program.cs, CaseService.cs, a README.md and the license. Unzip it, open a terminal in the CasesMcp folder and run the app:

Terminal

dotnet run

The MCP endpoint is http://localhost:5000/mcp. Connect VS Code or Claude Desktop to it: the client lists one tool, get_case_status. Ask "What is the status of case C-1?" and the client's model calls the tool. AddNote is not in the list: it asks for confirmation, and an MCP request has nobody to answer.

The app sets Claude as its model because MentorAgent needs one to start, but an MCP call never reaches it. You need an Anthropic key only when you add a chat to the app: see Anthropic Claude.

Tutorial

The tutorial extends the same Cases app in four steps: actions, roles and confirmation, a specialist agent, and a team. Each step shows its code on the page. The finished code of each step is not available as a download yet.

Vedi anche

Avvio rapido — Crea un'app Blazor, trasforma un metodo in un'azione con conferma, collega un modello e aggiungi il widget della chat in circa quindici minuti.
1. Turn service methods into actions — Tutorial step 1: expose the methods of a case service as actions the agent can call, with descriptions the model understands.