> For the complete documentation index, see [llms.txt](https://docs.jedidesk.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.jedidesk.com/english/jedidesk-ai-setup/how-to-configure-jedidesk-ai.md).

# How to configure JediDesk AI

JediDesk AI - artificial intelligence integrated into the #jedidesk system for fast responses and 24/7 work

{% hint style="info" %}
**AI and plans:** JediDesk AI is an optional paid add-on for MINI, PRO and PRO+. START has no AI or credits. Purchasing a paid plan includes 1,500 / 4,550 / 7,500 credits per month respectively, whether AI is enabled or not. Credit use varies with the information used to form each reply. Dialogue figures are comparative equivalents, not limits or guaranteed quantities. [Current plans and payment](https://docs.jedidesk.com/znaiomstvo/oplata-pidpiski-na-servis-jedidesk).
{% endhint %}

### 1. Open JediDesk AI

Open **JediDesk AI** in the side menu. The page contains the available credit balance, statistics, assistant activation, backups, business instructions, knowledge sources, AI functions and stop words. The screenshots below show the current Ukrainian interface; the names in parentheses identify its controls.

The available balance can differ from the monthly credit package. Select a period in the statistics panel to inspect requests and replies. A configured request limit is separate from the balance of credits.

### 2. Configure the assistant instructions

In **Business card settings (Налаштування картки бізнесу)**, fill in **Instructions (Інструкція)**. If you start from a ready assistant template, adapt it to your business before activation. Remove placeholders and refer only to knowledge sources that you actually provide.

Include:

* the assistant's role, name and language;
* how to greet, clarify the request and guide the customer;
* where to find prices, products, delivery, payment and return policies;
* when to ask a manager for help;
* what to do when the knowledge base does not contain the answer.

For example: “Use Delivery.json for delivery policies and Products.json for product details. If the answer is missing, ask for clarification or offer help from a manager. Do not invent prices or availability.” Keep business facts in maintained knowledge sources and behavioral rules in the instructions.

![Current ai settings](https://2421713157-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FizQzM1n6iqF17cIYxrec%2Fuploads%2FgXTuFolsxHnVsL2l6TT0%2Fclosure-ai-settings.jpg?alt=media)

Select an available model, response languages and channels. Model availability and credit multipliers are shown in your account. MINI works within its widget and one selected customer channel. The assistant language settings and the widget's system-interface language are separate settings; START/MINI do not gain a multilingual widget from this field.

### 3. Set reply behavior and request controls

Configure the parameters shown in your account:

* **Creativity** controls response variability. Use a restrained setting when factual precision is required.
* **Focus** controls how closely the assistant follows its instructions.
* **Relevance threshold** affects which retrieved knowledge fragments are used. An excessively high threshold can exclude useful information.
* **Request limit per dialogue** and **request limit per week** are optional controls that you set. They are not tariff dialogue allowances or fixed conversions from credits to replies.
* **Channels** selects where the assistant may reply. An empty selector applies to the available channels according to the account settings and plan.
* Working-hours switches control activation during or outside business hours. Configure the company's schedule before using them.
* **Automatically disable when a manager joins** separates automatic replies from a conversation handled by a person.
* **Closed AI assistant** restricts assistant access to clients for whom it has been enabled in **Users**. Review the client's assistant-access setting when this mode is used.
* **Clear AI chat history after closing the conversation** controls retention of that conversation's AI context.

Save changes after editing. Test changed instructions in a new dialogue so previous conversation context does not obscure the result.

### 4. Add knowledge sources

In **Knowledge Base (База знань)**, upload the files that the assistant should use. The current form accepts **doc, docx, html, txt, json and pdf**. Use **Choose (Обрати)** or drag files into the upload area, wait for processing and click **Save changes (Зберегти зміни)**.

![Current ai knowledge](https://2421713157-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FizQzM1n6iqF17cIYxrec%2Fuploads%2FHQ04zkyVeor5bHG3Dehz%2Fclosure-ai-knowledge.jpg?alt=media)

Keep source information clear and current. For products, useful fields include an article number, name, characteristics, short description, price and product URL. For business policies, use separate files or clearly titled sections for delivery, payment, returns, warranty and contacts. JSON is useful for structured data, but it is not the only accepted format.

The **Data from your website (Дані із вашого сайту)** block provides a separate setup link for website data synchronization. Configure that source through the linked integration if you use it; check the resulting information before relying on it in replies.

### 5. Configure AI functions and handoff

The **AI functions (Функції ШІ)** section contains built-in actions, such as handoff to a manager, collecting contact details, knowledge search and functions that use connected product or order data. Open the function settings, configure its instructions and customer-facing text where applicable, then save. Availability is shown by the function's tariff indicator; catalog and order integrations may require PRO/PRO+.

![Current ai functions](https://2421713157-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FizQzM1n6iqF17cIYxrec%2Fuploads%2FvNJuQa2gB3snvzfWKZJn%2Fclosure-ai-functions.jpg?alt=media)

**Custom functions are available only on PRO+.** They connect your own server or system through a webhook. Creating a custom function and using a built-in function are distinct capabilities. PipeDrive, SalesDrive and Horoshop integrations are available on PRO/PRO+.

For handoff, describe situations in which the assistant should stop and involve a person: an explicit request for a manager, a problem outside the available knowledge, or a request that requires manual handling. Test both the assistant's decision and the message the customer receives.

### 6. Set stop words

In **Stop words (Стоп-слова)**, specify the words, whether to check customer or AI messages, and the action: notify a manager or stop the bot. Add the required rules and save them. Use intentional phrases to avoid stopping unrelated conversations.

![Current ai stopwords](https://2421713157-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FizQzM1n6iqF17cIYxrec%2Fuploads%2FNaeIy1kvUFhIHawCQrB9%2Fclosure-ai-stopwords.jpg?alt=media)

### 7. Activate and test

After saving the instructions, knowledge and behavior settings, use **Activate JediDesk AI (Активувати JediDesk AI)** when you are ready for automatic replies.

Test a typical question, a missing-information question, a price or availability question, a manager request and the relevant channel/working-hours conditions. Check the sources used in replies and the actual credit consumption. Correct the knowledge or instructions when the answer is inaccurate.

Magic Button is a separate workflow on MINI, PRO and PRO+: it generates a draft for the owner or operator to review and send. Automatic assistant replies are configured separately. Replying to customers through the Telegram notification bot is available on PRO/PRO+; START/MINI owners handle replies in the JediDesk cabinet.
