eea.genai.blocks 1.0

Main features

1. generate_blocks(user_request, context, request, properties) — produce a full blocks + blocks_layout structure from a natural-language description (blocks_generator agent).

2. generate_block(user_request, block_type=None, ...) — produce a single block (blocks_generator_single agent).

3. rewrite_blocks(blocks, style=None, ...) and rewrite_block(block, style=None, ...) — rewrite text content in one or more blocks (block_rewriter / block_rewriter_single agents).

4. IBlockKnowledge named-utility registry — packages declare a block type’s description, JSON schema, example, text extractor, and sanitizer. The agent’s system prompt is built from these utilities.

5. BlocksKnowledgeSkill enricher — injects every registered block type’s schema + example into the agent’s system prompt.

6. BlocksContentProvider enricher — injects the current page’s block text into the user prompt (batched IBlockKnowledge lookups, no per-block ZCA queries).

7. Ships block knowledge for slate, image, columnsBlock, tabs_block. Custom block types register their own via <genai:blockKnowledge>.

8. @llm-generate-blocks and @llm-rewrite-blocks REST endpoints.

Install

• Add eea.genai.blocks to your requirements.txt.

• Install the GenericSetup profile.

• The four default agents are registered automatically via ZCML and can be overridden by name via the core control panel agents_json.

Adding a new block type

In your addon’s configure.zcml:

<genai:blockKnowledge
    block_type="my_block"
    title="My Block"
    class=".knowledge.MyBlockKnowledge"
/>

In knowledge.py:

from eea.genai.blocks.interfaces import BlockKnowledge

class MyBlockKnowledge(BlockKnowledge):
    description = "Describe what the block is for"
    schema = '{"@type": "my_block", "value": "..."}'
    example = '{"@type": "my_block", "value": "hello"}'

    def text_extractor(self, block):
        return block.get("value", "")

    def block_sanitizer(self, block):
        return block  # post-LLM cleanup, return canonical dict

Generation/rewriting agents will pick up the new block type automatically — no change to agent config required.

Copyright and license

The Initial Owner of the Original Code is European Environment Agency (EEA). All Rights Reserved.

All contributions to this package are property of their respective authors, and are covered by the same license.

The eea.genai.blocks is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 2 of the License, or (at your option) any later version.

Changelog

1.0 - (2026-05-21)

• Initial release