SuperBlazorAIAgent.Abstractions 1.0.5

SuperAIAgent

SuperAIAgent is the GitHub repository for SuperBlazorAIAgent, a .NET 10 library for adding a configurable AI assistant to Blazor applications. It provides reusable services, workflows, models, and Blazor UI components so an application can offer contextual AI chat with provider/model selection, prompt workflows, conversation state, and optional browser-stored settings.

What this project does

SuperAIAgent helps Blazor applications embed an AI agent that can:

• display a ready-to-use chat experience inside a Blazor UI;
• let users select an AI provider and model;
• send prompts with application, user, page, and entity context;
• execute prompts locally in the host app or remotely through HTTP endpoints;
• keep conversation history separated by context;
• reset user sessions and cancel long-running operations;
• expose debug traces for prompt workflow analysis;
• persist provider settings in protected browser storage when enabled.

The repository also includes a Blazor demo application that shows how to register the services and render the agent components.

Repository: https://github.com/appliman/SuperAIAgent

Projects

Main features

Blazor components

The Blazor package includes components for common AI assistant scenarios:

• AIAgentChat for an embedded assistant conversation;
• AIProviderAndModelSelector for provider/model selection;
• AIAgentSettings and AIAgentSettingsEditor for configuration screens;
• ApiKeyInput for secure API key entry UX.

Local or remote execution

SuperBlazorAIAgent supports local execution inside the Blazor host application and can be extended for remote integration scenarios.

• Local: the Blazor application calls the agent service directly.

Provider configuration

The contracts include settings for common AI providers:

• OpenAI
• Anthropic
• Google
• xAI
• Azure OpenAI
• Amazon
• DeepSeek
• Mistral
• Ollama
• LM Studio
• OpenRouter

API keys and provider settings are represented by SuperBlazorAIAgent.Configuration.AIAgentsApiSettings. Local endpoints such as Ollama and LM Studio can also be configured.

Requirements

• .NET 10 SDK
• Visual Studio 2026 or another IDE/editor with .NET 10 support
• A configured API key or local model endpoint for the selected provider

Getting started

Register the core services

builder.Services.AddAIAgent(options =>
{
	options.AppName = "My Blazor App";
	options.AppUrl = "https://my-blazor-app.example.com";
});

AppUrl is used as the OpenRouter HTTP-Referer attribution URL. OpenRouter requires a URL for app attribution; AppName is sent as the display title.

Render the agent in a Blazor page

@using SuperBlazorAIAgent.Components
@using SuperBlazorAIAgent.Models

<AIProviderAndModelSelector />
<AIAgentChat UserContext="userContext" />

@code {
	private readonly AIAgentUserContext userContext = new(
		Guid.NewGuid(),
		"Demo User",
		"demo@example.com");
}

Running the demo

From the solution root:

dotnet run --project src/BlazorDemoApp/BlazorDemoApp.csproj

Open the displayed local URL, select/configure an AI provider, choose a model, and start chatting with the assistant.

Building the solution

dotnet build SuperAIAgent.slnx

Security notes

• Do not commit API keys or secrets to source control.
• Prefer user secrets, environment variables, a secure vault, or protected browser storage depending on the hosting model.
• Validate remote endpoint access before exposing the AI agent API publicly.

Repository status

This repository hosts the SuperBlazorAIAgent package for Blazor applications. It is designed as a reusable foundation for adding AI-powered assistance to business applications.

French documentation

The French version is available in README_fr.md.