Overview

Welcome to SmartChat Assistant! This AI-powered chat companion not only chats with your users but also learns from uploaded content like files and web pages. Here's what makes SmartChat Assistant special:

• Enhanced Knowledge Base: SmartChat Assistant can use information from a variety of sources, including files and web pages you upload. This feature allows it to provide more accurate and relevant responses.
• Seamless User Interaction: Linked directly to a QuickBlox user, the Assistant can participate in both private and group chats, offering a personalized experience to each user.
• Tailored Chat Engagement: With the SmartChat Assistant, you have the flexibility to choose its operational environments. Whether you want the Assistant active in private chats, group chats, or both, you're in control.
• Flexible Behavior and Identity: Shape the Assistant's identity and guide its behavior to fit your app's tone and user needs. From casual to formal, it can adapt to the vibe you want.
• Advanced Options for Unanswered Queries: Decide how the Assistant should react when it encounters a question it doesn't know. You can set it to respond with a default message, consult OpenAI for a more advanced answer, or use a custom webhook for unique handling.

Let's get you started on how to create, manage, and personalize your chat assistant for an engaging user experience.

View SmartChat Assistants

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

1. Navigate to the Dashboard => YOUR_APP => SmartChat Assistant page.

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

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

If the SmartChat Assistant doesn't know the answer, the conversation will be forwarded to a human agent.

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

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

🚧

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.

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.

Manage knowledge base content

In this section, you can upload files or webpages that will be used as a knowledge base source by your SmartChat Assistant.

📘

You can upload .docx, .txt, and .pdf files with a max size of up to 25MB

📘

Please note that when you add a web page you are adding this particular web page and not the whole website.

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.

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