Documentation
Guide
Projects

Projects

A project is a place where you add data sources of the same topics. For example, you may have a separate project for your project, a website, or a group of websites.

Add a new project

To add a new project, click the My projects menu item on the left menu bar, then click the All projects link and the Add a project button.

image

In the showing popup enter the name and description (optional), then click the OK button:

image

You will be redirected to the project's page with an empty list of data sources.

Add a data source

As soon as a project is created you may add the data source. A data source is a piece of information to be indexed and searched by our engine. Read more on the data source documentation page (opens in a new tab).

Click the "Add a new source" button and then select the corresponding type of data sources:

image

💡

At the moment, you can add data sources of 3 types: PDF file, plain text, or a web site.

Project's settings

After a project is created you may edit some of its properties. For a given project, click the Settings link:

image

General tab

Here you can change the project's name and its description. The description is used when the project is shown on the Project list:

image

AI Settings

The second tab has the AI tuning settings.

image

Let's review all the settings

ChatGPT Engine and OpenAI Model

Here you can select what to use for the generating responses: the OpenAI assistant, a new technology that allows you to upload your own data right in the OpenAI dashboard (opens in a new tab), or a regular OpenAI chat model. If you use the second option, you can then select a model (the default model is ChatGPT-3.5-Turbo). The GPT-4 and GPT-4 Turbo are available.

💡

Please note that these options are available only for the "Key" plan. The reason is that ChatGPT assistant and ChatGPT-4 models are still very expensive, so you use them at your own risk.

💡

Don't forget to enter the OpenAI key which is available in the account's settings (can be found at the bottom of the left menu).

💡

If you choose to use the OpenAI Assistant, the following settings will not be available as you change all the parameters right in the OpenAI Assistant dashboard.

Custom prompt

This section has 2 options:

  • the text of your custom prompt
  • the switch to replace the default prompt (that one we use by default) with your prompt.
💡

Our default prompt is not only a piece of text but it's a combination of logic, code, and text. As it is our intellectual property, it can't be shared.

💡

Creating a good prompt could be tricky. But now we provided several pieces of advice, to read them please click the Good prompts: tips & tricks icon, and the side panel will be open.

image

image

Also, to help you with creating a good, working prompt, we wrote this article: Art of Creating Great Prompts (opens in a new tab).

Custom messages

image

Here you can enter messages as a guide for the chatbot on what to say when it doesn't know an answer, and when is asked for human assistance.

💡

You can set up these messages that will be used in all your chatbots for the current project unless you provide the same messages for a separate chatbot which has a higher priority.

Fine tuning

These settings are used for the fine-tuning data to be passed to ChatGPT as context.

image

  • chunk size is the amount of bytes to be stored and to be obtained from the index database to form context data (the default number is 256 bytes which usually works great but in some cases, other amount, say, 1024 bytes works better)
  • amount of chunks to send as context - the number of pieces that will be sent as context. The more the number the better but sometimes it can be more that the OpenAI threshold what can cause an error.

Stick to context

If you want the chatbot to be stick to your context and ignore questions that may be outside of it, use this parameter:

image

If our system didn't find any relevant information in your data, and this switch is on, the chatbot will answer with a text you set up in the custom messages (opens in a new tab) or with our standard message if this is not defined. Each piece of data obtained from your data has its own relevancy score (the less the more relevant). Usually, a score more than 0.25 is considered irrelevant. But you may control the threshold and include the data with a score higher than 0.25 - find the best one by experimenting.

Using metadata

You now can add metadata in the prompt, currently, the language of the question is available. If you want the chatbot to answer always in the language of question (that is detected automatically), use the following syntax:

... Answer in the {language} language.

Just add the "language" word wrapped with curly brackets, and then, during the preprocessing of your prompt, it will be converted into a normal string (the exact value varies according to the question's language):

... Answer in the French language.

Deleting project

If you scroll down to the end of the settings page you will see the "danger zone":

image

Click the Delete project button if you'd like to delete a project but be aware that all the associated data sources as well as interactions will be deleted too.

Events logging

We log errors occurring for a project. Currently, they include errors related to the OpenAI API such as insufficient credits or the wrong OpenAI key. You can find the log entries in the Logs menu for your project:

image

Statistics

Right now, we can collect the stats on using the buttons you attach to your messages; we also count the number of the conversations. How to configure the buttons please read the chatbot documentation (opens in a new tab). To allow collecting these stats the corresponding flag should be on (opens in a new tab).

image

It's pretty clear what all settings mean:

image

You can choose to see stats on one specific chatbot or all of them. You may see the stats daily, weekly, or monthly. The last switch allows you to choose between counting all the clicks or only the last one for sessions. It means that if a user clicks buttons several times during the session, only the last one will be counted.

You also can have data on each of your chatbots side-by-side (if you have installed many of them) by selecting the Group by chatbot option.

💡

The retention period for stats data is 3 months for paid plans and 1 month for the free plan.