Beskrivning
Develop multiple AI chatbots with different styles and behaviors on different pages of your website, including using content-aware functionality OpenAI Assistant API and RAG. You can personalize the appearance of the chatbot: colors, styles, text; Personalize its position on the screen, window size, chatbot behavior by choosing: model, instruction, temperature, tokens, etc. You have the option to choose whether the chatbot will be visible only to registered visitors or not. The plugin allows you to update models directly from OpenAI and independently choose the model to use. You can record and save chat conversations between users and the chatbot. Additionally, it allows you to create/modify content and images as well as generate code using the ChatGPT API. The API provides access to large language models.
With this plugin, you can not only edit and generate code, but also perform various content manipulations using OpenAI ChatGPT . You can use plugin for generate images using Dall-E2 and Dall-E3 AI systems. One of the features is the ability to create a database of instructions, which you can easily refer back to whenever needed. Moreover, you have the flexibility to choose from a wide range of models available in the OpenAI ChatBot API, ensuring that your requests are tailored to your specific needs.
S2B AI Assistant is plugin for WordPress powered by any model you can choose from OpenAI API platform https://platform.openai.com/docs/models .
You can log conversations between AI chatbot and visitors of your website.
Features
- AI powered chatbot
- Multiple different chatbots with different style and behavior for different website pages
- Content aware AI chatbot using Assistant API, better use gpt-4-turbo-preview, gpt-4
- Content aware AI chatbot using RAG via embedding content
- Conversation Logging. Recording and saving chat interactions between users and the chatbot
- Personalize the appearance of the chatbot: colors, styles, text
- Personalize view of chatbot using custom css (additional feature for each chatbot)
- Personalize behavior of the chatbot: model, instruction, temperature, tokens, etc.
- Option to choose if the chatbot is only visible to registered visitors or not
- Is possible to select position, size of chatbot’s window
- Dynamic update of models directly from OpenAI
- Select any model which to use in plugin
- Plugin can generate images
- Correct any grammatical errors
- Rewrite sentences
- Summarizing
- Finish the sentence
- Improve your writing skills
- Engaging questions
- Answering All Inquiries
- Create product descriptions
- Intent Recognition
- Code Understanding
- Select any model you want from ChatGpt
- Create a blog intro for your next article
- Create blog outlines
- Change the tone of your sentences
- Create brand names, startup ideas and slogans
- Generate a list of marketing ideas
- Brand story
- Create ad copy for Adwords and Facebook
- Create landing page content
- Change access to different functions of plugin for different user roles
How to use plugin
-Open account at OpenAI and get API key
-Go to Settings page YOUR_WEBSITE_URL/wp-admin/admin.php?page=s2baia_settings page of this plugin. Paste API key in the ’Open AI Key:’ field of the ChatGPT tab.
-Switch to Models tab. Click on the ’Refresh from OpenAI’ button. It updates models from OpenAI server. Select Models which you want to use. Select the Edit checkbox for models that will be used with chatbots and text manipulation. Select the Expert checkbox for models to be used in the Expert playground. Finally click the Save button. Now you can now the S2B AI Assistant plugin.
-You can create many chatbots on the Chatbot page YOUR_WEBSITE_URL/wp-admin/admin.php?page=s2baia_chatbot page of this plugin.
-To get the chatbot operational, insert the shortcode in one of the following formats [s2baia_chatbot], [s2baia_chatbot bot_id=automatically_generated_hashcode] (where automatic_generated_hashcode is the chatbot hashcode that is automatically assigned when the chatbot is created) or [s2baia_chatbot bot_id=assistant] into any page or post. First format allows to exploit chatbot that uses Chat Completion API. This is default chatbot type. The second format allows for both types of chatbots using the Chat Completion API and the Assistant API. Third format of shortcode allows to use the automatically generated AI Assistant directly from our plugin. You can use all 3 types of chatbots on different pages or posts. You can create as many different chatbots as you like with the format [s2baia_chatbot bot_id=automatically_generated_hashcode]. You can also place a chatbot with the same shortcode on different pages and/or posts.
-To create a content-aware chatbot using OpenAI Assistant API you have two options. First option is to generate AI Assistnt directly from our plugin. For doing this you need to click on Assistant API tab and follows 3 steps:
1.Upload file that will be used as knowledge base by ChatGPT.
2.Create new Assistant by filling instruction and selecting model. For details see article.
3.Add shortcode [s2baia_chatbot bot_id=”assistant”] to any page you want
Additionally, you can read article about how to better configure content aware chatbot.
The second option to create an AI Assistant is to do it through the OpenI Assistants page and then link to our plugin. Read this article for more details.
-For image generation open Image page in /wp-admin side. There you can generate images, using Dall-e-2 or Dall-e-3 models and store them into Media library.
-For using content feature please open any type of post edition page. Then scroll down to the S2B AI Assistant metabox. There, you can enter text into the ’Text to be changed’ input field. After that, you can manually input your instructions. Additionally, you can select any previously saved instructions in the database. Also you can select other parameters such as the model, temperature, and maximum length of the request and response text. Finally, click the Send button. If everything goes well, you will receive a response in the Result textarea.
For those with more in-depth knowledge of using ChatGPT, we offer the Expert tab.
For additional information regarding prompts see this page
Chatbot view modifications
Besides of styling chatbot in configuration pages you also can use some predefined views or view modifications. In version 1.6.1 we introduce modalless view which allows you to put chatbot as part of web page without showing modal window. To use this function you can add shortcode [s2baia_chatbot bot_id=BOT_HASH_CODE view=embedded] where BOT_HASH_CODE is hashcode generated automatically when you create new Assistant or Chat Bot. This hash code is displayed in hash column of table with chat bot or assistants list. Also it is possible to use such simple form of shortcode [s2baia_chatbot view=embedded] In such case plugin displays default chat bot as modalles in the web page. You can also use the same chatbot with different views as modal or modalles in other webpages. When you want to use chat bot without modal then make sure that you selected pixels as units of measurement for chatbot height in the bot configuration!
We also introduced view_mode attribute in shortcode. When you add such shortcode [s2baia_chatbot bot_id=BOT_HASH_CODE view_mode=fullscreen1 ] then chat bot will be displayed in full screen immediately after page loads. If you want to hide close button for full screen chat bot then you need to use hideclose=1 attribute. For ecxample [s2baia_chatbot bot_id=BOT_HASH_CODE view_mode=fullscreen1 hideclose=1]
Apply custom CSS rules to any chatbot
In version 1.6.3, we added the ”Deep Customization” feature. This allows you to create a unique view for each chatbot using custom css rules. To do this, you need to find the ’Deep customization’ section on the ”Chatbots” or ”Assistants” tabs, add the unique html id of the closed and opened chatbot. You can then add CSS rules to each closed and open view of any chatbot. Separate css rules can be applied to different chatbots.
Users access
It is possible to configure user access to different parts of plugin. If you are admin then you can select which user roles have access to next functional parts: meta-boxes, plugin’s configuration page, access to delete instructions and access to configure chatbot.
You can also select which user role has access to the image generation feature. To do this, you need to select a user role from the middle select box in the ’User Roles’ panel. It is worth noting that even if the role selected in the middle field has access to create images, this does not guarantee that this role will have permission to write created images to the Media Library. For more details, please check page
As an administrator, you can also select user roles that can configure chatbots. Also, when creating chatbots, you can choose whether they will be available to unregistered visitors or only to registered ones.
Open AI
The S2B AI Assistant makes use of the API provided by [OpenAI](https://openai.com/blog/openai-api or [Reference]https://platform.openai.com/docs/api-reference). This plugin does not collect any data from your OpenAI account apart from the number of tokens used. The information sent to the OpenAI servers mainly includes the content of your article and the specified context. The usage information displayed in the add-on’s settings is only for your reference. To obtain accurate information about your usage, it is important to check it on the OpenAI website. Additionally, please make sure to review their Privacy Policy and Terms of Service for more details.
Disclaimer
The S2B AI Assistant is a plugin that allows users to integrate their websites with AI services such as OpenAI’s ChatGPT and Pinecone. In order to use this plugin, users must have their own API key and adhere to the guidelines provided by the chosen AI service. When utilizing the S2B AI Assistant, users are required to monitor and oversee the content produced by the AI, as well as handle any potential issues or misuse. The developer of the S2B AI Assistant plugin and other related parties cannot be held responsible for any problems or losses that may arise from the usage of the plugin or the content generated by the AI. Users are advised to consult with a legal expert and comply with the applicable laws in their jurisdiction. OpenAI, ChatGPT, and related marks are registered trademarks of OpenAI. Author of this plugin is not a partner of, endorsed by, or sponsored by OpenAI
Skärmdumpar
Installation
Quick setup:
-Open account at OpenAI and get API key
-Go to /wp-admin/admin.php?page=s2baia_settings page of this plugin. Input copied API key in the ’Open AI Key:’ field of the ChatGPT tab. You can copy API key on api keys page
-Switch to Models tab. Click on the ’Refresh from OpenAI’ button. It updates models from OpenAI server. Select Models which you want to use. Select the Edit checkbox for models that will be used with chatbots and text manipulation. Select the Expert checkbox for models to be used in the Expert playground. Finally click the Save button. You can now use the S2B AI Assistant plugin.
-You can customize the position, appearance, behavior of the chatbot on the ChatBot configuration page /wp-admin/admin.php?page=s2baia_chatbot. On this page, you can create many chatbots that differ in their appearance, position and behavior.
-To get the chatbot operational, simply insert the shortcode [s2baia_chatbot] to any post or page
-If you want to use different chatbots on different pages, add a shortcode in the format [s2baia_chatbot bot_id=generated_hashcode] to any page or post.
-To add content aware feature using OpenAI Assistant API you need to go to Chatbot page, then click on Assistant API and follows 3 steps:
1.Upload file that will be used as knowledge base by ChatGPT.
2.Create new Assistant by filling instruction and selecting model. For details see below in Content aware feature section below.
3.Add shortcode [s2baia_chatbot bot_id=assistant] to any page, to display Assistant. We tested this feature with different models and found that the best result are when using gpt-4-turbo-preview, gpt-4 and gpt-4-turbo models. Please read this and this articles for detailed information.
-Additionally you can create many Assistants inside OpenAI Assistant dashboard and link them with our plugin. Read this article on how to do it.
Detailed setup and configuration:
Initial configuration.
- Go to Settings page /wp-admin/admin.php?page=s2baia_settings. In the ChatGPT tab fill your API key in the ’Open AI Key:’ . You can generate API key on this page: https://platform.openai.com/account/api-keys
- You can fill other fields on this tab or leave them by default.
Chat GPT Models configuration.
3.Switch to Models tab. Click on the ’Refresh from OpenAI’ button. It updates models from OpenAI server.
4.Select Models which you want to use in different functions of our plugin. Finally click ’Save’ button. Select the Edit checkbox for models that will be used with chatbots and text manipulation. Select the Expert checkbox for models to be used in the Expert playground. Remember that not all models are suitable for chatbots and word processing. That means you can get error response like this one ’This is not a chat model and thus not supported in the v1/chat/completions endpoint. Did you mean to use v1/completions?’ when you try to use them. As of today’s date (July 2024) we recommend to select gpt-3.5-turbo, gpt-3.5-turbo-16k-0613, gpt-4 versions, gpt-4-turbo-preview and gpt-4-turbo versions. You can play with selection and deselection models to find best that fit to your needs.
For more information about selecting models read
AI Chatbot setup.
Open Chatbot menu page in wp-admin. You can see such tabs:
General, Styles, Chatbots,Assitant API, Assistants, Logs and Support. On General, Styles You can customize default behavior, appearance and view of chatbots. In particular you can select ChatBot position, ChatBot size, model, colors of chatbot’s elements etc.
If you want to use different chatbots on different pages then create bot in Chatbots tab and then put shortcode in format [s2baia_chatbot bot_id=automatically_generated_hashcode] into any page or post. In addition, the plugin allows you to create AI Assistants using the Assistants API. You can create Assistants in Assistant API and or in Assitants tabs. Read below on how to do this.
Notice! Chatbot view parameters like position, size, colors are affected by caching. When you found that you have changed chatbot parameters, but view has not changed then try to clear cache then reload page.
Content aware feature for AI chatbot.
OpenAI introduced new Assistant API which allows it automatically to parse and chunk uploaded documents, to create and to store the embeddings, and use both vector and keyword search to retrieve relevant content to answer user queries. We implemented File Search API feature in our pugin. Before using this on your website, you should remember some important tips:
1.It is Beta feature and not yet tested carefully. Thus it can cause unpredicted behavior. Therefore, we cannot guarantee the chatbot’s responses.
2.OpenAI charges additionally besides used conversational tokens. At the moment of release version 1.5.8 of this plugin it costs $0.10 / GB of vector-storage per day (1 GB free) + used tokens during conversation. Please observe to be informed about pricing updates.
3.The effectiveness and accuracy of the bot’s responses depends on the system instructions provided and the models used in the prompts. For detailed information please read article
To setup content aware chatbot using Assistant API you need to open page Chatbot and select Tab ”Assistant API”. Then you need to perform 3 steps:
1.Upload file that will be used as knowledge base by ChatGPT.
2.Create new Assistant by filling instruction, selecting model and timeout.
3.Add the shortcode [s2baia_chatbot bot_id=”assistant”] to any page you want.
Additionally you can create many assistants manually in the Assistants OpenAI dashboard and link them to our plugin. For this you need to go to Assistants OpenAI dashboard and create assistants there. Then copy ID of created assistant. After that, you need to create a new assistant in the plugin Assistants tab.Finally, paste the ID in the Assistant ID field.
Alternatively you can use Completion API to create content aware chatbot along with RAG by embedding website content.
Starting from version 1.6.4 we added Retrieval-augmented generation (RAG) support to chatbot. So you can use external vector database API and use it in pair with Embedding API and with Chat Completion API endpoint to build content aware chatbot. With the right configuration you can have such powerful chatbot like Assistants but with cheaper price. How RAG feature works? Plugin allows to upload content of selected posts or pages from your website into external vector database using their API and generate search database. This vector database is able to do semantic search inside uploaded content. You can attach vector database to chatbot. When visitors ask questions, this chatbot sends a query to the vector database instead of sending it directly to ChatGPT. The vector database returns content that matches the user’s query back to your site. The content found by the vector database is then sent to ChatGPT along with the user’s query. If the vector database does not find any information that is related to the user’s request, you have the option to stop sending the request to ChatGPT and return a message informing the client about the missing content. This way, you can achieve 2 goals:
1. Limit sending any requests to ChatGPT that are not related to website content.
2. Only send ChatGPT content from your website that is relevant to the user’s request. This allows you to reduce the cost of using the Chat Completion API.
For more details of how RAG works see this article. Also you can read this page to get idea on how plugin’s RAG feature works.
RAG setup.
1.Open account at pinecone. Create empty Index there, set the dimension to 1536, and choose cosine for the metric.
2. Get your API KEY from https://www.pinecone.io/
3.Open RAG wp-admin page of S2B AI Assistant
4.Fill field ’Pinecone API Key:’ with API key
5.Click Sync indexes button. It should add your Pinecode Index in Pinecode Index field. Select it in dropdown box.
6.Select Embedding model with 1536 dimension.
7.Select other parameter on this page and click Save button.
8.Go to Pinecone tab and select content pages or posts from left list and add them into right list.
9.Open ChatBot wp-admin page of S2B AI Assistant plugin.
10.Go to ’Chatbots’ tab and create new chatbot or select some among created before.
11.Make checked Use embedding (RAG) checkbox and select pinecone in Select index (RAG) field in chatbot configuration.
12.Click Save button
13.Put chatbot’s shortcode to any page or post on your website
14.Try to use
More detailed instruction on how to set up RAG feature you can fin on this page.
Image generation setup.
Image generation feature requires only API key. It is ready to use by default. You can configure generation options on the Image Generation tab. On the same tab you can generate and store new images using Dall-e-2 and Dall-e-3 models.
Instruction setup.
Select page types you want to display metabox of the S2B AI assistant plugin at the configuration page.
Select models you want to use in the S2B AI assistant plugin.
The S2B AI assistant plugin enables you to create and manage instructions for ChatGPT. You can store these instructions in a database and use them in your requests. To access the instructions, simply switch to the ”Instructions” tab. From there, you can add, edit, delete, enable, or disable instructions. Additionally, you can search for specific instructions by entering text in the ”Search Instructions” input box.
For additional instructions and ideas, please visit our page or OpenAI best practice page
Post types setup.
The S2B AI Assistant plugin is accessible by default in the metabox displayed beneath the edit area for two post and page types. However, if desired, you have the option to enable it on other post types’ edit pages. To do so, navigate to the General setup tab and select the desired post types.
Vanliga frågor
-
How many different chat bots can I create?
-
As many as you want. Each chatbot can have different position, size, colors, behavior and other elements.
-
Can I customize the appearance of the chatbot?
-
Yes. You can change position, size, colors, behavior of each chatbot separately in Chatbots and Assistants tabs of configuration page.
-
Which difference between chatbots and assistants?
-
Actually they are two different types of chatbot. Assistants use OpenAI Assistant API, while Chatbots use OpenAI completion API to answer visitor’s questions. Using Assistant API you can upload file to add additional information to chatbot’s knowledge database. This allows you to create content aware chatbot.
-
How can I change icon of chatbot
-
First upload icon to Media Library. Then copy its url and paste it into ”Url of chatbot picture:” field.
-
Which OpenAI models does the plugin use?
-
Any model that is accessible for your OpenAI account. You just need to open Settings page and switch to Models tab. After click ’Refresh from OpenAI’. All models will be attached to plugin. Then just select models you want to use.
-
How does S2B AI Assistant handle image generation?
-
S2B AI Assistant leverages the DALL-E model for image generation. You can specify prompts in the command line within the plugin, and S2B AI Assistant will generate unique images, logos, banners, and more, requiring no design skills from the user.
-
The S2B AI Assistant is NOT working in the front end.
-
The primary cause for this issue is often incorrect theme coding and jQuery being loaded from an external source. WordPress core already includes jQuery, and as per WordPress standards, it should be included using wp_enqueue_script. https://developer.wordpress.org/reference/functions/wp_enqueue_script/ . Verify if this is happening in your theme.
Recensioner
Bidragsgivare och utvecklare
”S2B AI Assistant – ChatBot, ChatGPT, OpenAI, Content & Image Generator” är programvara med öppen källkod. Följande personer har bidragit till detta tillägg.
Bidragande personerÖversätt ”S2B AI Assistant – ChatBot, ChatGPT, OpenAI, Content & Image Generator” till ditt språk.
Intresserad av programutveckling?
Läs programkoden, kika på SVN-filförvaret eller prenumerera på utvecklarloggen via RSS.
Ändringslogg
1.6.4
- Add RAG support
- Fix upload file on Assistant API tab.
1.6.3
- Allow to apply custom css rules to any chatbot and assistant
- Fix sizes of textarea elements in configuration page
1.6.2
- Add feature to copy shordcode of chatbot
- Make default models: gpt-4o, gpt-4o-mini, gpt-4
1.6.1
- Add ability to run chatbot without modal window
- Add view_mode parameter which allows to modify view of chatbot via shortcode
1.5.9
- Added ability to show notification that explains users that conversation is logged
1.5.8
- Feature that allows you to create multiple different Assistants
1.5.5
- Fix deprecation message
1.5.4
- Fix logging feature
1.5.3
- Feature that allows create different chatbots for different pages. Removed outdated gpt 3.5 models as default.
1.5.2
- Conversation Logging feature added for other apis
1.5.1
- Conversation Logging feature added
1.4.2
- Fix configuration
1.4.1
- Added content aware AI chatbot using Assistant API
1.3.3
- Small fixes
1.3.2
- Small fixes
1.3.1
- Added AI chatbot feature= 1.2.2 =
- Adding fixes
1.2.1
- Image generation feature added
1.1.2
- Security fixes
1.1.1
- Add feature that allows to change access to different parts and functions of plugin.
1.0.1
- Some ui improvement.
1.0.0
- Launch!