Using the AI Assistant
The AI Assistant is a chat agent in Liferay CMS that helps you generate, refine, and translate content inside the editor. It works as a supervisor, coordinating the agents available in your account and selecting the right one to fulfill each request.
Available agents include:
- Built-in agents that work on content in Liferay CMS, drafting an entry, filling a field, creating an image, or suggesting categories and tags.
- Writing agents that act on text you select, such as adjusting its tone or its length.
- Translation that converts the content open in the editor into other languages.
- Liferay Search, which returns answers drawn from the content it finds in the connected Liferay DXP instance.
- Content Gap Analyst, which identifies the audiences and buyer journey stages a content project doesn’t cover and finds existing content to fill those gaps. It works on Content Marketing Platform projects only, in Liferay DXP 2026.Q3 and later.
- Custom agents configured in your account.
Access the AI Assistant from the content and file creation screens in Liferay CMS. The supervisor agent logic runs in AI Hub, using your configured agents.
The AI Assistant becomes available once AI Hub is integrated with your Liferay DXP instance.
Opening the AI Assistant
The AI Assistant is available in two places. It sits in the Liferay CMS application bar at the top right of every CMS page, and it sits in the toolbar of the content editor, where it can act on the item you’re editing. Both open the same chat.
Follow these steps to use the AI Assistant while creating or editing content, such as a blog or a web content article:
-
Click AI Assistant (
) in the top toolbar, to the left of Preview. It’s the only icon in that toolbar, and it shows no text label or tooltip.The chat opens as a drop-down anchored under the button.
To give the conversation more room, click Maximize in the panel header. The chat moves into a side panel, and Minimize returns it to the drop-down. Close dismisses the panel.
-
In the Ask me anything field, enter your request.
For example, ask the AI Assistant to draft a blog introduction, rewrite a paragraph in a more formal tone, or translate text into another language.
-
Press Enter to send the message. Shift+Enter adds a line break instead.
While the reply generates, the field doesn’t accept typing, and you can’t stop a request once you’ve sent it. The AI Assistant responds in the panel. Continue the conversation to refine the result. When you’re satisfied, copy the response into your content.
Running a Writing Agent on Selected Text
Select text in a Liferay CMS rich text field and a menu of built-in writing agents appears, so you can run one without opening the chat. Review the suggestion and click Accept to replace the selected text. The menu offers the built-in writing agents only, so running any other agent means opening the AI Assistant chat.
For a walkthrough that writes and corrects a blog post with both the chat and the selection menu, see Enhancing Content Management.
Replies and Conversation History
Replies support some Markdown formatting. Headings down to three levels, **bold**, *italic*, `code`, and - bulleted lists arrive formatted. Numbered lists, links, tables, and fenced code blocks arrive as plain text, so copying a reply into your content carries only the formatting that rendered. Each reply carries a Give Positive Feedback control and a Send Negative Feedback or Report Legal Concern control, so you can rate the reply or raise a concern about it.
Reloading the editor starts a fresh conversation that remembers nothing from the previous one. The conversation lives only as long as the open chat session, and it keeps its last 30 messages.
How the AI Assistant Chooses an Agent
When you send a request, the supervisor compares it against each agent’s Description and routes the work to the closest match. An agent’s Description determines which requests reach it.
The candidate set is narrower than the full list of agents in your account. The supervisor considers the first 20 active agents, so keep your account’s active agents at 20 or fewer if you want every one of them reachable. One request can combine agents: asking it to “translate this blog to Spanish and shorten it by half” draws on the Translate Content agent and the Make Shorter agent in a single response.
The AI Assistant does not describe its own agents. Ask what it can do and it answers that it cannot share details about its internal configuration, and a reply that would name an agent is replaced with “I cannot fulfill this request.” Describe the task you want done rather than asking which agent handles it.
Because the AI Assistant works only with the agents in your account, it can act on a request only when a matching agent exists. If you ask for something no agent covers, such as checking a draft against your organization’s brand guidelines, it tells you so rather than guessing. When that happens, you can create a custom agent for it, provided you have agent-management access in AI Hub. See Building a Custom Agent.
A request can also be declined by the instructions your account applies. AI Hub ships a set of active instructions covering areas such as personal data, harmful content, and transparency, and they apply to every agent. A refusal you can’t trace to a missing agent usually comes from one of them. An administrator can review them on the Agent Builder’s Instructions tab. See Instructions and Guardrails.