Bridgit AI Overview and Usage Guide – BridgeWorks Help Center

Trouble Viewing Images? Right-click on any image and select "Open in new tab" to view a larger version. You can also zoom in using Ctrl + Mouse Wheel for easier readability.

Article Goal

This guide provides an overview of Bridgit AI, highlights its key features, and offers instructions for accessing and utilizing it in VDM to assist with report creation, query development, data analysis, and troubleshooting.

Why Use Bridgit AI?

Bridgit can assist with a variety of technical tasks, including: data analysis and interpretation, troubleshooting and diagnosing VDM logs, and helping to write and optimize queries.

Where Do You Access Bridgit AI?

Bridgit AI capabilities are fully integrated into the VDM application. The main navigation menu includes a dedicated section for Bridgit, featuring options for Chat and Settings. In the Settings, users can customize the AI assistant's response behavior for both the Finished Report Viewer and the Visualize Viewer.

The “Ask Bridgit” AI assistant can be accessed through the chat interface, allowing users to analyze logs and gain clearer insights and explanations. Additionally, there is an Ask Bridgit icon located in the upper-right corner of the main toolbar for quick access.

How to Set Up Bridgit AI

Important Note: To begin, you will need to obtain an OpenAI API key directly from OpenAI.

After obtaining your OpenAI API key, please follow the steps below to configure it within VDM:

Launch VDM with administrative privileges.
Navigate to Settings. The API key must be configured in User Options, Global Options, and Service Options. (Important Note: Ensure that the same API key and model settings are consistently applied across all three configuration sections.)

User Options Configuration

Select User Options under Settings.
Locate the Bridgit AI section and enter the following:
- Analysis Model: gpt-5.4 or latest
- API Key: Paste your OpenAI API key
- Chat Model: gpt-5.4 or latest
- Query Model: gpt-5.4 or latest

Global Options Configuration

Select Global Options under Settings.
Locate the Bridgit AI section and enter the following:
- Analysis Model: gpt-5.4 or latest
- API Key: Paste your OpenAI API key
- Chat Model: gpt-5.4 or latest
- Query Model: gpt-5.4 or latest

Service Options Configuration

Select Service Options under Settings.
Locate the Bridgit AI section and enter the following:
- Analysis Model: gpt-5.4 or latest
- API Key: Paste your OpenAI API key
- Chat Model: gpt-5.4 or latest
- Query Model: gpt-5.4 or latest

Knowledge Editor (Beta)

Beginning with VDM 2026.04.21, administrators can configure profile-specific knowledge for Bridgit AI through the Knowledge Editor.

The Knowledge Editor allows administrators to define how Bridgit AI understands a connection profile by configuring:

Schema discovery and metadata
Preferred joins and relationship guidance
Business vocabulary and aliases
Example reports and query patterns
Memory and agent instructions
Retrieval and health monitoring settings

To access the Knowledge Editor:

Open the Tables and Fields panel.
Right-click a Connection Profile.
Select Edit Knowledge (Beta).

The Knowledge Editor is intended primarily for administrators responsible for configuring and maintaining Bridgit AI behavior within a connection profile.

For detailed information about the available configuration options, see Bridgit AI Knowledge Editor (Beta) Overview.

Bridgit Chat Settings

The Bridgit settings provide configurable options for chat functionality within both the Finished Report Viewer and the Visualize Viewer. These settings enable the customization of features such as API logging, system prompts, and user prompts, supporting AI-assisted interactions across Finished Reports and Visualize.

To access the Bridgit Settings, follow the steps below:

Launch VDM.
Navigate to the Bridgit menu and select Settings.

Ways to Use Bridgit AI

Bridgit AI is designed to enhance productivity, streamline decision-making, and support users in a wide range of professional tasks. Below are several key ways to effectively utilize Bridgit AI:

Troubleshooting and Diagnosing Logs

Navigate to the Logs menu, select either Application Logs or Service Logs, then click Refresh to retrieve the latest entries. Once the logs have loaded, locate the Messages column, right-click the relevant log entry, and select Ask Bridgit AI. This will open the Bridgit AI chat interface, providing more detailed insights and context for the selected log message.

Logs Menu

Logs

Bridgit AI Chat

Data Analysis and Interpretation

Bridgit analyzes raw report data to provide insights on trends, anomalies, and summaries, serving as a virtual data analyst.

Finished Reports Viewer - Summary Analysis

Using Bridgit AI Chat to Create Expression Syntax

How to use Bridgit AI Chat to quickly generate and refine expression syntax for your workflows. Below is an example of how to ask effective questions, provide the right context, and iterate on AI-generated responses to create accurate expressions tailored to your needs.

Ex: Bridgit Chat

Ex: Expression Editor

Ex: Expression column to show days to shipped and 0 if the shipped date is null.

Video Tutorial

Article Summary

This article introduces Bridgit AI, the integrated, OpenAI-powered assistant in VDM, designed to help users craft reports, write SQL queries, diagnose errors, and interpret data. Bridgit is your on-demand analyst and report writer, streamlining complex processes like data troubleshooting and visualization. It can provide real-time suggestions, clarify expression logic, and assist with best practices. Whether you're filtering a dataset, building dashboards, or investigating runtime errors, Bridgit is there to help. With a simple setup using an OpenAI API key, Bridgit integrates directly into VDM and can be further customized through profile-specific knowledge and administration tools such as the Knowledge Editor (Beta).