AI Assistant with Brand Kit

The AI Assistant is a powerful natural language processing app that efficiently processes, transforms, and generates content with human-like accuracy.

Its flexible architecture seamlessly integrates with Brand Kit, enabling content creation from the Knowledge Vault or LLM, ensuring consistency across digital touchpoints.

By setting up Brand Kit, the AI Assistant applies your brand's guidelines, styles, and preferences, ensuring all generated content aligns perfectly with your brand identity for a cohesive audience experience.

You can install the AI Assistant app directly from our Marketplace and use it within your entries to generate brand-specific content.

Additional Resource: For more details, refer to the Brand Kit documentation.

Prerequisites

• Contentstack account
• Brand Kit enabled for your Contentstack Organization
• Access to the Contentstack Organization/Stack as the Owner/Admin

Note: If Brand Kit is not enabled for your Organization, the AI Assistant app operates as usual. Please follow the AI Assistant App Installation Guide to see how it works in this scenario.

Follow this step-by-step guide to install the AI Assistant app within your stack.

Steps for Execution

1. Install the AI Assistant app in Marketplace
2. Use the AI Assistant app within your entry

1. Install the AI Assistant App in Marketplace

   To install the AI Assistant app, log in to your Contentstack account and follow the steps below:

   1. From the left-hand side primary navigation, click the Marketplace icon.
   2. Click Apps from the left panel.
   3. Within the Marketplace, you can see all the available apps. Hover over the AI Assistant app and click Install.
   4. In the pop-up window, select the stack where you want to install the AI Assistant app, accept the Terms of Service, and click the Install button.
   5. On the Configuration page, enter the following details:
      1. Platform Configuration: Select the Managed by Contentstack option to configure the app using Contentstack powered API keys. To integrate Brand Kit with the AI Assistant app, click Enable inside the Brand Kit: On-brand Generative AI section to activate the use of AI for content creation.

         After adding the details, click Save and Proceed.

         

         Note: You can configure Custom Credentials settings for the AI Assistant app without Brand Kit. Refer to the AI Assistant App Installation Guide configuration section.

      2. Advanced Configuration: You can create custom actions to use AI within your entry fields.

         Perform the following steps to create a Custom Action:

         1. Click the + Create Action button.
         2. In the Add your custom prompt section, enter the Custom Name, upload the Icon (in SVG format), enable or disable Include Field data option, and provide the required Prompt.

            You can group similar prompts together by adding sub-actions for the main prompt.

         3. To add a sub-action, click + Create Sub-action Prompt and follow the steps given below:
            1. You can also toggle Enable search for sub-action to have a search bar filter for your sub-actions.
            2. In the Add the custom option section, enter a Display Name and Value for your sub-action.
            3. You can add, delete, or reorder the sub-actions.

            For example, your prompt is "Shorten this text by {{selected_option}}". In the sub-action prompt, you can provide a value that will customize your prompt further. Suppose, you enter 10% in the Value field, then, the final prompt will be "Shorten this text by 10%".

            Note: "{{selected_option}}" must be included in the prompt if you want to add sub actions.

            
         4. Choose the option to Perform action on. You can select whether to apply the action on the Current Field or Other Field.
         5. To View Custom Action on, select the Entry Field checkbox(s) to view the app in the entry field. If you select the When JSON RTE field content is selected checkbox, you will be able to perform actions only on the selected content in the JSON Rich Text Editor field.
         6. Then, click Save or Save and Proceed to save the advanced configuration settings.

         You have successfully configured the AI Assistant app with Brand Kit.

         
   6. Click Save to save the app configurations.
   7. On the UI Locations tab, you can see the predefined app locations. You can use the toggle button corresponding to each UI location to enable or disable it based on your requirements.

      Additional Resource:

      • To use the AI Assistant app in your stack, configure the field type(s) for the Field Modifier UI Location. Refer to the Field Modifier UI Location documentation for details.
      • For more information on UI locations, please refer to the Installed Apps guide.
   8. Once done, click Open Stack to start using the AI Assistant app.

2. Use the AI Assistant App within your Entry

   To use the AI Assistant app within the entry of a stack, follow the steps given below:

   1. Go to the stack where you have installed the AI Assistant app, click the Content Models icon from the left navigation panel, and click the + New Content Type button.
   2. Create a content type by adding relevant details as displayed below:
   3. To use the AI Assistant app, let's create an entry in the newly created content type. In the left navigation panel, navigate to the Entries page, click + New Entry to create a new entry for the above content type, and then click Proceed.
   4. You can see the AI Assistant app in the Field Modifier location.
   5. Click the AI Assistant app icon, a pop-up appears.
   6. A panel opens up. Click the Brand Kits drop-down and select the required Brand Kit. Then, from the Voice Profiles drop-down, select the applicable Voice Profile. If you want to generate content from the Knowledge Vault, enable it. If you disable it, the AI Assistant app will generate content directly from the LLM (Large Language Models).

      Additional Resource:

      • To know more about Brand Kit, Voice Profile, and Knowledge Vault, refer to the Brand Kit, Voice Profile, and Knowledge Vault documentation.
      • To start using the Brand Kit with the AI Assistant app, refer to the Get Started with Brand Kit documentation.
      

      Note: If you don't want to use Brand Kit or if it is disabled for you, you can still use all the AI Assistant options for creating generic or non-brand specific content.

      You are now ready to use the AI Assistant app. Enter the prompt to start generating the content.

      

      When you press enter, the AI Assistant app generates text based on the communication style settings that you used while configuring the voice profile.

      To stop the app from generating the content, click Stop Generating.

      

      After the app generates the content, it offers three options: Accept, Try Again, and Cancel, as shown in the screenshot below.

      Click Accept to accept the current content changes or to overwrite the existing content with the newly generated content. To rephrase the content, click Try Again and to discard the generated content , click Cancel.

      

   The AI Assistant app categorize the content generation in three categories:

   • Custom Actions
   • Replace field content
   • Generate based on another field

   Custom Actions

   You can see the Custom Actions that you configured in the advanced configuration settings in step 1.

   

   Note: The AI Assistant options in the UI can be changed or edited by the Contentstack authorized team member or an Organization Owner/Admin.

   You can use the Custom Actions defined in the configuration and transform your content.

   

   In the above example, there is a custom action to “Shorten text by 50%”. You can see the output as per the custom action:

   

   If the Custom Action has any sub-action(s), then the sub-action(s) can be displayed in the form of a dropdown when you hover over the custom action.

   

   You get options to transform the content, such as:

   • Rewrite the field content
   • Shorten this text
   • You can also provide custom commands for a field

   Let’s see one of them with an example.

   Navigate to the Title field. Click the AI Assistant app icon and then click Rewrite the field content option.

   

   This re-phrases the existing content for better understanding.

   

   Replace field content

   You can replace or modify the content using the following predefined actions.

   

   Let’s see each one of them with an example:

   • Optimize text for SEO

     The AI Assistant Optimize text for SEO predefined action empowers you to create highly search-optimized content, driving more organic traffic and improving your website's overall search rankings. This action will Identify keywords and key phrases, and simply generate the SEO optimized text.

     

   • Change tone

     The AI Assistant Change tone predefined action allows you to change the tone and style of the existing content using four options: Persuasive, Straightforward, Friendly, and Professional.

     

   • Change length

     The AI Assistant Change length predefined action helps increase or reduce the length of the existing content.

     You can use Longer to add more content.

     

     You can useShorter to shorten up the content.

     

   • Translate to current locale language

     You can also enter custom commands to generate content based on the command for the entry field. You can add and use the following variables in the custom command as placeholders for dynamic content.

     • Field Data

       {{field_data}}: Use this variable to store the current field content in the custom command box for manipulation. The field_data placeholder can hold the value of the current field’s content.

       Suppose you want to rephrase the content in the Blog Name field then you can provide the following command in the custom box and click enter:

       Rephrase this text to: {{field_data}} OR Summarize this text: {{field_data}}

       

       In our example, it can generate new content for the Blog Name field as shown below:

       

       Note: If you do not add the {{field_data}} variable in the custom command, the field content is automatically added at the end of the custom command.

     • Current Locale

       {{current_locale}}: Use this variable to translate the field content in different locales. The {{current_locale}} placeholder can hold the value for the current locale in which you want to translate the field content.

       Suppose you want to rephrase the content in the Blog Name field then you can provide the following command in the custom box.

       Translate this text to {{current_locale}}:{{field_data}}

       

       In our example, our locale is English and we are translating it to French locale. This can generate the content in the specified locale for the Blog Name field as shown below:

       

   Generate based on another field

   You can also generate content for one field based on the content of another field.

   The AI Assistant app lets you generate the following content based on another entry field.

   

   Let’s see each of them with some examples as shown below:

   • Outline

     To generate an outline for the Blog Summary field based on the Title of the entry, navigate to the Blog Summary field, click Outline, and then click the Title field.

     

   • Summary

     Now, to generate a Summary for the Blog Summary field based on the Blog Name, navigate to the Blog Summary field, click Summary, and then click Blog Name.

     

   • SEO Tags

     To generate SEO Tags for the Tags field based on the Blog Name, navigate to the Tags field, click SEO Tags, and then click Blog Name.

     

   • Blog Posts

     Now, to generate a Blog Post for the Blog Content field based on the Blog Summary field, navigate to the Blog Content field, click Blog Posts, and then click Blog Summary.

     

   • Headline

     To generate a headline for the Blog Name field based on the Blog Summary of the entry, navigate to the Blog Name field, click Headline, and then click the Blog Summary field.

     

   • User Persona Tags

     To generate a user persona tag for the Blog Content field based on the Blog Summary of the entry, navigate to the Blog Content field, click User Persona Tags, and then click the Blog Summary field.