Painel de Configurações

Administração

Visão Geral

O dashboard do Prodgy Assistant inclui um painel de configurações integrado, acessível pelo ícone de engrenagem na barra de navegação. Ele abre como uma sidebar no lado direito da tela, onde administradores podem visualizar e modificar todas as seções de configuração organizadas em grupos logicos.

Configuração Visual

Edite configurações através de uma interface de formulário intuitiva — sem necessidade de editar arquivos JSON manualmente.

Organizado por Grupos

As configurações são organizadas em grupos logicos e seções retratieis para fácil navegação.

Seguro por Design

Campos sensíveis (secrets, chaves, certificados) são mascarados e so atualizados quando explicitamente alterados.

Persistência em Tempo Real

As alterações são salvas em um arquivo de override e aplicadas sem necessidade de novo deploy.

Acessando o Painel de Configurações

Faça login no dashboard do Prodgy Assistant com uma conta de administrador.
Clique no ícone de engrenagem na barra de navegação superior (ao lado do avatar do usuário).
A sidebar de configurações abre no lado direito da tela.
Clique no ícone de engrenagem novamente ou clique fora da sidebar para fecha-la.

Grupos de Configuração

As configurações são organizadas em dois grupos principais, cada um contendo múltiplas seções retratieis.

General

O grupo General contém as configurações principais do serviço do Assistant.

Seção	Descrição
Base URL	A URL base onde a API do Assistant está hospedada.
API Connection	Seleção do engine de transcrição e detalhes de conexão com a API Prodgy Back (URL, chave de API, nome do agente).
Queue Service	String de conexão e número do banco de dados Redis para a fila de mensagens.
Mailbox Service	Configurações de integração de email incluindo provedor, caixa de entrada, intervalo de polling, horizonte de recorrência, credenciais da Graph API e tempo máximo de espera.
Logs	Chave de API e caminho do diretório para o serviço de logs.

Microsoft Teams

O grupo Microsoft Teams contém configurações específicas para a integração com o bot do Teams.

Seção	Descrição
Azure AD	Credenciais do Azure Active Directory: Tenant ID, Client ID e Client Secret para autenticação.
Azure Bot	Configuração do bot: Bot User ID, nome de exibição, URL base e thumbprint do certificado.

Tipos de Campo

O painel de configurações suporta diferentes tipos de campo para cada valor de configuração:

Tipo	Descrição	Exemplo
Texto	Campo de texto padrão	Base URL, Agent Name
Número	Campo numerico	Database number, Poll Interval
Senha	Campo mascarado com toggle de visibilidade	API Keys, Client Secrets, Connection Strings
Toggle	Interruptor liga/desliga	Email Enabled

Como as Configurações São Salvas

As configurações modificadas pelo painel são persistidas em um arquivo separado chamado appsettings.overrides.json, localizado junto ao appsettings.json principal. Essa abordagem tem diversas vantagens:

Não destrutivo: O appsettings.json original nunca e modificado, preservando a configuração padrão.
Seguro para deploy: Os overrides sobrevivem a redeployments da aplicação, pois são armazenados em um arquivo separado.
Hot-reload: As alterações são aplicadas automaticamente via reload de configuração — sem necessidade de reiniciar o serviço.

Referência de Configuração

General — Base URL

Configuração	Caminho	Descrição
Assistant Base URL	`BaseUrl`	A URL pública onde a API do Assistant está acessível.

General — API Connection

Configuração	Caminho	Descrição
Engine	`TranscriptEngine`	O engine de processamento de transcrição (ex: `prodgy-back`).
Base URL	`ProdgyBack.BaseUrl`	URL da API Prodgy Back.
API Key	`ProdgyBack.ApiKey`	Chave de autenticação para a API Prodgy Back.
Agent Name	`ProdgyBack.AgentName`	Nome do agente utilizado para processamento de transcrição.

General — Queue Service

Configuração	Caminho	Descrição
Connection String	`Redis.ConnectionString`	String de conexão do Redis para a fila de mensagens.
Database	`Redis.Database`	Número do banco de dados Redis.

General — Mailbox Service

Configuração	Caminho	Descrição
Enabled	`Email.Enabled`	Habilitar ou desabilitar a integração de email.
Provider	`Email.Provider`	Tipo de provedor de email (ex: `microsoft365`, `google`).
Mailbox	`Email.Mailbox`	Endereço de email utilizado para receber convites de reunião.
Poll Interval	`Email.PollIntervalMinutes`	Frequência (em minutos) de verificação de novos emails.
Recurrence Horizon	`Email.RecurrenceHorizonDays`	Número de dias a frente para expandir padrões de reuniões recorrentes.
Max Wait Minutes	`GraphCommsBot.MaxWaitMinutes`	Tempo máximo (em minutos) de espera antes de sair de uma reunião sem atividade.
Graph Tenant ID	`Email.Graph.TenantId`	Azure AD Tenant ID para acesso ao email via Microsoft Graph.
Graph Client ID	`Email.Graph.ClientId`	Azure AD Client ID para acesso ao email via Microsoft Graph.
Graph Client Secret	`Email.Graph.ClientSecret`	Azure AD Client Secret para acesso ao email via Microsoft Graph.

General — Logs

Configuração	Caminho	Descrição
API Key	`LogsApi.ApiKey`	Chave de autenticação para a API de logs.
Logs Directory	`LogsApi.LogsDirectory`	Caminho no sistema de arquivos onde os arquivos de log são armazenados.

Microsoft Teams — Azure AD

Configuração	Caminho	Descrição
Tenant ID	`AzureAd.TenantId`	Azure AD Tenant ID para autenticação do bot no Teams.
Client ID	`AzureAd.ClientId`	Azure AD Application (Client) ID.
Client Secret	`AzureAd.ClientSecret`	Azure AD Client Secret.

Microsoft Teams — Azure Bot

Configuração	Caminho	Descrição
Bot User ID	`AzureAd.BotUserId`	O ID de usuário do Azure AD atribuido ao bot.
Bot Name	`GraphCommsBot.Name`	Nome de exibição do bot no Teams.
Base URL	`GraphCommsBot.BaseUrl`	URL pública para o endpoint de sinalização do bot.
Certificate Thumbprint	`GraphCommsBot.CertificateThumbprint`	Thumbprint do certificado utilizado para autenticação do bot.