GEO Schema Optimization agent (CMS 13)

  • Updated

GEO Schema Optimization is an Optimizely Opal agent that analyzes page content and generates or refines JSON-LD schema markup directly within Optimizely Content Management System (CMS 13) to improve search engine comprehension and AI search visibility.

  • Challenge – Ensuring that Generative Engine Optimization (GEO)-specific content is correctly structured with schema markup can be complex, often leading to under-optimized local search performance and missed opportunities for rich search results.
  • Agent outcome – The agent analyzes your CMS 13 content and external URLs for GEO-related schema, identifies gaps, and automatically adds or populates JSON-LD with accurate, real content to enhance local SEO.
  • Value – Improves visibility in local search results, increases the likelihood of displaying in rich snippets, and drives more relevant local traffic.

Required Optimizely products

Optimizely CMS 13

Install agent

Opal Administrators, Agent Builders, and Opal Users with the Add, edit, and install specialized agents  attribute for a custom role can add agents to their organization's Optimizely Opal instance. See Add users and set permissions.

Install the agent from the Opal Agent Directory.

  1. Go to Agents > Agent Directory.
  2. Select GEO Schema Optimization. Ensure you select the agent with @geo_schema_optimization-paas as its ID.

  3. Click Install Agent to add it to your Opal instance.

    screenshot of the GEO Schema Optimization entry in the Opal Agent Directory where Install Agent is highlighted

If Install Agent is in a disabled state, ensure the Required Optimizely products are connected to your Opal instance.

Use the agent

Before using the using the GEO Schema Optimization agent, you must install the Opal tools in your CMS 13 instance. See Get started with Optimizely Opal tools for information.

In Opal Chat, enter @geo_schema_optimization-pass and provide the following details:

  • ContentKey – Enter the content key for the current CMS 13 page.
  • ContentVersion – Enter the version of the current CMS 13 page.
  • PreviewURL – Enter the preview URL for the current CMS 13 page.
  • (Optional) SchemaProperty – Enter the schema property from CMS 13, if available.

The agent analyzes the page content, generates or refines JSON-LD schema markup, and updates the schema property in CMS 13 directly.

To use the GEO Schema Optimization agent in a workflow agent, drag and drop it into your workflow. See Create a workflow agent.

Details

These are the default details for the GEO Schema Optimization agent. After you install the agent in your Opal instance, customize these details for your organization's needs. See Manage agents for instructions.

Input variables

The GEO Schema Optimization agent takes the following input:

CMS 13 automatically shares the input variables with Opal when using Opal Chat from within CMS 13.

When using Opal Chat from the Opal app interface, enter these values directly.

  • ContentKey
  • ContentVersion
  • PreviewURL
  • (Optional) SchemaProperty

Tools

The GEO Schema Optimization agent uses the following tools internally to process your request:

  • browse_web_html
  • paas_cms_get_content_data
  • paas_cms_get_content_type_details
  • paas_cms_create_content_type
  • paas_cms_update_content_type
  • paas_cms_update_content_item
  • paas_cms_create_content_item

You must install the Opal tools in your CMS 13 instance before using the GEO Schema Optimization agent. See Get started with Optimizely Opal tools for information.

Additional details

The agent uses the following default configuration:

  • Inference level – Complex. Provides advanced reasoning and detail.
  • Files – None.
  • Output – Text.

If you use Opti ID, administrators can turn off generative AI in the Opti ID Admin Center. See Turn generative AI off across Optimizely applications.