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.

Adjust the tone of voice

You can adjust the behavior of AIRA content generation and AIRA translations by specifying the tone of voice guidelines:

1. Open the AIRA application.
2. Switch to the Content generation tab.
3. Fill in the Tone of voice guidelines:
   • You can describe your organization’s tone of voice guidelines (professional, simple, humorous, etc.). AIRA will use this tone when generating content 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 with the relevant AIRA features enabled.

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 or a reusable field schema.
3. On the Fields tab, select the field for which you want to enable AIRA features. You can add AIRA features to 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.
   • 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. Unlike content generation refinements, which replace all text in the field, rich text editor refinements allow you to select and refine specific sections of text.
   • Generate content – generates text content for the field based on the context from other fields and AIRA instructions. Also allows users to refine existing text. Available for fields with the Text, Long text, or Rich text (HTML) data type. See Configure AIRA content generation and refinements for the full configuration.
     1. Select Continue.
     2. Provide AIRA instructions describing the purpose of the field and any guidance for content generation.
     3. Select Save.
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.

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 AIRA content generation and refinements

AIRA content generation and refinements allow editors to quickly generate and refine content in text-based fields in pages, emails, content items, and headless items. AIRA makes use of the available context from the item to simplify editors’ work and provide relevant content.

Prerequisites

• Make sure that the AIRA setting Content generation and refinements is enabled.
• Optional configuration: If you want to use a specific tone of voice for generation, adjust it in the AIRA application.

Enable content generation for a content type field

The feature is available for content type fields with the Text, Long text, and Rich text (HTML) data types. To enable the feature:

1. Open the Content types application.
2. Select a content type.
3. On the Fields tab, select and expand the field for which you want to enable content generation.
4. In the AIRA features section, add the Generate content AIRA feature.
5. Select Continue.
6. Specify instructions for generation of text content in this field and Save them.
7. Save the changes and repeat as necessary.
8. Make sure that at least one field is used as context for generation.

Configure the context for generation

AIRA uses information from other fields in the item to generate relevant content. Fields of the following types can be included in the context for generation: Text, Long text, Rich text (HTML), Date, Date and time. By default, new fields of these types are automatically used as context unless you change the configuration. We recommend excluding fields that do not hold relevant content and could lower the quality of the generated content.

AIRA also takes into account the instruction specified when adding the feature to the field and other information about the field, such as its name and size limit.

Include or exclude fields from the context

To modify the generation context for an existing content type:

1. Open the Content types application.
2. Select a content type.
3. On the Fields tab, select a field to include or exclude in the context for content generation.
   • The fields with the following types can be used as context: Text, Long text, Rich text (HTML), Date, Date and time.
4. In the AIRA features section, select or clear the Use field’s content as context for AIRA content generation checkbox.
5. Save the field.
6. Make sure that at least one field remains included in the context in order for the generation to work.

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 Content generation and 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; }
}