Questa pagina non è ancora tradotta in italiano: qui la trovi in inglese.

ReferencePackages: Novior.MentorAgent, Novior.MentorAgent.Server, Novior.MentorAgent.Blazor, Novior.MentorAgent.Abstractions, Novior.MentorAgent.Declarative

Choose your packages

Which MentorAgent package to install for Blazor, MAUI, or a backend for React, Angular, Vue and mobile apps, and what each one contains.

On this page

Use this page to choose the MentorAgent packages for your kind of app. MentorAgent is published on NuGet as a family of five packages. They are released together with one version number, 1.2.0. Keep every MentorAgent package in a project on the same version.

The common case is a Blazor Web App with Server interactivity, which needs only one package, Novior.MentorAgent. The Quickstart builds such an app. The table shows when you need more.

Packages for each kind of app

Your app	Project that runs the agent	Client project
Blazor Web App with Server interactivity	`Novior.MentorAgent`	None
Blazor Web App with Auto interactivity set per page or component, where the chat widget runs on the server	`Novior.MentorAgent`	None
Blazor Web App with WebAssembly or Auto interactivity, where the chat widget runs in the browser	`Novior.MentorAgent.Server`	`Novior.MentorAgent.Blazor`
Blazor WebAssembly standalone	`Novior.MentorAgent.Server`, in the API backend	`Novior.MentorAgent.Blazor`
.NET MAUI Blazor Hybrid, built for Android and Windows	`Novior.MentorAgent`, in the MAUI app	None
.NET MAUI app that uses an agent on a server you host	`Novior.MentorAgent.Server`, on that server	A SignalR client
React, Angular, Vue or any other JavaScript front end, a native mobile or desktop app, or a script	`Novior.MentorAgent.Server`, in your ASP.NET Core backend	Nothing from MentorAgent: a SignalR client for your platform, or plain HTTP for Server-Sent Events
Model Context Protocol (MCP) server or Agent-to-Agent (A2A) agent for other AI clients	`Novior.MentorAgent.Server`	None

In a Blazor Web App you choose where the widget runs: on the server (as in Blazor Server) or in the browser (as in WebAssembly). See Blazor WebAssembly and Auto. For a front end other than Blazor, see Any front end.

The agent always runs in the project that calls AddMentorAgent(). In a WebAssembly client project you install Novior.MentorAgent.Blazor and never call AddMentorAgent(): the model, the keys and your actions stay on the server.

Channels explains how each client reaches the agent, and the Configure pages give the setup for each one.

The packages

Package	What it contains	When you install it
`Novior.MentorAgent`	The core. It finds your actions, agents, teams and pages, and it runs the coordinator, which is built on Agent Framework. It runs the role checks and the confirmation, and it includes the MCP and A2A clients. It also holds the services behind the chat widget in Blazor Server and Blazor Hybrid	In the app that runs the agent. In a Blazor Server or Blazor Hybrid app, it is the only MentorAgent package you need. If the chat runs outside the server, or the app publishes the MCP server or the A2A agent, install `Novior.MentorAgent.Server` instead: it brings `Novior.MentorAgent` with it
`Novior.MentorAgent.Server`	The SignalR hub (`/mentor-hub`), the Server-Sent Events endpoint (`/mentor/chat`) and the HTTP endpoints for confirmation, stop, session, tour and metrics (`/mentor/approve`, `/mentor/cancel` and others). It also holds the MCP server (`/mcp`) and the A2A agent (`/a2a`). It brings `Novior.MentorAgent` with it	In the ASP.NET Core project that serves a chat running outside the server (Blazor WebAssembly, a JavaScript front end or a mobile app). Also in any ASP.NET Core project that publishes the MCP server or the A2A agent
`Novior.MentorAgent.Blazor`	The WebAssembly client: the services that connect the same `<ChatWidget />` to the hub over SignalR	In the client project of a Blazor WebAssembly or Auto app
`Novior.MentorAgent.Abstractions`	The contracts, models and Razor components shared by the server and the browser, including `<ChatWidget />`	Never directly: it comes with `Novior.MentorAgent` and `Novior.MentorAgent.Blazor`
`Novior.MentorAgent.Declarative`	Specialist agents defined in YAML files instead of C# classes	Only if you want YAML agents, next to `Novior.MentorAgent` or `Novior.MentorAgent.Server`

Every package also contains its README, the license files (LICENSE, NOTICE and THIRD-PARTY-NOTICES.md), the XML documentation that IntelliSense shows, and CHANGELOG.md with the history of every version. NOTICE holds the copyright notice and the trademark notice.

Every package also carries its software bill of materials (SBOM): an SPDX 2.2 document at _manifest/spdx_2.2/manifest.spdx.json, with its SHA-256 next to it. It lists the files of the package and the packages restored to build it.

The release notes of a version on NuGet are its section of CHANGELOG.md. The release notes of the documentation tell the story of each stable version.

Install

The common case is a Blazor Web App with Server interactivity, which needs only Novior.MentorAgent:

.NET CLI

Terminal

dotnet add package Novior.MentorAgent

PackageReference

YourApp.csproj

<ItemGroup>
  <PackageReference Include="Novior.MentorAgent" Version="1.2.0" />
</ItemGroup>

Central Package Management

Directory.Packages.props

<ItemGroup>
  <PackageVersion Include="Novior.MentorAgent" Version="1.2.0" />
</ItemGroup>

YourApp.csproj

<ItemGroup>
  <PackageReference Include="Novior.MentorAgent" />
</ItemGroup>

File-based app

app.cs

#:package Novior.MentorAgent@1.2.0

The other packages install the same way. For example, on a backend:

Terminal

dotnet add package Novior.MentorAgent.Server

Add the package of your model provider too: see What comes with MentorAgent.

What comes with MentorAgent

Novior.MentorAgent includes Agent Framework, Microsoft.Extensions.AI and the clients for MCP and A2A. You do not add them yourself. Novior.MentorAgent.Server also includes the packages for the MCP server and the A2A agent.

Novior.MentorAgent does not include a model provider package. Add the package of the provider you use. For OpenAI it is Microsoft.Extensions.AI.OpenAI. Azure OpenAI also needs Azure.AI.OpenAI. For the versions, see Provider package versions.

The Foundry package of Agent Framework is not included either. Add it yourself only if you use a Foundry project: see If you use Foundry.

Novior.MentorAgent.Abstractions is a separate package because the browser cannot load the server's dependencies. It contains only code that runs in WebAssembly: the widget and the types that the server and the browser share.

Vedi anche

Prerequisites — The versions of .NET, hosts, Agent Framework, and model provider packages that MentorAgent is tested with, and how to install it.
Canali: come i client arrivano all'agente — Scegli come i client raggiungono il tuo agente: il widget della chat, SignalR o HTTP dal tuo front end, o un protocollo per altri agenti e strumenti AI.