AI

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 Esca—Interactive content generation with customizable prompts and real-time collaboration.
• Ask Esca—A built-in AI agent that finds, creates, edits, and deletes content from natural-language requests, calling search and content tools iteratively as the conversation requires.
• 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 vector embeddings, conversational AI, and agentic tool calling to enhance content creation workflows. Content is automatically chunked and embedded into a vector database, enabling semantic search. When a user interacts with Ask Esca, the agent decides which search and content tools to call, evaluates the results, and may iterate before responding — whether the request is a question, a new asset, or an edit to an existing one — rather than performing a single pre-built step. Create with Esca uses the same agent 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 Esca'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 Esca 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 Esca 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 Esca 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 Esca 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 Esca 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 Esca 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 Esca'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

Maven

<!-- Requires Brightspot 4.8 or later. -->
<dependency>
    <groupId>com.brightspot.ai</groupId>
    <artifactId>ai</artifactId>
    <version>3.2.0</version>
</dependency>

Gradle

// Requires Brightspot 4.8 or later.
implementation 'com.brightspot.ai:ai:3.2.0'

Gradle (Kotlin DSL)

// Requires Brightspot 4.8 or later.
implementation("com.brightspot.ai:ai:3.2.0")

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.
• Technical architects—Architecture overview provides detailed component architecture, core classes, and configuration options.
• Editors and content creators—Using Ask Esca, Using Create with Esca, and AI Audit cover day-to-day AI workflows and usage monitoring.
• Integrators—MCP covers exposing Brightspot content to external AI clients over the Model Context Protocol.