Bloomreach

Bloomreach Documentation version

Developer Docs / Backend Development / Integrations / BrXM AI Content Assistant (BETA)

BrXM AI Content Assistant (BETA) developer guide

Overview

This feature is available since Bloomreach Experience Manager verison 16.4.0.
This Bloomreach Experience Manager feature requires a standard or premium license. Please contact Bloomreach for more information.

The BrXM AI Content Assistant, powered by Loomi, brings generative AI capabilities directly into the BrXM CMS, helping you automate and streamline content creation, editing, and management.

This guide shows you how to configure, initialize, and use the AI chat assistant, focusing on technical setup and supported operations. The AI chat assistant is the central feature, enabling developers and content teams to interact with large language models (LLMs) for tasks like summarization, translation, and SEO optimization—all within the CMS interface.

Prerequisites

Before you begin, make sure you meet the following requirements:

  • Access to a BrXM CMS instance (version 16.4 or later).

  • Access to the console.

  • Understanding of your organization’s data privacy and residency requirements.

  • An API key from a supported AI provider, such as OpenAI, Gemini, or Claude.

Only OpenAI is supported in the BETA version. Support for other providers will be added in future releases.

Technical architecture overview

The Content GenAI integration is built on a modular architecture that separates the UI, backend AI service, and model providers. Here’s how the main components interact:

  • Document editor: The main UI where users trigger AI operations.

  • AI backend service: Handles all AI-related requests from the UI. Initially exposed as an internal service, with a REST API layer planned for future releases.

  • Spring AI bridge: Acts as a middleware between the backend service and various model providers.

  • Model providers: External LLM services such as OpenAI, Gemini, or Claude.

How to use the AI Content Assistant

  1. Open a content document in the editor.

  2. Click the AI Content Assistant icon.

  3. Type in your request in the chat interface.

  4. Review the AI-generated response.

  5. Apply the changes to your content manually as needed.

How the AI Content Assistant works

  1. The user initiates an AI operation in the document editor.

  2. The UI sends a request to the AI backend service.

  3. The backend service prepares and forwards the request to the selected model provider via the Spring AI bridge.

  4. The model provider processes the request and returns a response.

  5. The backend service sends the result back to the UI for display or further action.

This architecture abstracts the complexity of model integration and ensures that only approved operations are exposed to users, improving security and maintainability.

How to initalize the AI Content Assistant

You can initialize the AI Content Assistant with Essentials. To do so:

  1. Go to Essentials.

  2. Go to Library.

  3. Look for Content AI and click Install feature.

  1. Now, rebuild and restart your project.

  2. Once your project has restarted, go to Installed features.

  3. Find Content AI and click Configure.

  1. Configure the AI model details such as API URL, key, and so on.

Only OpenAI configuration is supported in the BETA version. Support for other providers will be added in future releases.

  1. Once you’re done, click Save.

  2. Lastly, rebuild and restart your project again.

Configuration options

This feature is only available with user-configurable keys.

You can configure the Content GenAI integration in the following way;

  • User-configurable API keys: Enter your own API keys for supported providers. This gives you flexibility and control over data privacy but requires you to manage provider agreements and keys.

Supported operations and API usage

The AI chat assistant supports a range of content operations. You can trigger these actions directly from the document editor or via the assistant panel.

Field-specific operations:

Field-specific operations generate a response from the AI for a single field. To update the content of that field, you need to manually copy the AI’s response and paste it into the desired field. Example operations include:

  • Summarize a field: Generate a concise summary of the selected field.

  • Expand content: Elaborate on existing text or expand bullet points.

  • Spelling and grammar checks: Identify and fix errors in a specific field.

Document-level operations:

These operate on the whole document. Example operations include:

  • Summarize a document: Create a summary of the entire document.

  • Tag extraction: Identify key themes or keywords for categorization.

  • Translate a document: Convert content into different languages.

  • Sentiment analysis: Analyze the emotional tone of the content.

  • SEO optimization suggestions: Get recommendations for improving search engine visibility.

  • Translation: Translate a document.

Limitations

  • Only OpenAI is supported in the current BETA release. Additional providers and managed service options are planned for future releases.

  • In version 16.4, the AI Content Assistant accesses only the unpublished document content. Draft versions are not yet supported. Therefore, users must save changes to provide the AI with the most current document information.

As of version 16.4.1, the AI assistant now supports draft versions of documents, allowing users to access the most current document information without needing to save changes.

  • Assets (fields and document types) are not supported.

  • Value list fields and document types are not supported.

  • The assistant is only available in the content perspective; other perspectives are not supported.

  • Document-level operations may require manual import of generated content via the Content API.

Did you find this page helpful?
How could this documentation serve you better?
On this page
    Did you find this page helpful?
    How could this documentation serve you better?