Configuring a widget

Our widgets are highly customizable, allowing you to change their appearance and the way it operates.

You can configure your widget by navigating to https://interaxai.com/app and choosing the widget you want to configure by pressing "..." and "Configure".

Dashboard

The dashboard is where you can find information about your widget such as the widget type, payment type, LLM model, visibility, and analytics. You can also find your widget's embed code, which is the code used to integrate InteraxAI into your website, as well as basic usage and view analytics. Sample Embed code:

<script id="interaxai-widget-config">
  window.INTERAX_AI = {
    id: "<Your Widget ID>",
    theme: "light",
  };
  const _interaxAI=async()=>{const t=await fetch(`https://interaxai.com
  /api/embed/version?widgetId=${INTERAX_AI.id}`).then((t=>t.text())),
  e=document.createElement("script");e.id="inteinteraxai-widget-script",
  e.src=`https://cdn.jsdelivr.net/gh/interaxai/cdn@${t}/dist/bundle.js`,
  document.head.appendChild(e)};_interaxAI();
</script>
<div id="interaxai-widget"></div>

Sample Iframe code:

<iframe src="https://iframe.interaxai.com/<Your Widget ID>" frameborder="0" allowfullscreen="" style="width:100%;height:100%;min-height:500px"></iframe>

Style Editor

The style editor is where you can edit your widget's appearance.

Example of a chat-completion widget on InteraxAI's editor

The API Provider tab is where you can control how your widget behaves and responds. See table for definitions.

API Provider

Model

The machine learning model that you want to use for the completion/generation. See table for model vs generations used.

MODEL	GENERATION DEDUCTION PER RESPONSE
GPT-3.5-Turbo	1
GPT-3.5-Turbo-16k	2
GPT-4	20
DALL-E	2

System Prompt

A piece of text that provides instructions to the AI on how to generate a response.

File Context

A file that contains context for the AI to generate a response with. See table for supported file types.

File Type	Size Limit (may subject to change)
.txt	10MB
.pdf	10MB
.csv	10MB
.docx	10MB
.json	10MB

Vector Count

The number of relevant answers from the embeddings to be used when generating a response.

Prompt

The text that the model will generate a response to.

Prompt Filter

A collection of words or phrases that are prohibited from appearing in the prompt. The presence of these items will trigger the widget to refrain from generating a response.

Memory

How much of the conversation history is used to generate the response. This is only applicable to chat-completion widgets. There are 4 types of memory: standard, recent-context, limited-recall, and tokenized-summary. See the memory guide below for more information.

Memory Type	Description
Standard	The default memory type involves utilizing the complete conversation history to craft a response, with constraints set by the Max Tokens parameter.
Recent Context	The model relies solely on the latest information to craft its response, functioning much like a memory system with a limited recall of the three most recent contexts.
Limited Recall	The model generates responses based on a specific number of previous contexts. You can adjust this number by editing the "Prev. Messages" option next to the memory selector.
Tokenized Summary	When the token limit is reached, the model will provide a summary of the entire conversation history, including the three most recent messages.

Max Tokens

Sets the maximum number of tokens (words or subwords) that the model can generate in response to the prompt.

Model	Max Token Limit
GPT-3.5-Turbo	4096
GPT-3.5-Turbo-16k	16384
GPT-4	8192

Temperature

Controls the creativity and randomness of the generated text in OpenAI's language model.

TopP

Determines the probability mass of the most likely next token, used to control the diversity of the generated text.

Frequency Penalty

Penalizes words that appear frequently in the model's training data to encourage more novel and unique responses.

Presence Penalty

Penalizes words that have already been used in the input prompt to encourage more diverse and varied responses.

Stop

A list of tokens (words, subwords, or regex expression) that the model will not generate after the maximum length or other stopping conditions are met.

Prompt Variables

Variables that you can use within the prompt settings. These variables will be replaced with their corresponding values before generation. See table for reserved variables.

Reserved Variables

Variables	Description	Example Value
<Date>	the current date	11/29/2023
<Time>	the current time	6:47:31 PM
<DateTime>	both current date and time	11/29/2023, 6:47:56 PM
<Context>	retrieved text from embeddings	System Prompt: "Answer the user by using the following context: <Context>"

Custom Variables

When you navigate to the style editor, on each form input component you will see an "ID" input field under the Content Settings on the right-hand side of the editor. That "ID" will automatically become a prompt variable. See table for widget-type example prompts.

Widget Type	Sample Prompt
Text Completion	Write a detailed blog post about <TextInput1> in a <SelectInput1> tone.
Chat Completion	n/a
Image Generation	A <TextInput1> that is color <SelectInput1>, Sigma 85mm f/1.4

Payments

Select what type of payment you want to receive from your audience.

Payment Type
Free	Widget usage is free for your audience. Your available generations will get deducted. See deduction per model table.
Pay per generation	Your audience will pay for each widget they create, and you won't incur any charges for generating the widget. Direct payments will be set up automatically.

You must set up a Stripe Express account to earn money from your audience. To set up your account, navigate to https://interaxai.com/account/payments and click "Setup Direct Payments". If you do not connect your Stripe account, direct payments will still be enabled. However, the payment will be sent to us for the generation of your widget.

Leads

Tools that allow you to generate more leads.

Modal Pop-up

A popup modal will appear once your user hits the specified generation limit. What you can configure:

• Heading/Title

• Description

• Call to action button text and link

• Generation limit and its expiration in minutes

• Whitelisted 'data-ms-content' IDs (Modal will not popup if you dynamically add the 'data-ms-content' attribute on your script code)

Usage

Configure how your widget will be used

Usage Limit

Control how much your widget can be used each month (Hard Limit) or get email notifications when you've reached a certain specified threshold (Soft Limit).

Request Limit

Configure the maximum number of requests that can be made to your widget per interval.

Auto Save

Automatically save widget inputs and results in the cloud, which is displayed on the History tab. Note: Widget results are saved on the browser's local storage by default.

Auto Reset

Automatically reset the form input elements after a successful generation.

Team

Manage your team members and their roles. When adding a team member already registered with us, the system will seamlessly integrate them. For those who are not yet registered, an automated email will be sent to prompt them to complete the registration process.

Settings

Change basic information about your widget such as name, language, and more. What you can configure:

• Name

• Language

• Toggle InteraxAI Branding (Hide or display InteraxAI branding)

• Allowed hosts (Websites that can host your widget)

• Visibility (Private: only you, Unlisted: only those with the link, Public: everyone)

• API Key (Key used to authenticate requests to OpenAI)

• SDK Version (Adjust the version of your widget manually)

• Widget ID (Mostly for support)

You can also duplicate and delete your widget on this tab.