# Blazor PromptBox Overview

The <a href="https://www.telerik.com/blazor-ui/promptbox" target="_blank">Blazor PromptBox component</a> facilitates human-AI communication with a feature-rich input interface. It combines text input, speech-to-text functionality, file attachments, and intelligent layout adaptation to provide a comprehensive user experience for AI workflows.

The component also offers advanced functionality like automatic mode switching, integrated action buttons, and customizable adornments.

## Basic Usage

1. Add the `<TelerikPromptBox>` tag to a Razor file.
2. Set the `Value` parameter to a `string` object. It supports one-way and two-way binding.
3. (optional) Set the `Mode` parameter to control input behavior: `SingleLine`, `MultiLine`, or `Auto` (default).
4. (optional) Configure built-in features like `EnableSpeechToText` and `EnableFileSelect`.
5. (optional) Handle the `OnPromptAction` event to respond to user submissions.

> caption Basic PromptBox with auto-expanding mode

<demo metaUrl="client/promptbox/overview/example-1/" height="320"></demo>

## Input Modes

The component supports three input modes that adapt to different use cases. [Read more about PromptBox modes...](https://www.telerik.com/blazor-ui/documentation/components/promptbox/modes).

## File Attachments

Users can attach files directly through the integrated file selection button. [Read more about PromptBox file attachments...](https://www.telerik.com/blazor-ui/documentation/components/promptbox/attachments).

## Adornments

The PromptBox supports customizable adornments that adapt to the current input mode. You can add custom buttons, icons, or components as prefixes, suffixes, or top-level elements. [Read more about PromptBox adornments...](https://www.telerik.com/blazor-ui/documentation/components/promptbox/adornments).

## Events

The PromptBox fires events to respond to user interactions and state changes. [Read more about PromptBox events...](https://www.telerik.com/blazor-ui/documentation/components/promptbox/events).

## PromptBox API

To review all available parameters for the PromptBox component, see the [PromptBox API Reference](https://docs.telerik.com/blazor-ui/api/Telerik.Blazor.Components.TelerikPromptBox#parameters).

## Next Steps

* [Configure File Attachments](https://www.telerik.com/blazor-ui/documentation/components/promptbox/attachments)
* [Customize Adornments](https://www.telerik.com/blazor-ui/documentation/components/promptbox/adornments)
* [Explore PromptBox Modes](https://www.telerik.com/blazor-ui/documentation/components/promptbox/modes)
* [Handle Events](https://www.telerik.com/blazor-ui/documentation/components/promptbox/events)