Skip to main content

AI Extensions

AI Extensions lets administrators choose which WinnerWare AI utilities appear in the browser extension, control how they are presented, and publish the allowed utility list to approved clients.

Overview

This module connects the WinnerWare browser extension to the utility profiles that administrators choose to make available. It does not create a separate chat experience on its own.

The module feature is:

FeaturePurpose
CloudSolutions.AI.ExtensionsAdds browser-extension settings to AI utility profiles and exposes the approved utilities list.

The feature is displayed in the manifest as AI Browser Extensions, while the documentation name used in WinnerWare is AI Extensions.

Key Features

  • Adds an editor to AI Profile items for browser-extension metadata.
  • Lets administrators opt a utility profile into the public extension.
  • Stores HTML button content for the extension UI and validates it before saving.
  • Returns the permitted utility list from GET /api/ai/utilities/available.
  • Adds extension access control.
  • Refreshes the published utility list whenever utility settings are changed.

How It Works

Utility profile setup

The profile editor includes:

  • Use for the public extension
  • Extension button HTML content

Only utility profiles are included in the published list. The markup field is validated before saving.

Available utilities endpoint

The module publishes:

GET /api/ai/utilities/available

The endpoint returns the approved utility list for the extension client. Each entry includes:

  • ProfileId
  • Title
  • IconClassName
  • Html

Configuration

Enable the feature

Enable AI Browser Extensions from Configuration -> Features.

Curate the utility list

To publish a utility to the extension:

  1. Open the AI Profile in the admin UI.
  2. Make sure the profile is a Utility profile.
  3. Enable Use for the public extension.
  4. Add the button HTML that should be sent to the extension client.
  5. Save the profile.

Permission model

Administrators receive access to manage which utilities are made available to the extension.

Usage

Publish extension-ready utilities

Use this module when you want a controlled list of AI utilities to be available to the browser extension instead of exposing every utility profile in the system.

Customize the extension button

The HTML field is designed for the extension button body and can include inline SVG or other safe markup that represents the utility in the extension UI.

Expose the list to an external client

Approved clients call /api/ai/utilities/available to fetch the allowed utilities.

Operational Notes

  • Keep the public utility list short and intentional so the extension stays focused and easy to use.
  • Use clear labels and button markup so each utility is obvious to end users.
  • Review published utilities regularly to make sure only the intended tools remain available.