# Brand voice and style Agent

## Overview

> info **PREREQUISITES**:
>
> * You must have an active Sitefinity AI subscription.\
>   For more information, see [Sitefinity AI](https://www.progress.com/documentation/sitefinity-cms/cloud/ai-powered-capabilities/sitefinity-ai).
> * This capability is available in Sitefinity Cloud setup starting with version Sitefinity 15.4.8631.
> * Using this AI agent on page level is supported only for ASP.NET Core and Next.js pages.

The *Brand voice and style* agent is powered by AI to help content editors ensure that Sitefinity content and pages align with the organization's defined brand voice.

When configuring this built-in AI agent, you manually input your personalized brand guidelines - by including tone-of-voice rules, writing style guidelines, formatting standards, and approved terminology.\
The *Brand voice and style* agent analyzes your content and pages, and generates in-context actionable suggestions for improvements, as instructed by your brand-compliant guidelines.

You can interact with the *Brand voice and style* agent in your Sitefinity backend in two ways:

* During your content editing experience, where you can apply actionable AI-generated recommendations.
* Through [DX Assistant](https://www.progress.com/documentation/sitefinity-cms/cloud/dx-assistant), an AI-powered chat experience available starting with version Sitefinity 15.4.8633.

## Configure the Brand voice and style agent

> info **NOTE**: With an active Sitefinity AI subscription, you can start using the *Brand voice and style* agent out of the box, as the agent is enabled in your Sitefinity backend.\
> To get personalized AI suggestions, а site administrator must first configure the behavior of the agent through the *AI agents* module.

To configure the *Brand voice and style* agent individually, perform the following:

1. Log in to your Sitefinity backend with *Administrator* privileges.
2. Navigate to *Administration* » *AI agents* and click *Brand voice & style*.\
   The *AI agent properties* screen opens.
3. In *Agent name*, you can optionally change the default agent name.
4. In *Enable this agent*, you can optionally disable this AI agent by selecting *No*.\
   The default setting is *Yes*.
5. In *Available in the backend chat assistant*, you select the desired setting.\
   The default setting is *Yes*. This allows backend users to request this agent to perform various content-related tasks through interacting with DX Assistant chat experience.\
   If you do not intend to access and use this agent through the chat assistant, select *No*.
   > info  **NOTE**: This configuration option is available for Sitefinity AI agents starting with version Sitefinity 15.4.8633.
6. In *Generate suggestions while editing content*, specify if you want to allow this agent to generate in-context suggestions while creating or editing Sitefinity content and pages.\
   The default setting is *Yes*.
7. In *Instructions*, you manually feed your personalized brand guidelines to instruct the AI agent. This prompt is sent to the Large Language Model (LLM) when the agent is executed.\
   No special format is required. You can include tone-of-voice rules, writing style guidelines, formatting standards, approved terminology, and other standards that define your brand.\
   If your organization has an individual Style Guide, you can paste the relevant parts in this system prompt.
8. For multisite setup, under *This agent works with...*, select the desired option:
   * *All sites* (default option) - use this option if you want this AI agent to work consistently across all your sites.
   * *Selected sites* - use this option if you want to configure AI agent for a specific site, for example, when your organization has more than one brand defined.
9. Under *For content types and fields...*, select the desired option:
   * *All content types and fields* (default option) - use this option if you want this AI agent to suggest improvements for all available content types and fields.
   * *Selected content types and fields...* - use this option if you want this AI agent to suggest improvements only for specific content types selected here.
10. In the *Tools* section, under *This agent can use the following tools*, select the Sitefinity tools this agent can invoke to execute AI-driven tasks and operations on behalf of the user.
    > info  **NOTE**: The *Tools* configuration option is available for Sitefinity AI agents starting with version Sitefinity 15.4.8633.
    Tools are exposed by Sitefinity MCP Server to enable Sitefinity AI agents safely perform tasks and operations on Sitefinity content and pages - through the integrated chat experience or during your content editing experience. You can select structured tools related to content items, pages, classifications, media items and libraries, CRUD operations on content items, and more.\
    Tools that require explicit **user approval** for high-impact or destructive actions, are indicated on the UI and are only invoked through DX Assistant chat experience.
    1. To add tools, click ![Add](https://www.progress.com/documentation/sitefinity-cms/cloud/assets/68f42a105be1c7bbb193b14eeea38af6/add-button.png "Add") (*Add*).
    2. Select the desired tools on the *Select tools* screen that opens.
    3. Click *Use selected* to confirm your choice.
    For more information about the available MCP tools, see Sitefinity MCP Server » [Exposed tools](https://www.progress.com/documentation/sitefinity-cms/cloud/mcp-server#exposed-tools).
11. In the *Agent identity* section:
    * In *Short name*, you can modify the shorter version of the AI agent name.\
      The short name is used where space is limited in the UI.
    * In *Agent ID*, you can modify the unique identifier generated for this AI agent (used internally by the AI agents workflow orchestration).
12. Save your changes.\
    If needed, you can restore the default system settings for this AI agent by clicking *Restore to default*.

> info  **NOTE**: Built-in AI agents cannot be deleted, unlike custom AI agents.

## Use the AI agent on content items

Once configured, the *Brand voice and style* agent is integrated directly into the Sitefinity content editing experience and ready to surface personalized suggestions when you open a content item for editing.

When opening an existing content item for editing or creating a new one (such as Blogs, News, and Events), the AI agent analyzes the affected content fields and generates various recommendations - according to the configured behavior of the agent.\
Content editors get a notification icon ![Content suggestions](https://www.progress.com/documentation/sitefinity-cms/cloud/assets/2aec07d5c219079dac7cefa66d71f153/ai-suggestions-icon.png "Content suggestions") (*Content suggestions*) on their active screen indicating the counter of all AI-generated suggestions for the currently open content item.\
By clicking on this icon, content editors access the AI-generated suggestions through the *Content suggestions* sidebar on the screen.

The provided suggestions are actionable and are grouped by the individual sections and fields of the currently open content item.

> info  **NOTE**: If custom AI agents are configured in your Sitefinity backend, multiple AI agents (including the built-in agents) can be activated to analyze the same content. In this scenario, some of the generated AI suggestions may overlap so they are aggregated before being surfaced. AI agents workflow orchestration is introduced to coordinate the execution order and manage conflicts between the involved agents.\
> For more information, see [AI agents workflow orchestration and conflict handling](https://www.progress.com/documentation/sitefinity-cms/cloud/ai-powered-capabilities/custom-ai-agents#ai-agents-workflow-orchestration-and-conflict-handling).

### User actions on AI-generated suggestions

When reviewing the AI-generated suggestions in detail, content editors can perform the following actions available in the *Content suggestions* sidebar:

* Filter the AI suggestions available on the user interface, provided multiple AI agents are configured in your Sitefinity backend - by clicking ![Edit](https://www.progress.com/documentation/sitefinity-cms/cloud/assets/8afd240d47ce5e27c5d697a63f962b8d/edit.png "Edit") button next to the *Show* dropdown.\
  The generated suggestions can be filtered out per selected AI agent, or all suggestions are displayed together.
* Apply the suggested change directly - by clicking the *Apply* button, while reviewing the details of a content suggestion.\
  The textual change are persisted/stored in the system when the content editor saves or publishes the updated content item.
* Discard the suggested change - by clicking the *Dismiss* button, while reviewing the details of a content suggestion.
* Preview the suggested change applied inline in the content editor - by clicking *Preview in editor*.\
  Content editors need to confirm if they want to apply or discard the previewed change.
* Restart the execution of the AI agent - by clicking ![Refresh AI suggestions](https://www.progress.com/documentation/sitefinity-cms/cloud/assets/d1c39ba66ee74e9c8087dc5639720b43/refresh-ai-suggestions.png "Refresh AI suggestions") (*Refresh AI suggestions*).\
  This action may result in receiving different content suggestions as the AI agents can adapt and learn from the rejected suggestions.

## Use the AI agent on pages

Using the *Brand voice and style* agent on page level is supported only for ASP.NET Core and Next.js pages.

By default, the AI agent is ready to surface personalized suggestions when you open a page for editing or create a new page. The AI agent analyzes the page content, including the page template used and the page title. It generates various brand-compliant recommendations according to the configured behavior of the agent.\
Content editors get a notification icon ![Page suggestions](https://www.progress.com/documentation/sitefinity-cms/cloud/assets/2aec07d5c219079dac7cefa66d71f153/ai-suggestions-icon.png "Page suggestions") (*Page suggestions*) on their active screen indicating the counter of all AI-generated suggestions for the currently open page.

Content editors access the AI-generated suggestions for the current page through the *Page suggestions* sidebar on the screen.\
The provided suggestions are actionable and are grouped by the individual sections, the page template and widgets used by the current page. The title of the page is also in scope.

### User actions on AI-generated suggestions

When reviewing the AI-generated suggestions in detail, content editors can perform the following actions available in the *Page suggestions* sidebar:

* Filter the page suggestions available on the user interface, provided multiple AI agents are configured in your Sitefinity backend - by clicking ![Edit](https://www.progress.com/documentation/sitefinity-cms/cloud/assets/8afd240d47ce5e27c5d697a63f962b8d/edit.png "Edit") button next to the *Show* dropdown.\
  The generated suggestions can be filtered out per selected AI agent, or all suggestions are displayed together.
* Apply the suggested change directly - by clicking the *Apply* button, while reviewing the details of concrete suggestion.

  > info  **NOTE**: For *Content block* and *Image* widgets only, you can directly apply the AI suggestions in-context in the page editor. The *Apply* button works for both static and shared content blocks.

  The textual change will be persisted in the system when the content editor saves and/or publishes the updated page.
* Discard the suggested change - by clicking the *Dismiss* button, while reviewing the details of a page suggestion.
* Preview the suggested change - by clicking *Go to page template* or *Go to Title & Properties* or similar button.\
  Content editors are navigated away to the target, where they can manually apply the recommended change.
* Restart the execution the AI agent - by clicking ![Refresh AI suggestions](https://www.progress.com/documentation/sitefinity-cms/cloud/assets/d1c39ba66ee74e9c8087dc5639720b43/refresh-ai-suggestions.png "Refresh AI suggestions") (*Refresh AI suggestions*).\
  This action may result in receiving different page-level suggestions as the AI agents can adapt and learn from the rejected suggestions.
