Brand voice and style Agent
Overview
PREREQUISITES:
- You must have an active Sitefinity AI subscription.
For more information, see Sitefinity AI.- The article describes the latest design and bahavior of this built-in AI agent, which is available in self-hosted Sitefinity setup 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 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 generates actionable suggestions to harmonize the brand voice and optimize writing style - as per your brand-compliant guidelines - while preserving the author's intent.
Upon interacting with the AI agent, content editors can apply consistent personalized recommendations for content items and pages, which are displayed in-context during their authoring experience.
Configure the Brand voice and style agent
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 content suggestions, your site administrator must first configure the behavior of the AI agent via the AI agents module.
To configure the Brand voice and style agent, perform the following:
- Log in to your Sitefinity CMS backend with Administrator privileges.
- Navigate to Administration » AI agents and click Brand voice & style.
The AI agent properties screen opens. - In Agent name, you can optionally change the default agent name.
- In Enable this agent, you can optionally disable this AI agent by selecting No.
The default setting is Yes. - 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. - 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.
- 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.
- 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).
- In Short name, you can modify the shorter version of the AI agent name.
- Save your changes.
You can also restore the default system settings for the AI agent by clicking Restore to default.
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) 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.
NOTE: If custom AI agents are configured in your Sitefinity CMS backend, multiple AI agents, including the built-in agents, can be activated to analyze the same content item. 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.
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
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).
This action may result in receiving different content suggestions as the AI agents can adapt and learn from the rejected suggestions.
NOTE: No content changes can be applied by the AI agent itself without a human in the loop.
Use the AI agent for 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) 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 AI suggestions available on the user interface, provided multiple AI agents are configured in your Sitefinity backend - by clicking
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.
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).
This action may result in receiving different page-level suggestions as the AI agents can adapt and learn from the rejected suggestions.