👁 Image
AgentBlazor 0.2.22

AgentBlazor

Add an agent chat surface and deterministic app actions to a Blazor app.

Hosted demo:

• https://demo.agentblazor.com/demo/workflows/support-inbox

Install:

dotnet add package AgentBlazor

If you prefer a pinned install, use:

dotnet add package AgentBlazor --version 0.2.5

Use 0.2.5 or later. This release includes the CLI Windows MSBuild fallback and first-run API-key prompt, CLI v1 analyze package refresh, mobile chat input stability fix, corrected EF package shape, and tool-friendly schemas for date-like workflow parameters.

If dotnet still probes an old custom package source on your machine, remove or disable that source before testing the public NuGet install path.

Minimal setup:

using AgentBlazor;
using MudBlazor.Services;

builder.Services.AddMudServices();

builder.Services.AddAgentBlazor(options =>
{
 options.UseOpenAI(
 apiKey: builder.Configuration["OpenAI:ApiKey"]!,
 model: builder.Configuration["OpenAI:Model"]!);

 options.ConfigureBuilder(agentBuilder =>
 {
 agentBuilder.AddWorkflow<SupportInboxCapabilities>("support-inbox", agent =>
 {
 agent.WithRoutePrefixes("/support");
 });
 });
});

var app = builder.Build();

app.MapRazorComponents<App>()
 .AddInteractiveServerRenderMode();
app.MapAgentBlazorEndpoints();

AddAgentBlazor(...) alone does not create a responding agent. Register at least one workflow or agent inside options.ConfigureBuilder(...).

Mount AgentBlazorShell in an interactive layout or page. It wraps the AgentBlazor providers and includes the floating chat widget.

[AgentCapability("support_inbox")]
public sealed class SupportInboxCapabilities
{
 [AgentAction("Show open tickets that still need a reply")]
 public Task<CapabilityResult> ShowOpenTicketsAsync(int days = 7)
 => Task.FromResult(
 CapabilityResult.Success($"Highlighted tickets from the last {days} days."));

 [AgentAction("Draft a reply for the highlighted tickets", RequiresApproval = true)]
 public Task<CapabilityResult> DraftReplyAsync()
 => Task.FromResult(
 CapabilityResult.Success("Prepared the reply draft.")
 .WithNextActions("Review the reply", "Approve the draft"));
}

@using AgentBlazor
@using AgentBlazor.Components

<AgentBlazorShell>
 @Body
</AgentBlazorShell>

Docs and demo:

• Repository: https://github.com/ashpeterson/AgentBlazor
• Hosted demo: https://demo.agentblazor.com/demo/workflows/support-inbox
• Structured error reference: https://demo.agentblazor.com/demo/workflows/runtime-probe
• Quickstart: https://github.com/ashpeterson/AgentBlazor/blob/master/docs/quickstart.md
• 0.2.5 release notes: https://github.com/ashpeterson/AgentBlazor/blob/master/docs/releases/0.2.5.md
• 0.2.3 release notes: https://github.com/ashpeterson/AgentBlazor/blob/master/docs/releases/0.2.3.md
• 0.2.2 release notes: https://github.com/ashpeterson/AgentBlazor/blob/master/docs/releases/0.2.2.md
• 0.2.1 release notes: https://github.com/ashpeterson/AgentBlazor/blob/master/docs/releases/0.2.1.md
• 0.2.0 release notes: https://github.com/ashpeterson/AgentBlazor/blob/master/docs/releases/0.2.0.md
• Recoverable capability errors: https://github.com/ashpeterson/AgentBlazor/blob/master/docs/capability-errors.md
• Optional EF Core schema exposure: https://github.com/ashpeterson/AgentBlazor/blob/master/docs/entity-framework.md
• Starter sample: https://github.com/ashpeterson/AgentBlazor/tree/master/samples/AgentBlazor.Starter