> ## Documentation Index
> Fetch the complete documentation index at: https://docs.quickblox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Manage Assistants

> Learn how to manage SmartChat Assistants

## View SmartChat Assistants

To view a list of SmartChat Assistants, follow the steps below:

1. Navigate to the ***Dashboard => YOUR\_APP => SmartChat Assistant*** page.

<Frame>
  <img src="https://mintcdn.com/quickblox/o2RjBAwC-KBPW1oJ/images/smartchat-assistant-view-assistants.png?fit=max&auto=format&n=o2RjBAwC-KBPW1oJ&q=85&s=78e4fd3aed59f3c577d8726705e02628" alt="View assistants" width="3268" height="1912" data-path="images/smartchat-assistant-view-assistants.png" />
</Frame>

## Create SmartChat Assistant

To create a SmartChat Assistant follow the steps below::

1. Navigate to the ***Dashboard => YOUR\_APP => SmartChat Assistant*** page.
2. Click the **Create** button.
3. Fill in all necessary data
4. Click the **Create** button

<Frame>
  <img src="https://mintcdn.com/quickblox/o2RjBAwC-KBPW1oJ/images/smartchat-assistant-create-assistant.png?fit=max&auto=format&n=o2RjBAwC-KBPW1oJ&q=85&s=a6e734e4e12580896fa5c5ecc8cf019f" alt="Create SmartChat assistant" width="3268" height="1914" data-path="images/smartchat-assistant-create-assistant.png" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/quickblox/o2RjBAwC-KBPW1oJ/images/smart-chat-assistant-create-assistant-2.png?fit=max&auto=format&n=o2RjBAwC-KBPW1oJ&q=85&s=a97bd10ee041457fc49aad52ec40a709" alt="Create SmartChat assistant 2" width="3262" height="2114" data-path="images/smart-chat-assistant-create-assistant-2.png" />
</Frame>

Let's take a look at the fields and options that we need to fill and/or configure.

### Name

This will be the name of your SmartChat Assistant and the name of the user associated with it.

### Username

This should be a unique alphanumeric string without spaces. It will be used as a login for the user associated with the SmartChat Assistant and **can't be changed later**.

### Avatar

Here you can upload an image that will be set as the avatar for the user associated with the SmartChat Assistant

### Enable assistant in chat

Defines if Assistant is enabled for a particular type of dialog. If Assistant is disabled - it still can be added into dialog, but won’t be answering.

### Command

The SmartChat Assistant command is a **unique** special single word that triggers SmartChat Assistant in group dialog. When users send a message that starts `/command`, they can talk to the Assistant in these dialogs(make sure that the user associated with the SmartChat Assistant is in the chat too).

### Use knowledge base

Enable this option to allow the SmartChat Assistant to access and utilize the knowledge base for providing information and answers. This enhances the SmartChat Assistant's ability to respond with relevant and accurate content.

### Forward unanswered questions

Choose an action for when the Assistant encounters a question it cannot answer. Options include: sending a default 'don't know' response, forwarding the question to OpenAI for more advanced processing, or triggering a user-defined webhook for custom handling.

**None**

If this option is chosen then if SmartChat Assistant can't find the answer in the Knowledge base it will return a message from **“I don’t know the answer” message** field. The message will also contain an additional field
to confirm an answer wasn't found as well as 3 suggested questions the user can retry (these have a very high likelihood of being answered correctly).

**OpenAI**

If forwarding to OpenAI is chosen then if SmartChat Assistant can't find the answer in the Knowledge base it will forward the initial message to OpenAI, so the user will get an answer from it.

**Webhook**

Unanswered questions will be forwarded to the user-defined webhook.

Note! SmartChat Assistant **won't send any message** back to the chat! The developer should implement his/her own business logic to handle webhooks and perform any actions.

**Human handover**

In group dialogs and in widget, if the SmartChat Assistant doesn't know the answer, the conversation will be forwarded to a human agent.

<Note>
  Note! To test this feature, use the widget or SDKs. In the dashboard playground, you will only receive the "Don't know" message.
</Note>

### System message

**OpenAI**

Here you can enter a message that shapes the identity and guides the behavior of the Assistant in case if knowledge base is disabled or the message is forwarded to OpenAI. This message should reflect the Assistant's character and provide general instructions on how it will interact with users.

**Knowledge base**

<Warning>
  This message is pre-set for optimal interaction with the knowledge base. Please do not alter it to ensure consistent and effective use of the knowledge base resources, unless you are certain about the changes you are making.
</Warning>

## Update SmartChat Assistant

To update SmartChat Assistant follow the steps below:

1. Navigate to the ***Dashboard => YOUR\_APP => SmartChat Assistant*** page.
2. Choose the ID of the SmartChat Assistant you want to update and click on it.
3. Edit the SmartChat Assistant settings.
4. Click the Save button to save changes.

<Frame>
  <img src="https://mintcdn.com/quickblox/o2RjBAwC-KBPW1oJ/images/smart-chat-assistant-edit-assistant.png?fit=max&auto=format&n=o2RjBAwC-KBPW1oJ&q=85&s=5ec26828c5eef071fbd7bf8eb1a42ffa" alt="Edit SmartChat Assistant" width="3264" height="1910" data-path="images/smart-chat-assistant-edit-assistant.png" />
</Frame>

## Delete SmartChat Assistant

To delete SmartChat Assistant follow the steps below:

1. Navigate to the ***Dashboard => YOUR\_APP => SmartChat Assistant*** page.
2. Check the SmartChat Assistant you need to delete.
3. Click the Remove selected.

<Frame>
  <img src="https://mintcdn.com/quickblox/4gw4x-2IrfN_sgat/images/3bb14e0-Screenshot_2023-12-06_at_15.25.18.png?fit=max&auto=format&n=4gw4x-2IrfN_sgat&q=85&s=cc77aea190abe8930379877454cee13d" alt="" width="2212" height="896" data-path="images/3bb14e0-Screenshot_2023-12-06_at_15.25.18.png" />
</Frame>

## Test SmartChat Assistant

To test your SmartChat Assistant follow the steps below:

1. Navigate to the ***Dashboard => YOUR\_APP => SmartChat Assistant*** page.
2. On the right side you will see a dialog window where you can interact with your SmartChat Assistant

<img src="https://mintcdn.com/quickblox/tw9NMPEfMkW_LAuD/images/c6b89d4-Screenshot_2023-12-14_at_13.39.35.png?fit=max&auto=format&n=tw9NMPEfMkW_LAuD&q=85&s=0c99fe23b8b7ad25e82f4caa00f520a0" className="centered-image" style={{ height:"500px",width:"400px" }} width="1082" height="1310" data-path="images/c6b89d4-Screenshot_2023-12-14_at_13.39.35.png" />
