dotAI integrates powerful AI tools into your dotCMS instance, allowing new horizons of automation — content and image generation, semantic searches, workflows capable of handling nitty-gritty procedures like content tagging, and more.
Currently, these integrations leverage the services of OpenAI. In future iterations, the choice of AI service provider will become a configurable option. Additionally, the dotAI features will soon be available by default; at this moment, it requires one of two activation methods:
- Enable the dotAI tool through the admin panel (dotCMS 24.04.05 or later), or
- Deploy the dotAI plugin (earlier versions that meet the requirements)
Requirements
This feature requires the following:
- dotCMS Enterprise Edition, as this plugin has both Workflow and App components, both of which are Enterprise only;
- An OpenAI API key, obtained separately;
- Postgres 15 with the pgvector extension installed.
- If you're on dotCMS Cloud, we'll handle it!
- For self-hosted customers, see below.
Self-Hosted
For embeddings to function, a vector extension must be added to the Postgres database. The dotAI plugin will add this extension automatically, but this process requires dotCMS's database user has superuser privileges, ensuring extensions can be installed.
If the database user does not have sufficient rights, it may be necessary for IT or administrators to manually add the extension. The simplest implementation is via the ankane/pgvector Docker tag, easily accessible via the command docker pull ankane/pgvector. The image can be applied to a docker-compose.yml by adding it to the database section:
db:
image: ankane/pgvector
Note also that these privileges are only required for the extension's installation, and not for its subsequent use.
App Configuration
A full list of the App integration fields follows:
| Field | Description |
|---|---|
| API Key | Your account's API key; must be present to utilize OpenAI services. |
| Role Prompt | A prompt describing the role (if any) the text generator will play for the dotCMS user. |
| Text Prompt | A prompt describing the overall writing style of generated text. |
| Image Prompt | A specification of output aspect ratio. If the ratio specified differs significantly from the Image Size (below), the image will “letterbox” accordingly. |
| Image Size | Selects the default dimensions of generated images. |
| Model | The text model used to generate written responses. |
| Image Model | The image model used to generate graphical responses. |
| Auto Index Content Config | Allows App-level configuration of content indexes used as the basis for text generation. Takes a JSON mapping; each property name becomes an index, and each value is the Content Type it will take as its target content. Optional; indexes are also fully configurable under the dotAI Tool. Most useful when configured in the System Host, as this will instantiate the indexes across multiple sites. |
| Custom Properties | Additional key-value pairs for dotAI configuration. |
Once installed and configured, the dotCMS surfaces a variety of utilities. The section below provides a brief overview of each, and a link to further documentation.
Using dotAI
The dotAI feature includes several components, detailed separately:
| Component | Description |
|---|---|
| dotAI Tool | The dotAI admin-panel interface can be found via Tools -> dotAI, allowing direct usage, index definition, and general configuration of the feature. |
| AI Blocks | dotAI's integration with the Block Editor field provides the most straightforward way to get started generating content. |
| AI Workflows | AI Workflow Sub-Actions permit a range of asynchronous automations utilizing AI — such as generating entire contentlets on demand. |
| AI Viewtool | The AI Viewtool, accessible through $ai, allows AI operations via Velocity script. |
| API Resources | REST API endpoints allow OpenAI operations to be performed headlessly. |
