GEO Schema Optimization agent (CMS SaaS)
GEO Schema Optimization is an agent in Mark (Optimizely Agent Platform). It analyzes page content and generates or refines JSON-LD schema markup directly within Optimizely Content Management System (SaaS). The markup improves search engine comprehension and AI search visibility.
- Challenge – Structuring Generative Engine Optimization (GEO)-specific content correctly with schema markup is complex. This often leads to under-optimized local search performance and missed opportunities for rich search results.
- Agent outcome – The agent analyzes your CMS (SaaS) content and external URLs for GEO-related schema and identifies gaps. It then automatically adds or populates JSON-LD with accurate, real content to enhance local Search Engine Optimization (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
The GEO Schema Optimization agent requires Optimizely Content Management System (SaaS).
Install agent
Note
Mark Administrators, Agent Builders, and users with the Add, edit, and install specialized agents attribute for a custom role can add agents to their organization's Mark instance. See Add users and set permissions.
Install the agent from the Directory.
- Go to Directory > Agents.
- (Optional) Enter GEO Schema Optimization or use the drop-down list filters to narrow the list.
- Click Install on GEO Schema Optimization to add it to your Mark instance.
If Install is disabled, ensure the Required Optimizely products are connected to your Mark instance.
Use the agent
In Mark chat, enter @geo_schema_optimization and provide the following details:
- ContentKey – Enter the content key for the current CMS (SaaS) page.
- ContentVersion – Enter the version of the current CMS (SaaS) page.
- PreviewURL – Enter the preview URL for the current CMS (SaaS) page.
- (Optional) SchemaProperty – Enter the schema property from CMS (SaaS), if available.
The agent analyzes the page content, generates or refines JSON-LD schema markup, and updates the schema property in CMS (SaaS) directly.
To use the GEO Schema Optimization agent in a workflow agent, add it to your workflow. See Create a workflow agent.
Default agent details
These are the default details for the GEO Schema Optimization agent. After you install the agent in your Mark 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 (SaaS) automatically shares the input variables with Mark when using Mark chat from within CMS (SaaS).
When using Mark chat from the Mark 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
- cms_get_content_data
- cms_get_content_type_details
- cms_create_content_type
- cms_update_content_type
- cms_update_content_item
- cms_create_content_item
Default configuration
The agent uses the following default configuration:
- Inference level – Complex, which provides advanced reasoning and detail.
- Files – None.
- Output – Text.
Note
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.