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 for self-hosted Sitefinity CMS setup as of 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 CMS content aligns 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 CMS 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 the Brand voice and style agent.
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.
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.
You can also update the guidelines at a later point in time, if needed.
- 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 edit the unique identifier generated for this AI agent (used internally by the AI agents workflow orchestration).
- Save your changes.
You can also restore the default settings for the AI agent by clicking Restore to default.
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.
When multiple AI agents are activated for the same task (built-in and custom agents), all agents are executed in a strictly coordinated order and some of the generated AI suggestions may overlap - these suggestions are already aggregated and merged before being surfaced.
Content editors will 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 the notification icon, content editors access all AI-generated suggestions integrated in the Content suggestions sidebar.
The AI suggestions are actionable and are grouped by the individual sections and fields of the currently open content item.
NOTE: If you also have custom AI agents configured in your Sitefinity CMS backend, multiple AI agents can be activated to analyze the same content item. These activated AI agents interact with each other while working in parallel - they all work in an orchestrated workflow.
In this scenario, some of the generated AI suggestions can overlap so they were aggregated and merged before being surfaced. On the user interface, these AI suggestions visually indicate which AI agents contributed to them.
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 CMS 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 will be persisted/stored in the system when the content editor saves and/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 page editor - by clicking Preview in editor.
Content editors need to confirm if they want to apply or discard the previewed change.
- Restart the tasks performed by the AI agent - by clicking
(Refresh AI suggestions).
This action will possibly 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.
By clicking the notification icon, content editors access all AI-generated suggestions integrated in the Page suggestions sidebar.
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:
Additional resources
Sitefinity AI overview