AgentBlazor Docs

Troubleshooting

Check the runtime path before guessing.

Most failures reduce to wiring, assets, route scoping, or host-shape rules.

First commands to run

agentblazor doctor ./MySolution.slnx --host MyBlazorApp
agentblazor validate ./MySolution.slnx --host MyBlazorApp
agentblazor scaffold ./MySolution.slnx --host MyBlazorApp --provider openai --diff
dotnet build ./MySolution.slnx --no-restore -nologo

UI renders but nothing responds

  • Confirm AddMudServices().
  • Confirm AddAgentBlazor(...) before builder.Build().
  • Confirm app.MapAgentBlazorEndpoints().
  • Confirm MudBlazor and AgentBlazor assets are loaded.
  • Confirm the layout includes Mud providers.

Actions do not appear

  • Check [AgentCapability(...)].
  • Check [AgentAction(...)].
  • Check AddWorkflow<T>().
  • Check WithRoutePrefixes(...) matches the route.

Hosted WebAssembly remote chat issues

  • Confirm app.MapAgentBlazorRemoteChat() on the server.
  • Confirm the client uses AgentBlazor.Client.
  • Confirm the client registers HttpClient with the host base address.
  • Confirm the endpoint is usually /agentblazor/chat/run.
An unhandled error has occurred. Reload 🗙

Rejoining the server...

Rejoin failed... trying again in seconds.

Failed to rejoin.
Please retry or reload the page.

The session has been paused by the server.

Failed to resume the session.
Please retry or reload the page.