Search engine optimization 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 built-in Search engine optimization agent is powered by AI to help content editors ensure that Sitefinity CMS content and pages align with SEO best practices.
The AI agent is integrated directly into the Sitefinity content editing experience and is designed to work efficiently with existing workflows for pages and content items in Sitefinity CMS backend.
The Search engine optimization agent analyzes your content and generates actionable suggestions (also on page level) upon detecting any issues or under-optimized content.
Upon interacting with the AI agent, content editors can apply consistent recommendations for content items and pages, which are displayed in-context during their authoring experience.
Configure the Search engine optimization agent
NOTE: With an active Sitefinity AI subscription, you can start using the Search engine optimization agent out of the box, as the agent is preconfigured and enabled in your Sitefinity CMS backend.
If you want to configure the AI agent individually, you can do so via the AI agents module.
Perform the following:
- Log in to your Sitefinity CMS backend with Administrator privileges.
- Navigate to Administration » AI agents and click the Search engine optimization 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 can optionally edit the preconfigured system prompt according to your individual needs.
These instructions guide how the AI agent analyzes the content and performs its tasks.
- 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 this AI agent to work only for the site(s) you select here.
- 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 change the shorter version (SEO) 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 SEO agent by clicking Restore to default.
Use the SEO agent for content items
By default, the AI agent is integrated directly into the Sitefinity content editing experience and ready to surface SEO related 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 SEO 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 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 SEO agent for pages
Using the Search engine optimization agent on page level is supported only for ASP.NET Core and Next.js pages.
By default, the AI agent is ready to surface SEO related 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 SEO 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