How to Create Your Assistant with Superinterface
Creating an assistant on your website is a powerful way to enhance user experience and streamline interactions. With Superinterface, you can easily build, configure, and publish an assistant in just a few steps.
In this guide, we will create an FAQ assistant named "Bobby" as an example. You’ll learn how to choose an AI provider, set up storage, configure an interface, and publish it on your website.
Step 1: Create a New Assistant
To get started, navigate to the Assistants tab in Superinterface and click on New Assistant.
Step 2: Choose an AI Provider and Model
Choose an AI Provider
Choosing the right provider allows you to leverage their specific features and models. Superinterface lets you select from various AI providers, such as OpenAI, Anthropic, Mistral, and others.
For this example, we’re selecting OpenAI, but you can choose any AI provider that fits your needs.
Choose an AI provider that you prefer.
Syncing with OpenAI
If you've previously created assistants on OpenAI, you can sync those setups into Superinterface. This feature is available for assistants using the OpenAI Assistance API.
Choose an assistant from your OpenAI list (e.g., Super FAQ, as used in this guide).
Click Sync from OpenAI to import all the instructions, configurations, and settings.
Sync your assistant setup from OpenAI to Superinterface.
Note: Any changes you make in OpenAI will require you to resync to update Superinterface. Changes made here won’t affect your original OpenAI assistant setup. Once synced, the assistant will act based on how the setup is configured within Superinterface.
Storage Setup
Now, you need to decide where to store and execute your assistant's threads. Threads are the conversations your assistant has with users, and if you select OpenAI as your provider, you have two main options:
Superinterface Cloud: Stores threads on Superinterface’s servers.
AI Provider Storage: If you choose OpenAI, threads are stored on OpenAI’s servers, which can be useful for consistency between the AI provider and your assistant.
If you choose another AI provider, the threads will be stored on the Superinterface Cloud.
For this example, we’ll store the threads using OpenAI Assistance API.
You can chose to store and manage Threads on OpenAI, or Superinterface Cloud.
Step 3: Add Instructions
Instructions are the rules that guide how your assistant responds to users. This is where you shape its behavior—what kind of answers it gives, how detailed they are, and what follow-up questions to ask.
You can give general rules (like “keep answers short and clear”) or specific ones (like “suggest similar products if asked about features”).
Using Suggestions for Instructions
One particular instructions we enjoy is the instruction to suggest follow-up questions in the form of clickable buttons we call Suggestions component.
The Suggestions component lets you display clickable options for users to select instead of typing their questions. To instruct your assistant to use this component, you can add a Suggestions block in the instructions text box in the following format:
Each line in the suggestions block creates a new clickable option that makes it easy for users to engage with the assistant.
For example, you might want to instruct your assistant to always suggest follow-up questions that appear as clickable button-components after each answer.
Suggest follow-up questions.
This ensures that Bobby keeps the conversation flowing by offering useful follow-up suggestions, enhancing user engagement.
Step 4: Personalize Your Assistant
Name Your Assistant
Give your assistant a descriptive and relevant name. In this case, we’ll call it "Bobby", an FAQ bot designed to handle common questions on our website, Superinterface.
Add a Description (Optional)
You can also add a description of the assistant which will be displayed to the users in some interfaces (e.g., in the Group thread interface).
Add a description to your assistant.
Choose Avatar
Choose an avatar for your assistant. This helps users recognize and remember your assistant.
Choose an avatar for your assistant.
Customize Initial Messages
In the Initial messages tab, you can set the first message that users will see when they interact with your assistant. This message can welcome users and provide context or instructions on how they can interact with the assistant. It’s a great opportunity to set the tone and guide them.
For example:
"Hi there! How can I help you today? Feel free to ask about our products, services, or anything else."
You can further enhance the user experience by adding an Initial Suggestions Block—a set of clickable options that appear as buttons below the assistant's initial message.
These buttons serve as quick replies, allowing users to engage with your assistant instantly by selecting a topic that matches their needs.
To set this up, simply add a Suggestions block in the initial messages text box. Each line in the block creates a new clickable button for users to choose from, ensuring that users are guided toward valuable topics from the start.
Customize initial messages.
Explore Advanced Features
If you'd like to further customize your assistant, head over to the Components tab.
Here, you can explore advanced features like Functions for function calling, enabling your assistant to interact with APIs or trigger specific actions.
You can also add Annotations for accurate referencing to sources, improving the credibility and detail of the assistant’s responses.
Ready to Publish?
If you're satisfied with your setup, it's time to add your assistant to your website. Simply click Publish to create an interface and integrate it with your site. For a detailed guide on how to publish, go to Create Interface.