AI

🚧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.

The Brightspot AI plugin integrates advanced AI capabilities including conversational chat, vector search, content generation, and author persona modeling. The plugin provides comprehensive AI-powered content creation and management within the Brightspot ecosystem.

Key capabilities

• Create with AI—Interactive content generation with customizable prompts and real-time collaboration.
• Ask AI—Intelligent search and question-answering using vector embeddings and RAG.
• Vector search—Semantic search across content using vector embeddings.
• Author personas—Style modeling and persona-based content generation.
• AI Audit—Usage tracking across AI interactions for monitoring and compliance.

How it works

The plugin combines retrieval-augmented generation (RAG), vector embeddings, and conversational AI to enhance content creation workflows. Content is automatically chunked and embedded into a vector database, enabling semantic search. When a user asks a question through Ask AI, the system retrieves the most relevant content chunks and passes them as context to a large language model (LLM) to generate an answer. Create with AI uses the same LLM infrastructure to generate and refine content directly within the editorial workflow.

Supported providers

The plugin supports the following AI platforms. Any model available on a supported platform can be used—refer to the provider's documentation for current model availability.

Platform	Provider
OpenAI	OpenAI
Amazon Bedrock	Anthropic, Amazon, Meta, Cohere
Google Vertex AI	Google

Use cases

Ask AI's vector search and natural language capabilities make it valuable across various industries and content scenarios. Here are some practical applications:

Manufacturing and industrial

Quality documentation assistant—A manufacturing company uses Ask AI to help engineers and quality assurance teams quickly find relevant documentation, safety protocols, and troubleshooting guides. Content editors can ask questions like:

• "What are the safety requirements for handling chemical X in production line 3?"
• "Show me all maintenance procedures for equipment model ABC-2024"
• "What quality control standards apply to automotive parts production?"

Ask AI searches through thousands of technical documents, safety manuals, and compliance procedures to provide instant, contextual answers with source citations.

Product knowledge hub—An industrial equipment manufacturer leverages Ask AI to help their sales and support teams access complex product information. Questions might include:

• "What are the power requirements for our heavy machinery line?"
• "Which products are compatible with high-temperature environments?"
• "Find installation guides for hydraulic systems in manufacturing facilities"

News and editorial operations

Editorial research assistant—Newsrooms use Ask AI to help journalists quickly research story backgrounds, find related articles, and access archived content. Typical queries include:

• "What have we published about climate change policy in the past year?"
• "Show me all interviews with technology CEOs from 2024"
• "Find background information on recent healthcare legislation"

This dramatically reduces research time while ensuring journalists have comprehensive context for their stories.

Content archive discovery—Editorial teams can efficiently navigate years of published content to find relevant material for follow-up stories, fact-checking, or content repurposing:

• "What coverage do we have on renewable energy initiatives?"
• "Find all opinion pieces about social media regulation"
• "Show me investigative reports on corporate governance"

Technology

Developer documentation assistant—Large technology companies use Ask AI to help developers navigate extensive technical documentation, API references, and internal knowledge bases:

• "How do I implement OAuth authentication in our mobile SDK?"
• "What are the rate limits for our search API endpoints?"
• "Show me examples of machine learning model deployment on our platform"

Product knowledge management—Product teams can quickly access feature specifications, user research, and competitive analysis:

• "What user feedback do we have about the new dashboard interface?"
• "Find performance benchmarks for our cloud storage solutions"
• "Show me market research on AI-powered features"

Enterprise and corporate

Policy and compliance navigator—Large organizations use Ask AI to help employees understand complex policies, compliance requirements, and corporate procedures:

• "What are the travel reimbursement policies for international trips?"
• "Show me data privacy requirements for customer information handling"
• "Find guidelines for remote work equipment requests"

This reduces the burden on HR teams while ensuring employees can quickly find accurate policy information.

Each of these use cases leverages Ask AI's ability to understand natural language queries, search through vector-embedded content, and provide contextually relevant answers with proper source attribution. The system's conversation history and permission-based filtering ensure secure, personalized responses tailored to each user's access level and organizational role.

Installation

Requirements

Requires Brightspot 4.8 or later.

Maven

<dependency>
    <groupId>com.brightspot.ai</groupId>
    <artifactId>ai</artifactId>
    <version>2.1.2</version>
</dependency>

Gradle

implementation 'com.brightspot.ai:ai:2.1.2'

Gradle (Kotlin DSL)

implementation("com.brightspot.ai:ai:2.1.2")

For complete setup instructions including search back-end configuration and AI provider setup, see Getting started.

Who this documentation is for

• Developers and ops engineers—Getting started covers dependencies, search back-end configuration, and AI provider setup.
• CMS administrators—Configuration covers enabling and configuring all AI features in the CMS plugin.
• Editors and content creators—Using Ask AI and Using Create with AI cover day-to-day AI workflows.
• Technical architects—Architecture overview provides detailed component architecture, core classes, and configuration options.