entity_blueprint

Entity Blueprint provides a clean JSON interface:

Serialize any fieldable entity to a format an AI (or any external system) can understand, modify the JSON, and deserialize it back into a valid Drupal entity with full validation and structured error feedback.

Drupal entities — especially Layout Builder pages with nested paragraphs, inline blocks, and opaque third-party settings — are too complex for AI to manipulate through Drupal's internal APIs directly.

Without this, AI agents must either:

• Navigate Drupal's deeply nested entity/field/plugin APIs, which require framework expertise an LLM does not have.
• Use REST/JSON:API, which serialize entities faithfully but do not provide a simplified, writable format or structured validation feedback suitable for AI round-trips.
• Attempt direct entity manipulation, risking silent data loss in Layout Builder's opaque settings (third_party_settings, additional, configuration) that the AI doesn't understand.

Discover AI powered page building

Entity Blueprint is a generic, standalone module, but it was built to power the AI features in plus suite. Plus Suite uses Entity Blueprint as the bridge between AI agents and Layout Builder, letting AI create and edit full pages.

Plus Suite

Features

• Skills — On-demand behavioral guidance an AI loads only when it's about to perform a task (create an entity, add a section), discovered from YAML and composed per entity type/bundle. The conversation carries just a catalog; full instructions arrive via tool call.
• Deferred operations — Field handlers can return DeferredOperation objects for work that must run asyncronously (e.g. image generation); the consuming module processes them.
• Context & guidance system — Attach AI-facing guidance and defaults to schema output at entity, field-type, block-type, and layout levels.
• Workspace enforcement — A full AI sandbox when Workspaces is enabled, persistence requires an active workspace; tools surface options rather than choosing.
• Full serialization — Convert any fieldable entity (nodes, blocks, paragraphs, Layout Builder pages) to JSON.
• Three serialization modes — Full (all field values), summary (tree structure only, no field values), and component (single UUID with context).
• Deserialization with validation — Two-phase validation: Phase A (structural) catches schema errors cheaply, Phase B (semantic) checks permissions, constraints, and reference resolution. Returns unsaved entities with structured errors and warnings.
• Targeted CRUD operations — Add, update, or remove individual components, update fields, restructure layouts, and reorder field values without full entity round-trips.
• Batch operations — Execute multiple operations atomically with rollback on failure.
• JSON schema generation — Generate descriptive JSON schemas for entity type and bundle combinations so AI agents can learn entity structures before acting.
• Opaque data protection — Layout Builder internals (third_party_settings, layout_settings, configuration) are preserved from the existing entity by default. Only keys explicitly declared as managed via hook are exposed.
• Multilingual support — Serialize and deserialize with langcode for translation workflows.
• Extensible field handlers — Register handlers for custom field types via tagged services.

Learn more

Entity Blueprint can be built on top of by any system. This is the Drupal entity abstraction layer. Read the "how and why" behind entity blueprint here.

Introducing entity_blueprint

Submodules

The base module is the data layer. Optional submodules, all currently experimental, add AI tooling and config-entity support on top:

Entity Blueprint AI

entity_blueprint_ai

Exposes all entity_blueprint operations as AI agent function-call tools (each prefixed eb_) for the Drupal AI module. Includes an admin settings form to hide specific entity types and bundles from the AI tools.

Entity Blueprint AI Anthropic

entity_blueprint_ai_anthropic

Model specific adapter for prompt injecting guidance and skills in the way that the model was trained to use it.

Entity Blueprint Config

entity_blueprint_config

Extends serialization, deserialization, and validation to config entities (views, image styles, menus, block types, and more) through a pluggable backend.

Entity Blueprint Config AI

entity_blueprint_config_ai

Exposes the config-entity operations as AI agent tools.

Entity Blueprint AI Dev Tools

entity_blueprint_ai_dev_tools

A drush entity-blueprint:prompt-audit command that dumps the fully assembled AI prompt surface (system prompt, messages, tools) without spending an LLM call.