Skip to main content

Configuration

🚧Documentation Under Construction

We are actively working to improve this documentation. The content you see here may be incomplete, subject to change, or may not fully reflect the current state of the feature. We appreciate your understanding as we continue to enhance our docs.

All AI features are configured in the AI plugin, accessible at Admin > Plugins > AI. Before configuring features in the CMS, ensure the AI plugin dependencies and infrastructure have been set up (see Getting started).

note

The plugin may already have a baseline configuration set via environment properties by the ops team. Settings configured in the CMS override those defaults. Property-based defaults are not visible in the CMS UI.

The plugin has two levels of configuration:

  • Global settings—The top-level fields (such as the text embedding generator and system instructions) apply across all sites.
  • Default Config—The Default Config section contains per-feature settings organized into tabs (Main, Create with AI, and Ask AI). These settings apply to all sites by default.

To override the default configuration for a specific site, navigate to Admin > Sites & Settings, select the site, and open the Plugins tab. Any settings configured there take precedence over the defaults for that site.

Global settings​

The following settings are configured at the top level of the plugin and apply to both Create with AI and Ask AI across all sites.

Text embedding generator​

The text embedding generator converts content into vector representations for semantic search. This setting is required if Ask AI is enabled.

To configure the text embedding generator:

  1. Click > Admin > Plugins.
  2. Click on the desired AI plugin.
  3. From the Text Embedding Generator list, select a provider (for example, OpenAI Text Embedding Generator).
  4. Configure the provider-specific fields, such as Model.
  5. Click Save.

System instructions​

System instructions guide the LLM's behavior for each feature. Default instructions are provided but can be customized.

To customize system instructions:

  1. Click > Admin > Plugins.
  2. Click on the desired AI plugin.
  3. Under the Advanced tab, expand the Instructions cluster.
  4. Edit the Create with AI and Ask AI instruction fields as needed.
  5. Click Save.

Default Config​

The Default Config section contains settings that apply to all sites unless overridden at the site level. It is organized into three tabs: Main, Create with AI, and Ask AI.

Chat client​

The chat client handles all LLM interactions for both Create with AI and Ask AI. It is configured under the Main tab.

To configure the chat client:

  1. Click > Admin > Plugins.
  2. Click on the desired AI plugin.
  3. Under Default Config, select the Main tab.
  4. From the Chat Client list, select a provider (for example, OpenAI or Bedrock).
  5. Configure the provider-specific fields, such as the model or inference profile.
  6. Click Save.

Create with AI​

Create with AI allows editors to query the AI client to generate content ideas or suggestions such as headlines, body text, and more. The following settings are under the Create with AI tab of the Default Config section.

Enabling Create with AI​

To enable Create with AI:

  1. Click > Admin > Plugins.
  2. Click on the desired AI plugin.
  3. Under Default Config, select the Create with AI tab.
  4. Toggle on the Enabled setting.
  5. Click Save.

Brand guidelines​

Brand guidelines are appended to every system prompt, ensuring the LLM follows your organization's tone and style requirements without needing to repeat them in individual prompts.

note

Long brand guidelines increase cost and may require models with larger context windows.

Prompt suggestions​

Prompt suggestions appear when editors interact with Create with AI, providing pre-written prompts that can be clicked instead of typed. They can be configured at three levels: site-wide, content-type, and field.

Site-wide prompt suggestions

Site-wide prompt suggestions are available whenever an editor interacts with Create with AI, regardless of content type or field.

To configure site-wide prompt suggestions:

  1. Click > Admin > Plugins.

  2. Click on the desired AI plugin.

  3. Under the Create with AI tab, expand the Prompt Suggestions cluster.

  4. Under Global Prompt Suggestions, click Add Item.

  5. Click Create New. Brightspot displays the New Prompt Suggestion content edit form.

    1. In the Title field, give the prompt suggestion a title.
    2. In the Prompt field, enter the prompt text.
    3. Click Save.
    4. Click Back.

  6. Under Global Prompt Suggestions, select the prompt suggestion you just created.

  7. Repeat steps 4–6 to add additional prompt suggestions.

  8. Click Save.

Content-level prompt suggestions

Content-level prompt suggestions are available on a specific content type. When an editor interacts with Create with AI on an asset of the selected content type, the prompt suggestion appears.

To configure content-level prompt suggestions:

  1. Click > Admin > Plugins.

  2. Click on the desired AI plugin.

  3. Under the Create with AI tab, expand the Prompt Suggestions cluster.

  4. Under Type Specific Prompt Suggestions, click Add Item.

  5. Click Create New. Brightspot displays the New Content Level Prompt Suggestion content edit form.

    1. In the Name field, enter a name for the content-level prompt. This is an internal name that helps differentiate this content-level prompt from others.

    2. Under Content Type, select the content type for which the prompt suggestion will appear. For example, if you only want the prompt suggestion to appear for articles, select Article from this list.

    3. Under Content Level Prompt Suggestions, click Add Item.

    4. Click Create New. Brightspot displays the New Prompt Suggestion content edit form.

      1. In the Title field, give the prompt suggestion a title.
      2. In the Prompt field, enter the prompt text.
      3. Click Save.
      4. Click Back.

    5. Under Content Level Prompt Suggestions, select the prompt suggestion you just created.

    6. Repeat steps 5c–5e to add additional prompt suggestions. To create prompt suggestions for a different content type, return to the plugin settings and begin at step 4.

    7. Click Save.

    8. Click Back.

  6. Under Type Specific Prompt Suggestions, select the content-level prompt suggestion you just created.

  7. Click Save.

Field-level prompt suggestions

Field-level prompt suggestions are the most granular type and are available on a specific field of a specific content type.

note

Field-level prompt suggestions are created within content-level prompt suggestions. See the steps below for details.

To configure field-level prompt suggestions:

  1. Click > Admin > Plugins.

  2. Click on the desired AI plugin.

  3. Under the Create with AI tab, expand the Prompt Suggestions cluster.

  4. Under Type Specific Prompt Suggestions, click Add Item.

  5. Click Create New. Brightspot displays the New Content Level Prompt Suggestion content edit form.

    1. In the Name field, enter a name for the field-level prompt.

    2. Under Content Type, select the content type for which the prompt suggestion will appear.

    3. Under Field Level Prompt Suggestions, click Add Field Level Prompt Suggestion.

    4. Under Content Field, select the field for which the prompt suggestion will appear. For example, if you only want the prompt suggestion to appear for the Headline field on an article, select Headline from this list.

    5. Under Field Level Prompt Suggestions, click Add Item.

    6. Click Create New. Brightspot displays the New Prompt Suggestion content edit form.

      1. In the Title field, give the prompt suggestion a title.
      2. In the Prompt field, enter the prompt text.
      3. Click Save.
      4. Click Back.

    7. Repeat steps 5c–5f to add additional field-level prompt suggestions.

    8. Click Save.

    9. Click Back.

  6. Under Type Specific Prompt Suggestions, select the field-level prompt suggestion you just created.

  7. Click Save.

Author personas​

An author persona applies a preset tone and style to AI-generated responses. Personas can be AI-generated from reference content or manually defined. A default persona and additional personas can be configured; editors select which persona to use when generating content.

To create an author persona:

  1. Click > Admin > Plugins.

  2. Click on the desired AI plugin.

  3. Under the Create with AI tab, expand the Personas cluster.

  4. Under Default Persona, do the following:

    1. Select the field and click Create New.

    2. In the Name field, enter a name for the author persona.

    3. Under Profile, select one of the following options:

      • AI Generated—AI generates the persona by referencing assets that you select. After selecting this option, do the following:

        1. Under Referenced Content, click Add Item and search for an existing asset for AI to reference. You may select up to five assets.
        2. Writing Style Profile is a read-only field. After saving, Brightspot uses the configured chat client to generate a summary of the persona's tone and style.

      • Manual—Define the persona by entering a description. After selecting this option, do the following:

        • Under Writing Style Prompt, enter a description of the persona you want. Add as much detail as possible (for example, "I want my persona to sound like a thought leader in the content management space").

  5. (Optional) Under Other Personas, follow steps 4a–4c to create additional personas.

  6. Click Save.

note

If you selected AI Generated for the persona, then after saving, the AI client analyzes the selected assets and generates a summary in the Writing Style Profile field. From that field, you can click Preview a sample to see a side-by-side comparison of text with and without the persona applied.

Advanced settings​

Under the Advanced cluster of the Create with AI tab:

FieldDescriptionDefault
Generation TimeoutMaximum time allowed for a generation request.180 seconds
Generated Content DetectorsDetectors that compare AI-generated content with subsequent edits to determine whether content should still be flagged as AI-generated.None

Ask AI​

Ask AI queries CMS content to summarize and list existing assets on a topic using vector embeddings and retrieval-augmented generation (RAG). The following settings are under the Ask AI tab of the Default Config section.

Enabling Ask AI​

To enable Ask AI:

  1. Click > Admin > Plugins.
  2. Click on the desired AI plugin.
  3. Under Default Config, select the Ask AI tab.
  4. Toggle on the Enabled setting.
  5. Click Save.

Advanced settings​

Under the Advanced cluster of the Ask AI tab:

FieldDescriptionDefault
Max RecordsMaximum number of records returned as context for Ask AI.10
Min ScoreMinimum similarity score for search result records. Value must be between 0.0 and 1.0.0.5
Max TokensMaximum number of tokens allowed in Ask AI search context. Cannot exceed the upper limit imposed by the chat client.16384

Permissions​

The ability to use AI features is based on the permissions assigned to an editor's role. Without the appropriate permissions, the AI icons are not visible.

Create with AI permissions​

To configure Create with AI permissions for a role:

  1. Click > Admin > Users & Roles.
  2. In the Roles widget, locate the role for which you want to enable AI functionality.
  3. Click under Additional Permissions and select Create with AI Permission.
  4. From the Content Types field, select the content types in which Create with AI is enabled.
  5. Click Save.

Ask AI permissions​

To configure Ask AI permissions for a role:

  1. Click > Admin > Users & Roles.
  2. In the Roles widget, locate the role for which you want to enable Ask AI functionality.
  3. Click under Additional Permissions and select Ask AI Permission.
  4. Toggle on the Use Ask AI setting.
  5. Click Save.