AIRA configuration

AIRA is an AI-powered agent that can increase the productivity of content editors, marketers and copywriters by offering in-product guidance and automating content-related tasks with the use of various AI-backed features.

Privacy and data protection

All data processed by AIRA is commercially protected.

Neither Kentico nor the underlying AI models store or log raw customer data inputs, prompts, or responses generated when using AIRA features. All data is discarded after each interaction with AIRA and is not used to train the underlying models. To learn more, see the privacy guarantees provided by Microsoft Azure for Azure OpenAI model privacy and Azure Image analysis privacy.

AIRA credit balance

To view your AIRA credit balance:

1. Open the AIRA application.
2. On the Overview tab, you can see the amount of credits you have available and information about the next credit renewal.

To increase your credit balance, select the Get more credits button and fill out the request form.

Manage AIRA features

All AIRA features are active by default. However, you can turn specific AIRA features off, should your project require it.

1. Open the AIRA application.
2. Switch to the Feature settings tab.
3. Deselect the AIRA features you don’t want users to use in the project.
4. Save the settings.

AIRA file storage

Images uploaded by users to the AIRA chatbot interface are stored in the ~/assets/aira project folder. These files persist for up to 48 hours, before being removed by the AIRA conversation attachment cleaner scheduled task.

If you use file system mapping of the ~/assets folder to a shared storage, such as Azure Blob storage or Amazon S3, make sure the ~/assets/aira subfolder is included in the mapping.

Disable AIRA globally

To globally disable all AIRA features, including in-product guidance in your project:

1. Open your Xperience project.
2. In the appsettings.json file, add a new configuration key: "CMSEnableAira": false.
3. Save your project.

All AIRA features are now disabled in your project.

Configure AIRA content generation

You can adjust the behavior of specific AIRA features by configuring the following settings:

1. Open the AIRA application.
2. Switch to the Content generation tab.
3. Select the AIRA category and configure the settings:
   • Excluded content types – allows you to simplify the selection of content sources when generating content for email fields. Items of the specified content types (for reusable content) will not be offered. For example, we recommend excluding content types that only store image content without text.
   • Tone of voice guidelines – allows you to describe your organization’s tone of voice guidelines (professional, simple, humorous, etc.). AIRA will use this tone when generating content for email fields or when translating content. If not specified, AIRA uses a neutral tone.
4. Save the settings.

The settings apply globally for all content types and fields that support the AIRA features across the system.

Configure AIRA translations

You can adjust the behavior of AIRA translations, which is used for the translation of content items and translation of pages. To configure AIRA translations:

1. Open the AIRA application.
2. Switch to the Translations tab.
3. Select the data types allowed for translations.
   • Allows you to choose the field data types you want translated (e.g., Long text, Text, Rich text (HTML), etc.).
4. Specify instructions for translations.
   • Allows you to add custom instructions for how your content should be translated by AIRA, for example, brand terminology, formatting rules, words to leave untranslated, etc.
     
5. Set whether to use tone-of-voice guidelines for translations.
6. Save your changes.

The AIRA translations are now configured.

Configure translation of specific fields

All content type fields of the data types allowed for translations are automatically enabled for translation. To specify which content type fields you want to translate:

1. Open the Content types application.
2. Select a content type.
3. On the Fields tab, select which fields you want to configure the translation for.
4. Expand a field and scroll down to the AIRA features section.
5. Select or clear the Include field in translation checkbox.
   • The checkbox is only available if the data type of the field is allowed to be translated.
6. Save your changes.

You have successfully configured translation for a specific field.

Configure translation of Page Builder component properties

You can specify which properties of Page Builder components (widget, section, etc.) you want to exclude from translation using the ExcludeFromAiraTranslation attribute.

using Kentico.Xperience.Admin.Base;
using Kentico.PageBuilder.Web.Mvc;

public class TextWidgetProperties : IWidgetProperties
{
    [ExcludeFromAiraTranslation]
    public string Text { get; set; } = string.Empty;
}

Configure Content Strategist Agent

The Content Strategist Agent helps you create and manage Content Strategies for your project. You can enable or disable the agent and manage Content Strategy artifacts.

To configure the agent and its artifacts, assign the required AIRA permissions in Role management. To view and download the Content Strategy, content governance roles need the View artifacts permission. They also need the Manage artifacts permission to create, update, or delete the Content Strategy artifact.

Enable or disable the Content Strategist Agent globally

To enable or disable the Content Strategist Agent globally:

1. Open the AIRA application.
2. Navigate to the Agents tab.
3. In the Content Strategist Agent, select Edit.
4. Select or clear the Enable agent checkbox.
5. Save the settings.

Create or update Content Strategy

You can create or update your Content Strategy in two ways:

Create or update through AIRA

Start a conversation with AIRA and ask it to create or update a Content Strategy. When AIRA generates the strategy or adjusts the existing one, you will be prompted to allow the Save content strategy action. Once approved, AIRA saves the Content Strategy under the Artifacts tab.

Upload existing Content Strategy

1. Start a conversation with AIRA.

2. Provide your existing Content Strategy as text.

   The maximum allowed message length is 20K characters.

3. Ask AIRA to save it as the Content Strategy.

4. When prompted by AIRA, select Allow to save Content Strategy.

The Content Strategy is now saved and available on the Artifacts tab or directly in the AIRA chat interface.

Download Content Strategy

To download the current Content Strategy:

1. Open the AIRA application.
2. Select the Artifacts tab.
3. Download () the content-strategy.md file.

Delete Content Strategy

To delete the current Content Strategy:

1. Open the AIRA application.
2. Select the Artifacts tab.
3. Delete () the content-strategy.md file.

Add AIRA features to your content types

Some AIRA features need to be manually enabled for individual fields of your content types:

1. Open the Content types application.
2. Select a content type.
   AIRA features are currently not supported in reusable field schemas.
3. On the Fields tab, select which fields will have AIRA features. You can enable AIRA features for fields:
   • With the Text, Long text, Rich text (HTML), or Taxonomy data type.
   • Using the Rich text editor, Text area, Text input, or Tag selector form component.
4. Expand a field and scroll down to the AIRA features section.
5. Select Add AIRA feature and choose the feature you want to enable:

   • Generate image description during mass upload – generates an SEO-friendly description of an image based on its content during mass upload.

   • Automatically assign tags to images during mass upload – automatically assigns tags from the defined taxonomy group based on the image content during mass upload.

   • Generate email content – generates email content based on reusable content items stored in the Content hub, external content specified by web URLs, or a custom description. You can globally configure which content types are available as content sources.

     For fields using the Rich text editor form component, the Generate email content feature also automatically enables rich text editor refinements.

   • Generate email subject based on email content – generates email subject suggestions based on the content of other fields. Use the feature for the EmailSubject system field of email content types.

     1. Select Continue.
     2. Choose which fields of the content type will serve as the content source. Supported field data types are Text, Long text, Rich text (HTML) or Content items. The same data types are supported when loading content from the fields of linked content items. The maximum length of the total source content is 10 000 characters (if exceeded, a warning is displayed to the user and content over the limit is truncated).
     3. Select Save.

   • Rich text editor refinements – supported for text fields using the Rich text editor form component. Allows editors to select text and refine it in place using predefined options (make text shorter, improve writing and grammar, etc.), or apply a custom prompt and send it to AIRA for refinement.

6. Save the field editor.

The selected AIRA feature is now enabled for the given field.

Repeat the process for all fields and content types where you wish to enable the AIRA features.

Rich text refinements in Page Builder and Email Builder

In Page Builder and Email Builder, the rich text editor can appear directly on the respective builder tabs as an inline editor or in the configuration dialog for component properties.

Rich text editor refinements are automatically enabled for the rich text inline editor. Refinements in this context can be deactivated by disabling the entire Rich text editor refinements feature. Refinements in the property configuration dialog need to be enabled by developers.

Enable rich text refinements in property configuration dialog

To enable rich text refinements in the configuration dialog, apply the FormComponentConfiguration attribute with AiraTextRefinementConfigurator as the configurator type to component properties that use the rich text editor as their editing component.

The example below shows how to enable text refinements for a Page Builder widget property:

using Kentico.Xperience.Admin.Base;
using Kentico.Xperience.Admin.Base.FormAnnotations;
using Kentico.PageBuilder.Web.Mvc;

public class MyWidgetProperties : IWidgetProperties
{
    
    [RichTextEditorComponent]
    // Enables AIRA rich text refinements for the rich text editor editing component
    [FormComponentConfiguration(typeof(AiraTextRefinementConfigurator))]
    public string RichText { get; set; }
}