Settings Panel

Administration

Tip

The settings panel allows administrators to configure the Assistant directly from the dashboard, without manually editing configuration files or restarting the service.

Overview

The Prodgy Assistant dashboard includes a built-in settings panel accessible via the gear icon in the navigation bar. It opens as a sidebar on the right side of the screen, where administrators can view and modify all configuration sections organized into logical groups.

Visual Configuration

Edit settings through an intuitive form interface — no need to edit JSON files manually.

Organized by Groups

Settings are organized into logical groups and collapsible sections for easy navigation.

Secure by Design

Sensitive fields (secrets, keys, certificates) are masked and only updated when explicitly changed.

Live Persistence

Changes are saved to an override file and applied without redeployment.

---

Accessing the Settings Panel

1. Log in to the Prodgy Assistant dashboard with an administrator account.
2. Click the gear icon in the top navigation bar (next to the user avatar).
3. The settings sidebar opens on the right side of the screen.
4. Click the gear icon again or click outside the sidebar to close it.

Caution

Access to the settings panel requires administrator permissions (JWT Bearer with system role).

---

Configuration Groups

Settings are organized into two main groups, each containing multiple collapsible sections.

General

The General group contains the core configuration for the Assistant service.

Section	Description
Base URL	The base URL where the Assistant API is hosted.
API Connection	Transcript engine selection and Prodgy Back API connection details (URL, API key, agent name).
Queue Service	Redis connection string and database number for the message queue.
Mailbox Service	Email integration settings including provider, mailbox, polling interval, recurrence horizon, Graph API credentials, and maximum wait time.
Logs	API key and directory path for the logging service.

Microsoft Teams

The Microsoft Teams group contains settings specific to the Teams bot integration.

Section	Description
Azure AD	Azure Active Directory credentials: Tenant ID, Client ID, and Client Secret for authentication.
Azure Bot	Bot configuration: Bot User ID, display name, base URL, and certificate thumbprint.

---

Field Types

The settings panel supports different field types for each configuration value:

Type	Description	Example
Text	Standard text input	Base URL, Agent Name
Number	Numeric input	Database number, Poll Interval
Password	Masked input with visibility toggle	API Keys, Client Secrets, Connection Strings
Toggle	On/off switch	Email Enabled

Note

Password fields display *** for existing values. If you save without changing a password field, the original value is preserved — it will not be overwritten with the masked value.

---

How Settings Are Saved

Settings modified through the panel are persisted in a separate file called appsettings.overrides.json, located alongside the main appsettings.json. This approach has several advantages:

• Non-destructive: The original appsettings.json is never modified, preserving the default configuration.
• Deploy-safe: Overrides survive application redeployments since they are stored in a separate file.
• Hot-reload: Changes are applied automatically via configuration reload — no service restart required.

Tip

The override file takes precedence over the base configuration. To revert a setting to its default, simply remove it from appsettings.overrides.json.

---

Configuration Reference

General — Base URL

Setting	Path	Description
Assistant Base URL	BaseUrl	The public URL where the Assistant API is accessible.

General — API Connection

Setting	Path	Description
Engine	TranscriptEngine	The transcript processing engine (e.g., prodgy-back).
Base URL	ProdgyBack.BaseUrl	URL of the Prodgy Back API.
API Key	ProdgyBack.ApiKey	Authentication key for the Prodgy Back API.
Agent Name	ProdgyBack.AgentName	Name of the agent used for transcription processing.

General — Queue Service

Setting	Path	Description
Connection String	Redis.ConnectionString	Redis connection string for the message queue.
Database	Redis.Database	Redis database number.

General — Mailbox Service

Setting	Path	Description
Enabled	Email.Enabled	Enable or disable the email integration.
Provider	Email.Provider	Email provider type (e.g., microsoft365, google).
Mailbox	Email.Mailbox	Email address used for receiving meeting invitations.
Poll Interval	Email.PollIntervalMinutes	How often (in minutes) to check for new emails.
Recurrence Horizon	Email.RecurrenceHorizonDays	Number of days ahead to expand recurring meeting patterns.
Max Wait Minutes	GraphCommsBot.MaxWaitMinutes	Maximum time (in minutes) to wait before leaving a meeting with no activity.
Graph Tenant ID	Email.Graph.TenantId	Azure AD Tenant ID for Microsoft Graph email access.
Graph Client ID	Email.Graph.ClientId	Azure AD Client ID for Microsoft Graph email access.
Graph Client Secret	Email.Graph.ClientSecret	Azure AD Client Secret for Microsoft Graph email access.

General — Logs

Setting	Path	Description
API Key	LogsApi.ApiKey	Authentication key for the logging API.
Logs Directory	LogsApi.LogsDirectory	File system path where log files are stored.

Microsoft Teams — Azure AD

Setting	Path	Description
Tenant ID	AzureAd.TenantId	Azure AD Tenant ID for Teams bot authentication.
Client ID	AzureAd.ClientId	Azure AD Application (Client) ID.
Client Secret	AzureAd.ClientSecret	Azure AD Client Secret.

Microsoft Teams — Azure Bot

Setting	Path	Description
Bot User ID	AzureAd.BotUserId	The Azure AD user ID assigned to the bot.
Bot Name	GraphCommsBot.Name	Display name of the bot in Teams.
Base URL	GraphCommsBot.BaseUrl	Public URL for the bot’s signaling endpoint.
Certificate Thumbprint	GraphCommsBot.CertificateThumbprint	Thumbprint of the certificate used for bot authentication.