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 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 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 your Sitefinity 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 backend.

If you want to configure the AI agent individually, you can do so via the AI agents module. Perform the following:

  1. Log in to your Sitefinity CMS backend with Administrator privileges.
  2. Navigate to Administration » AI agents and click the Search engine optimization agent.
    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 Instructions, you can optionally edit the preconfigured prompt with SEO best practices guidelines according to your individual needs. This prompt is sent to the Large Language Model (LLM) when the agent is executed.
    These instructions guide how the AI agent analyzes your content and performs its tasks.
  6. 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.
  7. 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.
  8. 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).
  9. Save your changes.
    You can also restore the default system settings for the SEO agent by clicking Restore to default.

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

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.
Content editors get a notification icon 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.

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 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 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 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 (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 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 (Page suggestions) on their active screen indicating the counter of all AI-generated suggestions for the currently open page.

Content editors access all AI-generated suggestions for 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 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.

    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 on 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 of the AI agent - by clicking 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.

Additional resources

Sitefinity AI Overview

Want to learn more?
Enhance your Sitefinity skills by enrolling in free training sessions. Become Sitefinity certified through Progress Education Community to strengthen your professional credentials.