RadzenAIChat Class

RadzenAIChat component that provides a modern chat interface with AI integration and conversation memory.

Inheritance

Object

ComponentBase

RadzenComponent

RadzenAIChat

Implements

IComponent

IHandleEvent

IHandleAfterRender

Namespace: Radzen.Blazor

Assembly: Radzen.Blazor.dll

Syntax

public class RadzenAIChat : RadzenComponent, IComponent, IHandleEvent, IHandleAfterRender

Examples

<RadzenAIChat Title="AI Assistant" Placeholder="Type your message..." @bind-Messages="@chatMessages" SessionId="@sessionId" />

Constructors

RadzenAIChatLink to this section

RadzenAIChat component that provides a modern chat interface with AI integration and conversation memory.

Declaration
public RadzenAIChat()

Properties

ApiKeyLink to this section

Gets or sets the API key for authentication.

Declaration
public string ApiKey { get; set; }
Property Value
Type Description
stringGets or sets the API key for authentication.

ApiKeyHeaderLink to this section

Gets or sets the API key header name.

Declaration
public string ApiKeyHeader { get; set; }
Property Value
Type Description
stringGets or sets the API key header name.

AssistantAvatarTextLink to this section

Gets or sets the text displayed in the assistant avatar.

Declaration
public string AssistantAvatarText { get; set; }
Property Value
Type Description
stringGets or sets the text displayed in the assistant avatar.

ChatClearedLink to this section

Event callback that is invoked when the chat is cleared.

Declaration
public EventCallback ChatCleared { get; set; }
Property Value
Type Description
EventCallbackEvent callback that is invoked when the chat is cleared.

DateSeparatorFormatLink to this section

Gets or sets the format used to render the date separator. Defaults to "D" (long date pattern).

Declaration
public string DateSeparatorFormat { get; set; }
Property Value
Type Description
stringGets or sets the format used to render the date separator. Defaults to "D" (long date pattern).

DateSeparatorTemplateLink to this section

Optional template to render the date separator shown between messages when the day changes. Receives the DateTime of the following message.

Declaration
public RenderFragment<DateTime> DateSeparatorTemplate { get; set; }
Property Value
Type Description
RenderFragment<DateTime>Optional template to render the date separator shown between messages when the day changes. Receives the DateTime of the following message.

DisabledLink to this section

Gets or sets whether the chat is disabled.

Declaration
public bool Disabled { get; set; }
Property Value
Type Description
boolGets or sets whether the chat is disabled.

EmptyMessageLink to this section

Gets or sets the message displayed when there are no messages.

Declaration
public string EmptyMessage { get; set; }
Property Value
Type Description
stringGets or sets the message displayed when there are no messages.

EmptyTemplateLink to this section

Gets or sets the empty template shown when there are no messages.

Declaration
public RenderFragment EmptyTemplate { get; set; }
Property Value
Type Description
RenderFragmentGets or sets the empty template shown when there are no messages.

EndpointLink to this section

Gets or sets the endpoint URL for the AI service.

Declaration
public string Endpoint { get; set; }
Property Value
Type Description
stringGets or sets the endpoint URL for the AI service.

InputAttributesLink to this section

Specifies additional custom attributes that will be rendered by the input.

Declaration
public IReadOnlyDictionary<string, object> InputAttributes { get; set; }
Property Value
Type Description
IReadOnlyDictionary<string, object>Specifies additional custom attributes that will be rendered by the input.

MaxMessagesLink to this section

Gets or sets the maximum number of messages to keep in the chat.

Declaration
public int MaxMessages { get; set; }
Property Value
Type Description
intGets or sets the maximum number of messages to keep in the chat.

MaxTokensLink to this section

Gets or sets the max tokens.

Declaration
public int? MaxTokens { get; set; }
Property Value
Type Description
int?Gets or sets the max tokens.

MessageAddedLink to this section

Event callback that is invoked when a new message is added.

Declaration
public EventCallback<ChatMessage> MessageAdded { get; set; }
Property Value
Type Description
EventCallback<ChatMessage>Event callback that is invoked when a new message is added.

MessageSentLink to this section

Event callback that is invoked when a message is sent.

Declaration
public EventCallback<string> MessageSent { get; set; }
Property Value
Type Description
EventCallback<string>Event callback that is invoked when a message is sent.

MessageTemplateLink to this section

Gets or sets the message template.

Declaration
public RenderFragment<ChatMessage> MessageTemplate { get; set; }
Property Value
Type Description
RenderFragment<ChatMessage>Gets or sets the message template.

ModelLink to this section

Gets or sets the model name.

Declaration
public string Model { get; set; }
Property Value
Type Description
stringGets or sets the model name.

PlaceholderLink to this section

Gets or sets the placeholder text for the input field.

Declaration
public string Placeholder { get; set; }
Property Value
Type Description
stringGets or sets the placeholder text for the input field.

ProxyLink to this section

Gets or sets the proxy URL for the AI service.

Declaration
public string Proxy { get; set; }
Property Value
Type Description
stringGets or sets the proxy URL for the AI service.

ReadOnlyLink to this section

Gets or sets whether the input is read-only.

Declaration
public bool ReadOnly { get; set; }
Property Value
Type Description
boolGets or sets whether the input is read-only.

ResponseReceivedLink to this section

Event callback that is invoked when the AI response is received.

Declaration
public EventCallback<string> ResponseReceived { get; set; }
Property Value
Type Description
EventCallback<string>Event callback that is invoked when the AI response is received.

SessionIdLink to this section

Gets or sets the session ID for maintaining conversation memory. If null, a new session will be created.

Declaration
public string SessionId { get; set; }
Property Value
Type Description
stringGets or sets the session ID for maintaining conversation memory. If null, a new session will be created.

SessionIdChangedLink to this section

Event callback that is invoked when a session ID is created or retrieved.

Declaration
public EventCallback<string> SessionIdChanged { get; set; }
Property Value
Type Description
EventCallback<string>Event callback that is invoked when a session ID is created or retrieved.

ShowClearButtonLink to this section

Gets or sets whether to show the clear chat button.

Declaration
public bool ShowClearButton { get; set; }
Property Value
Type Description
boolGets or sets whether to show the clear chat button.

ShowDateSeparatorLink to this section

Gets or sets whether a date separator is rendered between messages when the day changes.

Declaration
public bool ShowDateSeparator { get; set; }
Property Value
Type Description
boolGets or sets whether a date separator is rendered between messages when the day changes.

SystemPromptLink to this section

Gets or sets the system prompt.

Declaration
public string SystemPrompt { get; set; }
Property Value
Type Description
stringGets or sets the system prompt.

TemperatureLink to this section

Gets or sets the temperature.

Declaration
public double? Temperature { get; set; }
Property Value
Type Description
double?Gets or sets the temperature.

TimestampFormatLink to this section

Gets or sets the format used to render the timestamp shown next to each message. Defaults to "HH:mm".

Declaration
public string TimestampFormat { get; set; }
Property Value
Type Description
stringGets or sets the format used to render the timestamp shown next to each message. Defaults to "HH:mm".

TitleLink to this section

Gets or sets the title displayed in the chat header.

Declaration
public string Title { get; set; }
Property Value
Type Description
stringGets or sets the title displayed in the chat header.

UserAvatarTextLink to this section

Gets or sets the text displayed in the user avatar.

Declaration
public string UserAvatarText { get; set; }
Property Value
Type Description
stringGets or sets the text displayed in the user avatar.

Methods

AddMessageLink to this section

Adds a message to the chat.

Declaration
public ChatMessage AddMessage(string content, bool isUser)
Parameters
Type Name Description
string content The message content.
bool isUser Whether the message is from the user.
Returns
Type Description
ChatMessageThe created message.

BuildRenderTreeLink to this section

Declaration
protected override void BuildRenderTree(Rendering.RenderTreeBuilder __builder)
Parameters
Type Name Description
Rendering.RenderTreeBuilder __builder

ClearChatLink to this section

Clears all messages from the chat.

Declaration
public Task ClearChat()
Returns
Type Description
Task

DisposeLink to this section

Declaration
public override void Dispose()

GetComponentCssClassLink to this section

Declaration
protected override string GetComponentCssClass()
Returns
Type Description
string

GetMessagesLink to this section

Gets the current list of messages.

Declaration
public IReadOnlyList<ChatMessage> GetMessages()
Returns
Type Description
IReadOnlyList<ChatMessage>

GetSessionIdLink to this section

Gets the current session ID.

Declaration
public string GetSessionId()
Returns
Type Description
string

LoadConversationHistoryLink to this section

Loads conversation history from the AI service session.

Declaration
public Task LoadConversationHistory()
Returns
Type Description
Task

LoadMessagesLink to this section

Loads messages into the chat, replacing any existing ones. Preserves the timestamp of each message — use this to restore conversation history.

Declaration
public Task LoadMessages(IEnumerable<ChatMessage> messages)
Parameters
Type Name Description
IEnumerable<ChatMessage> messages The messages to load.
Returns
Type Description
Task

OnAfterRenderAsyncLink to this section

Declaration
protected override Task OnAfterRenderAsync(bool firstRender)
Parameters
Type Name Description
bool firstRender
Returns
Type Description
Task

OnInitializedAsyncLink to this section

Declaration
protected override Task OnInitializedAsync()
Returns
Type Description
Task

OnParametersSetAsyncLink to this section

Declaration
protected override Task OnParametersSetAsync()
Returns
Type Description
Task

SendMessageLink to this section

Sends a message programmatically.

Declaration
public Task SendMessage(string content)
Parameters
Type Name Description
string content The message content to send.
Returns
Type Description
Task

SendMessageLink to this section

Sends a message programmatically.

Declaration
public Task SendMessage(string content, string model, string systemPrompt, double? temperature, int? maxTokens, string endpoint, string proxy, string apiKey, string apiKeyHeader)
Parameters
Type Name Description
string content The message content to send.
string model
string systemPrompt
double? temperature
int? maxTokens
string endpoint
string proxy
string apiKey
string apiKeyHeader
Returns
Type Description
Task
An error has occurred. This app may no longer respond until reloaded. Reload 🗙