Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

On this page

Table of Contents
minLevel1
maxLevel3
outlinefalse
stylenone
typelist
printablefalse
Panel
bgColor#FFFAE6

Available AI Prompts section available from version 3.34.0. AI Prompts section and relative documentation are This documentation is work in progress and some features will be available in next releases.
From version 3.35.0 it’s also possible to useAssistants within the ChatGPT bot block (in this case you need to enable on License AI and Assistant feature)

📋 What’s About

AI Prompts is the section on which you can configure OpenAI Assistants, designed to understand and answer to human queries, by starting from business files uploaded in the relative section.

Assistants are OpenAI models that can use tools, in our case reading uploaded files, to find answers for customers.
Explore how it works on Official https://platform.openai.com/docs/assistants/how-it-works documentation documentation: Assistants overview | How Assistants work

Note

OpenAI Assistants are in Beta version

image-20240507-133840.png

(blue star) Requirements

Panel
bgColor#EAE6FF
  • To view AI Prompts you must enable on license AI Assistants feature

  • To use Assistants on ChatGPT Bot (feature coming soon) you have to enable on license also AI Tools feature

⚙️ Configuration

Assistants

You can define OpenAI Assistants both on XCALLY side and on OpenAI console. In both cases, assistants are registered on OpenAI (not on Motion database).

image-20240507-135655.jpg


To create a new Assistant, you can click on Add assistant and insert:

image-20240507-140929.png

  • Assistant Name

  • Cloud Provider (OpenAI type)

  • Model (as gpt-4-turbo or gpt-3.5-turbo)

  • Instructions, on which you can specify what assistant has to do. If you want that assistant uses files, you need to make reference in instructions to file name

And click on Save

The created Assistant is saved also in Open AI platform under Assistants section

image (1)-20240507-140818.jpg

Files

So if you want to use company business documents, on Files section, you can upload your files (for example pdf instructions, user manuals and so on). By clicking on Add File you have to
Read on official OpenAI documentation, the supported files Open AI | Supported Files

Info

Recommend uploading static documents with infrequently changing data as files, in pdf, doc, or text format

You can here view an example of how to create a file:

View file
nameExample Business File.docx

So you can click on Files Add file

image-20240507-130612.pngImage Added

And then select OpenAI Cloud Provider and upload Files from your computer → and click on Confirm
Then the files will be added with relative status (as waiting or uploaded) Read on official OpenAI documentation, the supported files Open AI | Supported Files

image-20240507-142544.pngImage Modified

image-20240507-130612.pngImage Removed

So in this case, by editing a created assistant, you can see files section to associate files to the assistant. By clicking on Files section you can add the relative files, among those uploaded.

are working to make it possible to use Assistants within the ChatGPT bot block… Stay tuned!
image-20240507-142803.png
image-20240507-143042.pngImage Removed

InfoWe
image-20240522-123128.pngImage Added

In this way bot has an associated file.

🤖 How to configure Assistants in ChatGPT block

On channels that support chatGPT block in action plan, it is possible to configure the assistant so that the bot can retrieve useful customer information from uploaded files.
For example if you create an Assistant with files related to product return and the customer aks for this type of information, the bot provides an explanation, starting with the uploaded documentation.

So inserting the relative block the system asks:

image-20240522-103532.pngImage Added

  • OpenAI Cloud Provider account

  • ChatGPT Assistant: from this section you can choose among the created assistants, associated to the cloud provider key

  • Bot Name

  • Exit Phrase

  • Welcome message

  • Option to analyze chat to know if pass the chat to an agent

  • Forward message

  • Error message

Info

As you can see, when you use Assistant you can’t enter chatGPT model, prompt (so instructions), max conversation lenght in tokens, temperature because these options are already inserted in OpenAI Assistant configuration (as you can see below)
Follow official documentation Prompt engineering about how to properly create a prompt
From the section OpenAI Usage you can track costs by token usage

image (10)-20240522-122311.jpgImage Added

When you use Assistant, it is recommended to insert a queue after bot management so that customer service is forwarded to a human operator

image-20240522-105126.pngImage Added

So when for example a chat starts, the bot answers to customer with information that it can retrieve from files:

immagine (1)-20240522-123201.pngImage Added

And agent will be able to see the interaction, in the relative channel interactions list.

(blue star) Related topics

Filter by label (Content by label)
showLabelsfalse
maxCheckboxfalse
showSpacefalse
reversefalse
cqllabel = "openai"