Skip to content

Agents

Updated View as Markdown

Agents give the assistant a defined role and a specific set of tools. A primary agent handles a conversation or a feature such as Content Studio. A helper agent is called by another agent for a separate, read-only research task. The agent list is a read-only view; its source and tool patterns explain what it may be asked to do.

Built-in agents

In the tool lists below, names without the maze-graph/ prefix are abbreviated for readability; they use the same namespace.

Agent Role Available tools Step limit
Assistant (assistant) General help across WordPress content, media, and site tools. core/* plus maze-graph/content-summary, count-users, create-draft-post, delete-definition, delegate, get-content, get-definition, get-server-info, get-settings, get-site-health, list-comments, list-cron-events, list-definitions, list-plugins, list-post-types, list-terms, list-themes, list-updates, recall-notes, save-definition, save-note, search-content, and update-draft-post. Site default
Content writer (studio-content) Writes or rewrites drafts in Content Studio. Hidden from the regular agent picker; used by Content Studio. maze-graph/search-content, get-content, content-summary, list-terms Up to 6
Content (content-auditor) Reviews content, revisions, media, and publishing quality. maze-graph/list-post-types, list-content, get-content-revisions, compare-content-revisions, get-content-change-history, audit-content-completeness, audit-content-freshness, find-internal-link-issues, audit-taxonomy-coverage, check-publishing-readiness, list-media, search-media, get-media-details, audit-media-alt-text Up to 6
Debug (debug) Checks site health, configuration, plugins, themes, and structure. maze-graph/get-server-info, get-settings, get-site-health, list-plugins, list-themes, list-updates, list-cron-events, get-plugin-dependencies, list-post-types, list-taxonomies, list-terms, report-term-usage, list-navigation-menus, list-block-patterns, list-site-templates Up to 6
Site researcher (researcher) Helper that gathers read-only site information and returns a short summary to the Assistant. core/* plus maze-graph/content-summary, get-content, list-post-types, list-terms, search-content, recall-notes Up to 4

The Assistant’s default list is an allowlist, not a grant of access. Each tool must also be enabled, available to the current WordPress user, and allowed by MazeGraph’s policy. An administrator can broaden the built-in Assistant’s scope in Settings → Tools, but this does not change the other agents’ scopes or bypass those checks.

Site and plugin agents

The list can also contain agents supplied by the site, a plugin, or the active theme. Site-owned agents are represented as JSON definitions and can be reviewed in Extensions. Plugin and theme agents are managed by their provider. Only agents enabled and available in the current catalogue can be selected or called.

The * tool pattern means all tools that the agent’s other access checks permit. A pattern such as core/* matches tools in that namespace. The pattern never bypasses the tool’s own switch, the user’s WordPress capabilities, or site policy.

For custom agent definitions and developer integration points, see the developer reference.

Was this page helpful?

Your feedback helps us improve these docs.

Documentation

Type to search…

↑↓ navigate↵ selectEsc close