FAQ do Usuário

FAQ

Conta e Acesso

Como crio minha conta no Prodgy?

Acesse a página de registro, preencha seu email e crie uma senha (mínimo 8 caracteres, com maiuscula, minuscula, número e caractere especial). Você também pode usar login social com Google ou Microsoft. Após o registro, confirme seu email pelo link enviado.

Esqueci minha senha. Como recupero?

Na tela de login, clique em “Esqueceu a senha?”, informe seu email e siga o link de recuperação enviado. O link tem validade limitada. Se expirar, solicite um novo. Há proteção contra tentativas excessivas com cooldown progressivo (15 a 60 segundos).

Sim. Na tela de login, clique no botão do provedor desejado. No primeiro acesso via login social, uma conta será criada automaticamente é o onboarding será iniciado.

Como altero meu nome ou senha?

Acesse Configurações > Perfil. Para o nome, clique em editar e salve. Para a senha, use a opção “Alterar Senha” e siga os requisitos de segurança.

Como deleto minha conta?

Em Configurações > Perfil, na seção Zona de Perigo, clique em deletar conta e confirme com sua senha. A ação é permanente e irreversível — todos os dados serão perdidos.

O que é o Grupo de Sistema?

É um grupo especial que concede acesso a áreas avançadas como Logs da Organização, Workflows de Agentes, configuração de Pipelines e Embeddings da Base de Conhecimento. A adesão ao grupo é gerenciada internamente.

Como funciona a versão de avaliação (Trial)?

O acesso Trial é validado por uma lista de emails autorizados. Se seu email estiver na lista, o Trial será ativado durante o onboarding. Caso contrário, o acesso será negado com uma mensagem explicativa.

Organização

Como crio uma organização?

Durante o onboarding, preencha nome, website, descrição, setor, porte e estagio da empresa. Você pode usar o Magic Fill para preencher automaticamente com IA. Ao final, escolha entre plano Trial ou pago.

Posso alterar as informações da organização depois?

Sim. No Painel Administrativo > Organização, administradores podem editar nome, website, descrição, logo e modelo de IA padrão. As alterações são refletidas imediatamente.

Como deleto uma organização?

No Painel Administrativo > Zona de Perigo, digite o nome exato da organização para confirmar. A ação é irreversível e remove todos os workspaces, agentes, base de conhecimento, membros e dados de assinatura.

Quais papéis existem na organização?

Admin: acesso completo a todas as configurações, usuários e workspaces
User: acesso apenas aos workspaces atribuidos

Workspace e Workspaces

Como crio um novo workspace (workspace)?

No Painel Administrativo > Workspaces, clique em adicionar workspace. Preencha nome, descrição, website e logo. Opcionalmente, convide membros durante a criação. O recurso Magic Fill também está disponível.

Como convido membros para um workspace?

Em Configurações > Usuários, clique em convidar. Informe nome, email, função e selecione o workspace. Você pode acompanhar convites pendentes na mesma aba.

Como removo um membro de um workspace?

Em Configurações > Workspaces, edite o workspace, va na aba Usuários, desmarque o membro e salve. A remoção e imediata — para readicionar, será necessário um novo convite.

Como gerencio Tokens de API?

Em Configurações do Workspace > Tokens de API, você pode criar, copiar, regenerar, ativar/desativar e revogar tokens. Os tokens permitem integração com endpoints de agentes, execuções, webhooks, integrações e base de conhecimento.

O que acontece ao deletar um workspace?

Todos os dados, configurações, agentes, integrações e histórico são removidos permanentemente. Faça backup antes de deletar.

Painel Principal

O que é o Painel Principal?

E a tela principal ao selecionar um workspace, agregando dashboards de diferentes fontes: workspace, agentes, base de conhecimento e integrações externas.

Quais tipos de dashboards existem?

Workspace: consumo de créditos, tokens, eventos
Agentes: métricas de execução por agente (adicionados automaticamente na instalação)
Base de Conhecimento: documentos importados, pipelines, saude da base
Integrações: dados de ferramentas externas (DevOps, Git, Slack)

Posso personalizar os dashboards?

Sim. Você pode redimensionar (4 tamanhos), reordenar (arrastar e soltar), renomear, filtrar, exportar para CSV e adicionar/remover dashboards. Suas preferências são salvas automaticamente por usuário.

Remover um dashboard apaga os dados?

Não. Remover um dashboard apenas o oculta do painel. Você pode readiciona-lo a qualquer momento sem perda de dados.

Integrações

Quais integrações o Prodgy suporta?

O Prodgy suporta integrações com modelos de IA (OpenAI, Google Gemini, Anthropic, OpenRouter), gestão de projetos (GitHub, GitLab, Jira, Azure DevOps) e comunicação (Slack). Cada integração possui métodos de autenticação específicos (API Key, OAuth2, Bearer Token, etc.).

Como instalo uma integração?

Acesse Integrações > Catálogo, selecione a integração desejada, preencha os campos de configuração e autenticação, e clique em conectar. Após a instalação, verifique se o status e “Ativo”.

Por que não consigo remover uma integração?

Se a integração estiver sendo usada por organizações, agentes ou secrets, a remoção será bloqueada. Remova as dependências primeiro. Integrações gerenciadas pelo administrador também podem não ter opção de edição/remoção.

O que são MCP Tools?

São ferramentas registradas automaticamente ao instalar integrações, que permitem aos agentes de IA executar ações em serviços externos (criar issues, enviar mensagens no Slack, listar PRs, etc.). O orquestrador MCP analisa a intenção do usuário e roteia para a ferramenta adequada.

As integrações geram dashboards automaticamente?

Sim. Ao instalar uma integração, dashboards pré-configurados são adicionados automaticamente ao painel, exibindo métricas em tempo real da ferramenta conectada.

Base de Conhecimento

O que é a Base de Conhecimento?

E o repositório central de informações do seu produto no Prodgy. Ela alimenta agentes de IA com contexto, permite buscas semânticas e centraliza documentos, dados e informações do workspace.

Quais formatos de arquivo são suportados?

Formato	Extensoes
Planilhas	CSV, XLSX, XLS
Documentos	PDF, DOC, DOCX
Texto	TXT, MD, Markdown
Dados estruturados	JSON, XML

O tamanho máximo padrão por arquivo e de 50 MB.

O que são embeddings?

Embeddings são representações vetoriais dos documentos que permitem busca semântica — ou seja, encontrar informações por significado, não apenas por palavras-chave. São gerados automaticamente ao importar documentos.

O que são Pipelines?

Pipelines são agentes automatizados que coletam, transformam e importam dados de fontes externas para a base de conhecimento. Possuem catálogo pré-configurado com assistente de instalação.

O que são os Blocos de Informação do Workspace?

São seções editáveis na aba Visão Geral que descrevem aspectos do workspace. Há 11 tipos de blocos (texto, markdown, links, listas, código, personas, etc.). Podem ser gerados com IA ou criados manualmente. Precisam ser sincronizados para ficarem disponíveis aos agentes.

Operações na base consomem créditos?

Sim. Upload de documentos, geração de embeddings e armazenamento consomem créditos do plano. Se o plano estiver esgotado, uploads e processamentos serão bloqueados.

Playground

O que é o Playground?

E o ambiente de chat integrado do Prodgy para interação direta com agentes de IA. Suporta mensagens em tempo real com streaming, formatação Markdown, blocos de código e tabelas.

Como acesso o Playground?

Clique em “Playground” na barra lateral esquerda (ícone de play).

Posso exportar conversas?

Sim. Você pode exportar qualquer conversa para PDF, incluindo todas as mensagens, formatação e timestamps. O PDF é gerado no navegador e não é armazenado no servidor.

O que são os canais de exportação?

Permitem incorporar o chat do Playground em sites externos (Embed Chat) ou configurar webhooks para notificar sistemas como Slack, Teams, Zendesk e APIs REST quando eventos ocorrem.

Quem pode configurar o Playground?

As configurações avançadas (RAG, interface, restrições) são acessíveis apenas a usuários com papel Sistema. Incluem parâmetros como temperatura, máximo de tokens, prompt do sistema, tipos de arquivo permitidos e rate limiting.

O histórico de conversas é mantido?

Sim. Todas as conversas ficam no painel lateral com título e data. Você pode renomear, arquivar ou deletar conversas. Há cache de 5 minutos para carregamento rápido.

Agentes

O que são agentes no Prodgy?

São sistemas de IA configuráveis que executam tarefas específicas de forma autônoma, como especificação de PBIs, geração de testes, detalhamento de bugs e decomposição de epicos.

Quais agentes estão disponíveis?

Agente	Função
Backlog Writer	Converte ideias em PBIs e User Stories detalhados
Bug Specialist	Identifica e detalha bugs com relatórios estruturados
Epic Decomposer	Decompoe epicos complexos em tarefas técnicas
Task Builder	Converte requisitos em listas de tarefas técnicas
Test Designer	Gera cenários e casos de teste abrangentes
Effort Analyzer	Estima esforço para PBIs e User Stories

Como instalo um agente?

No Painel de Agentes, selecione o agente e siga o assistente de instalação: boas-vindas, integrações, prompts, parâmetros e resultados. Após a instalação, o agente fica disponível para uso e seus dashboards são adicionados automaticamente.

Posso personalizar os prompts e parâmetros?

Sim. Nas Configurações do Agente, você pode editar integrações, parâmetros, prompts, workflow visual, versões e acompanhar execuções. Cada alteração gera uma nova versão que pode ser publicada.

O que acontece ao desinstalar um agente?

A desinstalação remove permanentemente versões, histórico de execuções, configurações, webhooks e dashboards. A ação não pode ser desfeita.

Prodgy Assistant

O que é o Prodgy Assistant?

E um agente autonomo de IA que participa de reuniões no Microsoft Teams para capturar transcrições. Monitora emails, detecta convites de reunião, entra automaticamente e entrega a transcrição via webhook.

Quais são as modalidades de implantação?

Serviço (Cloud): gerenciado pelo Prodgy via Microsoft Graph API, sem instalação local
Plugin (Desktop): aplicativo para Windows/macOS com monitoramento de email via IMAP

Como agendo uma reunião com o bot?

Encaminhe o convite do Teams para o email do bot. O bot processa o convite, agenda a entrada e entra automaticamente 15 segundos antes do horário. Para múltiplos workspaces, use a notação [NomeDoProduto] no título da reunião.

O bot transcreve reuniões em outros idiomas?

Sim. Por padrão, o modelo detecta automaticamente o idioma do áudio. Para forçar um idioma específico, adicione {{lang:xx}} no corpo do email de convite (ex: {{lang:en}} para inglês, {{lang:es}} para espanhol). Isso é útil para reuniões com equipes internacionais.

O bot suporta reuniões recorrentes?

Sim. O bot detecta padrões de recorrência e expande automaticamente as ocorrências futuras dentro de um horizonte de 7 dias, com re-expansão a cada 12 horas.

O que acontece se eu cancelar uma reunião?

O cancelamento é detectado automaticamente. Nenhuma ação manual é necessária — a reunião é removida da agenda do bot.

O que é o Painel Administrativo do Assistant?

E o centro de controle com quatro seções: Agenda (reuniões ativas e pendentes), Histórico (eventos registrados com filtros e dashboards), Logs (logs do sistema em tempo real) e Configurações (parâmetros editáveis sem necessidade de editar arquivos).

Preciso reiniciar o serviço ao alterar configurações?

Não. As configurações salvas pelo painel usam hot-reload — as alterações são aplicadas automaticamente sem reinicio do serviço.

Comunicadores (Teams, Slack, Google Chat)

O que são comunicadores no Prodgy?

São integrações que permitem acessar os agentes e a Knowledge Base do Prodgy diretamente em plataformas de comunicação como Microsoft Teams, Slack e Google Chat. Os usuários conversam com o bot no comunicador e recebem respostas sem precisar abrir o Prodgy.

Como exporto um workspace para um comunicador?

Configure a integração do comunicador desejado em Integrações (com credenciais da plataforma)
No Playground, clique em Exportar e selecione o comunicador
Configure o endpoint/webhook na plataforma seguindo o guia específico

Veja os guias detalhados: MS Teams, Slack, Google Chat.

Preciso criar uma conta separada no comunicador?

Não. Na primeira vez, digite /prodgy login no comunicador para vincular sua conta Prodgy existente. O bot gera um link de autenticação (válido por 15 minutos) — basta clicar, fazer login no Prodgy e a conta fica vinculada.

Como seleciono qual workspace o bot deve usar?

Use /prodgy list para ver os workspaces disponíveis e /prodgy link <slug> para selecionar um. O workspace fica ativo até você trocar. Administradores também podem mapear canais específicos a workspaces (ex: canal #suporte sempre usa o workspace “Suporte”).

O bot suporta múltiplos workspaces ao mesmo tempo?

Sim. O mesmo bot pode atender vários workspaces. Cada usuário seleciona seu workspace ativo individualmente, e canais podem ser mapeados a workspaces diferentes.

Como limpo o histórico de conversa no comunicador?

Digite /prodgy clear (ou clear em DMs). A sessão atual é arquivada e a próxima mensagem inicia uma conversa nova. O histórico anterior não é perdido — apenas arquivado.

Por que a resposta do bot está cortada ou com texto estranho?

Isso geralmente ocorre quando o limite de tokens está muito alto, fazendo a LLM gerar respostas longas demais que perdem qualidade. Um administrador pode ajustar o parâmetro maxTokens nas configurações do comunicador (recomendado: 4096 a 8192).

O bot demora para responder. O que posso fazer?

O timeout padrão é 30 segundos. Para respostas mais rápidas, um administrador pode reduzir maxIterations (limita o loop de tool-calling) nas configurações do comunicador. Verifique também a latência do serviço Agentic.

O bot responde em que idioma?

O bot detecta automaticamente o idioma da sua mensagem e traduz as respostas para o mesmo idioma. Se você escreve em português, responde em português. Em inglês, responde em inglês.

Quais comandos o bot aceita?

Comando	Função
`/prodgy login`	Vincular conta Prodgy
`/prodgy logoff`	Desvincular conta (trocar de usuário)
`/prodgy list`	Ver workspaces disponíveis
`/prodgy link <slug>`	Selecionar workspace
`/prodgy clear`	Limpar conversa
`/prodgy help`	Ver ajuda

Como troco de conta Prodgy no comunicador?

Digite /prodgy logoff para desvincular a conta atual. Depois, use /prodgy login para autenticar com uma conta diferente. Isso é útil quando várias pessoas compartilham o mesmo dispositivo ou quando você precisa acessar workspaces de outra conta.

Não consigo ver nenhum workspace no `/prodgy list`. Por quê?

Verifique se: (1) você fez /prodgy login e autenticou sua conta, e (2) seu usuário Prodgy tem acesso aos workspaces via Gerenciamento de Usuários. Sem acesso atribuído, nenhum workspace será listado.

Painel Administrativo

Como acesso o Painel Administrativo?

Em Configurações > Painel Administrativo. O acesso depende do seu papel: Admin tem acesso a maioria das abas, Sistema tem acesso a todas, e Usuário tem acesso restrito.

O que posso gerenciar no Painel Administrativo?

Seção	Função
Organização	Nome, logo, website, modelo de IA padrão
Assinatura	Plano atual, créditos, consumo detalhado
Workspaces	Criar, editar e deletar workspaces
Usuários	Convidar, editar papéis e remover membros
Logs do Sistema	Visualizar logs em tempo real via SSE
Serviço de Email	Configurar SMTP, Microsoft 365 ou Google Workspace
Feedback	Configurar formulário e integração GA4
Zona de Perigo	Deletar organização permanentemente

Como funciona o sistema de créditos?

Cada plano tem um limite de créditos que são consumidos por operações como execuções de agentes, chats no Playground, embeddings, armazenamento e integrações. O contador de créditos na navbar mostra o consumo com cores: verde (abaixo de 70%), laranja (70-99%) e vermelho (100%).

Quais provedores de email são suportados?

SMTP (Nodemailer), Microsoft 365 (Graph API) e Google Workspace. A configuração inclui teste de conexão antes de salvar.

Navegação e Interface

Como navego entre workspaces?

Use o seletor de workspaces na navbar para alternar rapidamente entre os workspaces do workspace.

Posso alternar entre tema claro e escuro?

Sim. Use o botão de alternância de tema na navbar. Sua preferência é salva automaticamente.

Mostra o consumo de créditos do plano em uma barra de progresso colorida. Alertas são emitidos em 80%, 90%, 97% e 100% de uso.

Onde encontro ajuda?

No menu de ajuda da navbar, você pode acessar o manual do usuário é o tour guiado. Também pode contatar o suporte em support@prodgy.ai ou acessar help.prodgy.ai.