# Getting Started with the KendoReact AIPrompt

This guide provides essential information about using the KendoReact AIPrompt component. You will learn how to install the Conversational UI package that provides the AIPrompt. Then, you will add a AIPrompt component to your project, style the component, and activate your license.

<div data-component="StartKendoReactFreeSection"></div>

After completing this guide, you will be able to reproduce the following example.

[Demo Source](https://demos.telerik.com/kendo-react-ui/conversational-ui/ai-prompt/get-started/func/source.txt)

## Setting Up Your React Project

Before you install the KendoReact Conversational UI package, which contains the AIPrompt component, make sure that you have a running React project. The easiest way to set up a KendoReact project is to use the approach described in [Get Started with KendoReact](https://www.telerik.com/kendo-react-ui/components/getting-started).

## Installing the Conversational UI Package

All KendoReact packages are distributed through npm and offer a similar installation experience. To use the AIPrompt component, start with the installation of the Conversational UI npm package and its [dependencies](https://www.telerik.com/kendo-react-ui/components/conversationalui/ai-prompt/get-started#dependencies). Use NodeJS LTS or a version >= 14.

```sh
npm i @progress/kendo-react-conversational-ui
```

## Importing the Component

After installing the package, import the AIPrompt component in the React App.

In the `src/App.tsx` file of your React project, import the `AIPrompt`, `AIPromptView`, `AIPromptCommandsView` and `AIPromptOutputView` from the Conversational UI package.

```jsx
// ES2015 module syntax
import { AIPrompt, AIPromptView,  AIPromptOutputView, AIPromptCommandsView} from '@progress/kendo-react-conversational-ui';
```

## Using the Component

1. Define the `AIPrompt` component and add the [`AIPromptView`](https://www.telerik.com/kendo-react-ui/components/conversationalui/api/aipromptview) and [`AIPromptOutputView`](https://www.telerik.com/kendo-react-ui/components/conversationalui/api/aipromptoutputview)

   ```jsx
     <AIPrompt>
        <AIPromptView/>
        <AIPromptOutputView>
        <AIPromptCommandsView/>
     </AIPrompt>
   ```

2. Next, define the [`activeView`](https://www.telerik.com/kendo-react-ui/components/conversationalui/api/aipromptprops#activeView), handle the [`onActiveViewChange`](https://www.telerik.com/kendo-react-ui/components/conversationalui/api/aipromptprops#onActiveViewChange), [`onPromptRequest`](https://www.telerik.com/kendo-react-ui/components/conversationalui/api/aipromptprops#onPromptRequest) which is triggered when the user clicks the `Generate` button in the Prompt view and the [`onCommandExecute`](https://www.telerik.com/kendo-react-ui/components/conversationalui/api/aipromptprops#onCommandExecute) when the `Command` view is clicked. Finally pass `promptViewDefaults`, `outputViewDefaults`, `commandsViewDefaults` to the [`toolbarItems`](https://www.telerik.com/kendo-react-ui/components/conversationalui/api/aipromptprops#toolbarItems) prop.

   ```jsx
     <AIPrompt
        style={{ width: '400px', height: '400px' }}
        activeView={activeView}
        onActiveViewChange={handleActiveViewChange}
        onPromptRequest={handleOnRequest}
        onCommandExecute={handleCommandExecute}
        toolbarItems={[promptViewDefaults, outputViewDefaults, commandsViewDefaults]}
     >
        <AIPromptView promptSuggestions={suggestionsList} />
        <AIPromptOutputView outputs={outputs} showOutputRating={true} />
        <AIPromptCommandsView commands={promptCommands} />
     </AIPrompt>
   ```

3. To style the AIPrompt, install and import the [Meridian theme](https://www.telerik.com/design-system/docs/themes/kendo-themes/meridian/), which is one of the [themes](https://www.telerik.com/kendo-react-ui/components/styling) for KendoReact.

   3.1. Install the Meridian theme package.

   ```sh
   npm i @progress/kendo-theme-meridian
   ```

   3.2. Import the CSS file from the package in `src/App.tsx`. Add this import before your existing `App.css` import.

   ```jsx
   import '@progress/kendo-theme-meridian/dist/all.css';
   ```

## Activating Your License Key

Using any of the UI components in the KendoReact library requires either a commercial license key or an active trial license key.

Follow the instructions on the KendoReact [My License page](https://www.telerik.com/kendo-react-ui/components/my-license) to activate your trial or commercial license. You can skip this step if your application already contains a KendoReact license file.

## Dependencies

The Conversational UI package requires you to install the following [peer dependencies](https://nodejs.org/en/blog/npm/peer-dependencies/) in your application:

| Package Name                  | Description                                                                                                                                                                 |
| ----------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| react 18.0.0\*                | Contains the functionality necessary to define React components.                                                                                                            |
| react-dom                     | Contains the React renderer for the web.                                                                                                                                    |
| @progress/kendo-licensing     | Contains the internal infrastructure related to licensing.                                                                                                                  |
| @progress/kendo-react-buttons | Contains the KendoReact Buttons components.                                                                                                                                 |
| @progress/kendo-react-intl    | Contains the KendoReact Internationalization package that applies the desired cultures by providing services and pipes for the parsing and formatting of dates and numbers. |
| @progress/kendo-svg-icons     | Contains the KendoReact SVG icons.                                                                                                                                          |

## Suggested Links

* [Getting Started with the KendoReact Conversational UI Package](https://www.telerik.com/kendo-react-ui/components/conversationalui/get-started)
* [API Reference of the KendoReact AIPrompt](https://www.telerik.com/kendo-react-ui/components/conversationalui/api/aiprompt)
* [API Reference of the AIPromptProps](https://www.telerik.com/kendo-react-ui/components/conversationalui/api/aipromptprops)
