Guia de Uso Institucional
Orientações de acesso, perfis de usuário, telas disponíveis e fluxos operacionais da plataforma de atendimento inteligente com governança algorítmica.
Índice
1. Visão geral da plataforma
O lab-ia é uma plataforma de atendimento institucional inteligente para redes educacionais. Ela utiliza inteligência artificial para responder dúvidas de famílias, alunos e servidores com base em documentos oficiais da escola e da secretaria de educação.
Toda resposta gerada pela IA é rastreável: possui score de confiança, fonte documental, nível de risco e trilha de auditoria. O sistema não decide — ele orienta, e um ser humano sempre pode revisar, corrigir ou escalar.
Principais capacidades:
- Atendimento por webchat com assistentes temáticos (público, secretaria, tesouraria, direção)
- Base de conhecimento versionada com FAQ, calendário, matrícula e avisos
- Módulo pedagógico com curadoria por disciplina e assistente para estudantes
- Auditoria formal com timeline de eventos, incidentes e correções
- Painel de indicadores operacionais e de governança
- Controle de acesso por perfil (RBAC) com permissões granulares
2. Como acessar
O acesso é feito por convite. Não há autocadastro. Um administrador (superadmin ou gestor de rede) envia um convite com e-mail e perfil. O convidado recebe um link para ativar a conta e definir a senha.
Passo a passo
- Você recebe um e-mail de convite com o assunto "Convite para a plataforma lab-ia"
- Clique no link do e-mail — você será direcionado para a tela de ativação de conta
- Defina sua senha (minimo 6 caracteres)
- Após a ativação, acesse o sistema pelo endereço da plataforma e faça login com e-mail e senha
- O sistema direcionará você automaticamente para a tela inicial do seu perfil
Esqueci minha senha
Na tela de login, clique em "Recuperar acesso com redefinição de senha". Informe seu e-mail institucional e você receberá um link para redefinir a senha.
Sessão e segurança
- Sessões expiram após 30 minutos de inatividade
- Toda ação é registrada com identificação do usuário
- A comunicação é criptografada (HTTPS)
Credenciais de teste (Sandbox)
Os usuários abaixo estão disponíveis para avaliação do sistema durante o período de sandbox. Todos utilizam a senha padrão: 123456789, salvo indicação contrária.
Perfis de plataforma
| Perfil | Nome | Escola | Senha | |
|---|---|---|---|---|
| Superadmin | Administrador | admin@lab-ia.gov.br |
Todas | Test12345! |
| Auditor | Auditor Externo | auditor.externo@lab-ia.gov.br |
Todas | 123456789 |
CEF 01 de Brasília (SEEDF)
| Perfil | Nome | Senha | |
|---|---|---|---|
| Gestor de Rede | Gestor de Rede DF | gestor.rede-a@lab-ia.gov.br |
123456789 |
| Curador de Conteúdo | Curador CEF01 | curador.cef01@lab-ia.gov.br |
123456789 |
| Operador Público | Operador CEF01 | operador.cef01@lab-ia.gov.br |
123456789 |
| Secretaria | Maria da Secretaria | secretaria.cef01@lab-ia.gov.br |
123456789 |
| Coordenação | João da Coordenação | coordenacao.cef01@lab-ia.gov.br |
123456789 |
| Professor | Professor CEF01 | professor.cef01@lab-ia.gov.br |
prof123456 |
| Direção | Diretor CEF01 | direcao.cef01@lab-ia.gov.br |
123456789 |
| Observador | Observador CEF01 | observador.cef01@lab-ia.gov.br |
123456789 |
CEPI Lyceu de Goiânia (SEDUC-GO)
| Perfil | Nome | Senha | |
|---|---|---|---|
| Gestor de Rede | Gestor de Rede GO | gestor.rede-b@lab-ia.gov.br |
123456789 |
| Curador de Conteúdo | Curador CEPI | curador.cepi@lab-ia.gov.br |
123456789 |
| Operador Público | Operador CEPI | operador.cepi@lab-ia.gov.br |
123456789 |
| Secretaria | Secretaria CEPI | secretaria.cepi@lab-ia.gov.br |
123456789 |
| Coordenação | Coordenação CEPI | coordenacao.cepi@lab-ia.gov.br |
123456789 |
| Professor | Professor CEPI | professor.cepi@lab-ia.gov.br |
prof123456 |
| Direção | Diretor CEPI | direcao.cepi@lab-ia.gov.br |
123456789 |
| Observador | Observador CEPI | observador.cepi@lab-ia.gov.br |
123456789 |
Os usuários de escola acima devem ser cadastrados pelo gestor de rede na tela de Usuários (individualmente ou por importação em lote). A senha padrão do sandbox e 123456789.
3. Perfis e permissões
Cada usuário recebe um perfil (role) que determina quais telas pode acessar e quais ações pode realizar. Existem dois níveis:
- Perfis de plataforma: Superadmin e Auditor — acesso global, sem vínculo a escola específica
- Perfis de escola: vinculados a uma escola, com acesso restrito ao contexto daquela instituição
| Perfil | Nível | Descrição | Tela inicial |
|---|---|---|---|
| Superadmin | Plataforma | Acesso total a todas as funcionalidades, escolas e configurações do sistema | Dashboard |
| Auditor | Plataforma | Acesso a auditoria formal, incidentes, feedback, correções e relatórios — em todas as escolas | Dashboard |
| Gestor de Rede | Escola | Administra a escola no sistema: usuários, preferências, conhecimento, conteúdo e governança | Dashboard |
| Curador de Conteúdo | Escola | Gerencia a base de conhecimento, FAQ, calendário e conteúdo oficial que alimenta a IA | Dashboard |
| Operador Público | Escola | Opera o atendimento via chat — vê conversas, trata fila humana e registra feedback | Atendimento |
| Secretaria | Escola | Gerencia comunicados, conteúdo oficial e acompanha atendimento da secretaria | Comunicados |
| Coordenação | Escola | Supervisiona atendimento, aprova conteúdo pedagógico, acompanha governança | Dashboard |
| Professor | Escola | Publica e gerencia conteúdo pedagógico da sua disciplina para o assistente de estudantes | Curadoria Pedagógica |
| Direção | Escola | Visão gerencial: dashboards, auditoria, incidentes, relatórios e visão da rede | Dashboard |
| Observador | Escola | Acesso somente leitura a comunicados, dashboard, relatórios, base de conhecimento | Comunicados |
4. Telas do sistema
O sistema possui 18 telas organizadas em três grupos no menu lateral:
Atendimento
| Tela | O que faz |
|---|---|
| Inteligência (Dashboard) | Painel com métricas operacionais: volume de consultas, score de confiança, taxa de abstinência, temas mais perguntados, distribuição por assistente e indicadores de governança |
| Atendimento | Central de conversas do chat com a IA. Mostra histórico, fontes usadas, score de risco e permite tratamento (escalar, encaminhar, abrir incidente) |
| Fila Humana | Fila de solicitações que a IA não conseguiu resolver e que precisam de atendimento humano |
| Comunicados | Mural de comunicados internos da escola para equipe |
Gestão
| Tela | O que faz |
|---|---|
| Relatórios | Relatórios consolidados de operação, atendimento e governança por período |
| Auditoria Formal | Timeline completa de cada resposta da IA: fonte, score, risco, revisão, incidentes e correções vinculadas |
| Incidentes | Gerenciamento de ocorrências: abertura, classificação por severidade, roteamento e resolução |
| Feedback da IA | Avaliações de respostas (útil, não útil, incorreto) com rastreabilidade até a resposta original |
| Correções | Propostas de correção na base de conhecimento: proposta, aprovação, aplicação automática com registro antes/depois |
| Ciclo de Melhoria | Visão integrada do ciclo feedback → incidente → correção → melhoria da base |
| Notificações | Central de alertas do sistema: novas correções, incidentes, feedbacks pendentes |
| Lacunas de Conhecimento | Temas consultados pela IA sem cobertura documental suficiente — aponta onde a base precisa crescer |
| Visão da Rede | Painel comparativo entre escolas da rede: volume, qualidade, governança |
Configurações
| Tela | O que faz |
|---|---|
| Usuários | Convite, edição de perfil, ativação/inativação de membros. Apenas superadmin e gestor de rede |
| Preferências | Configurações do sistema: parâmetros de IA, thresholds de evidência, nome da instituição |
| Base de Conhecimento | Upload e gerenciamento de documentos que alimentam a IA (embedding + busca semântica) |
| Conteúdo Oficial | Calendário escolar, orientações de matrícula, FAQ institucional, avisos oficiais — com versionamento |
| Curadoria Pedagógica | Publicação de materiais didáticos por disciplina para o assistente de estudantes |
| Governança Pedagógica | Painel de supervisão da curadoria: aprovação de conteúdo, indicadores de publicação e uso |
5. Guia por perfil
Superadmin
Responsabilidade: Administração completa da plataforma. Gerencia escolas, usuários, configurações globais e tem visibilidade total sobre todos os dados e fluxos.
Telas disponíveis:
- Todas as 18 telas
Ações exclusivas: convidar usuários, alterar perfis, configurar preferências do sistema, gerenciar permissões por escola.
Gestor de Rede
Responsabilidade: Administra a escola dentro da plataforma. Controla usuários, conteúdo, base de conhecimento e acompanha indicadores.
Telas disponíveis:
- Dashboard
- Atendimento
- Fila Humana
- Comunicados
- Relatórios
- Auditoria Formal
- Incidentes
- Feedback da IA
- Correções
- Ciclo de Melhoria
- Notificações
- Lacunas
- Visao da Rede
- Usuarios
- Preferências
- Base de Conhecimento
- Conteudo Oficial
- Curadoria Pedagogica
- Governança Pedagogica
Fluxo típico: Convida equipe → publica base de conhecimento → configura assistentes → monitora dashboard → trata incidentes quando necessário.
Curador de Conteúdo
Responsabilidade: Manter atualizada a base documental que alimenta a IA. Publica FAQ, calendário, orientações e garante que as fontes estejam versionadas e corretas.
Telas disponíveis:
- Dashboard
- Comunicados
- Relatórios
- Auditoria Formal
- Incidentes
- Feedback da IA
- Correções
- Ciclo de Melhoria
- Base de Conhecimento
- Conteudo Oficial
- Curadoria Pedagogica
- Governança Pedagogica
Fluxo típico: Recebe documento oficial → publica na base → IA passa a usar como fonte → monitora lacunas para saber onde falta conteúdo → aplica correções quando necessário.
Operador Público
Responsabilidade: Opera o atendimento do dia. Acompanha conversas, trata solicitações da fila humana, registra feedback sobre respostas da IA e abre incidentes quando necessário.
Telas disponíveis:
- Dashboard
- Atendimento
- Fila Humana
- Comunicados
- Relatórios
- Incidentes
- Feedback da IA
- Correções
- Base de Conhecimento
Fluxo típico: Monitora chat → vê que IA respondeu com risco médio → avalia a resposta → registra feedback (útil/incorreto) → se incorreto, abre incidente ou propõe correção na base.
Secretaria
Responsabilidade: Gerencia comunicados, acompanha o atendimento da secretaria escolar e mantém conteúdo oficial atualizado (matrícula, documentos, orientações).
Telas disponíveis:
- Dashboard
- Atendimento
- Fila Humana
- Comunicados
- Notificações
- Lacunas
- Base de Conhecimento
- Conteudo Oficial
Fluxo típico: Cria comunicado → publica conteúdo oficial (ex: novo calendário) → IA passa a responder com base nesse conteúdo → verifica lacunas para identificar temas sem cobertura.
Coordenação Pedagógica
Responsabilidade: Supervisiona o atendimento e a curadoria pedagógica. Aprova conteúdo publicado por professores, acompanha indicadores de uso educacional e trata incidentes pedagógicos.
Telas disponíveis:
- Dashboard
- Atendimento
- Fila Humana
- Comunicados
- Relatórios
- Incidentes
- Notificações
- Base de Conhecimento
- Conteudo Oficial
- Curadoria Pedagogica
- Governança Pedagogica
Fluxo típico: Professor publica material → coordenação aprova → IA disponibiliza para alunos → monitora governança pedagógica → trata incidentes se houver conteúdo inadequado.
Professor
Responsabilidade: Publica e gerencia conteúdo pedagógico da sua disciplina. O material aprovado alimenta o assistente de estudantes para dúvidas sobre a matéria.
Telas disponíveis:
- Comunicados
- Notificações
- Curadoria Pedagogica
- Governança Pedagogica
Fluxo típico: Acessa Curadoria Pedagógica → publica material da disciplina → aguarda aprovação da coordenação → acompanha na Governança Pedagógica os indicadores de uso pelos alunos.
Direção
Responsabilidade: Visão gerencial da escola. Acompanha indicadores, auditoria, incidentes e supervisiona a qualidade do atendimento.
Telas disponíveis:
- Dashboard
- Atendimento
- Fila Humana
- Comunicados
- Relatórios
- Auditoria Formal
- Incidentes
- Feedback da IA
- Correções
- Ciclo de Melhoria
- Notificações
- Lacunas
- Visao da Rede
- Base de Conhecimento
- Conteudo Oficial
- Curadoria Pedagogica
- Governança Pedagogica
Fluxo típico: Consulta Dashboard → analisa incidentes abertos → verifica auditoria de respostas críticas → acompanha correções aplicadas → avalia relatórios periódicos.
Auditor
Responsabilidade: Fiscaliza a qualidade e a conformidade das respostas da IA. Acessa trilhas de auditoria, incidentes, feedback e relatórios de governança.
Telas disponíveis:
- Dashboard
- Relatórios
- Auditoria Formal
- Incidentes
- Feedback da IA
- Correções
- Ciclo de Melhoria
- Notificações
- Visao da Rede
Fluxo típico: Acessa Auditoria Formal → seleciona evento → vê timeline completa (fonte, score, risco, feedback, incidentes vinculados) → verifica se correções foram aplicadas corretamente.
Observador
Responsabilidade: Acesso somente leitura para acompanhamento institucional. Não realiza ações — apenas visualiza indicadores, comunicados e relatórios.
Telas disponíveis:
- Dashboard
- Comunicados
- Relatórios
- Base de Conhecimento
Fluxo típico: Acessa o sistema → consulta comunicados e dashboard → verifica relatórios periódicos.
6. Fluxos operacionais
6.1 Fluxo de atendimento público
Quando uma família ou aluno faz uma pergunta pelo chat:
Se a evidência for insuficiente: a IA se abstém, marca alto risco e recomenda revisão humana. A resposta entra na Fila Humana.
Perfis envolvidos: Operador Público Secretaria Coordenação
6.2 Fluxo de governança pós-resposta
Após cada resposta da IA, inicia-se o ciclo de governança:
Perfis envolvidos: Operador Público Curador Auditor Direção
6.3 Fluxo de curadoria de conteúdo
Como um documento oficial chega até a base que a IA utiliza:
Perfis envolvidos: Curador de Conteúdo Secretaria Gestor de Rede
6.4 Fluxo de curadoria pedagógica
Como o conteúdo do professor chega até o assistente de estudantes:
Perfis envolvidos: Professor Coordenação Curador
6.5 Fluxo de gestão de incidentes
Quando uma resposta incorreta ou um problema é identificado:
Perfis envolvidos: Operador Auditor Direção Gestor de Rede
7. Governança e auditoria
Toda resposta da IA gera automaticamente um registro de auditoria contendo:
| Dado registrado | Descrição |
|---|---|
| Score de confiança | Valor de 0 a 1 indicando o quanto a resposta é sustentada por fontes |
| Score de evidência | Qualidade da base documental recuperada |
| Nível de risco | Baixo, médio ou alto — baseado nos thresholds de evidência |
| Fonte consultada | Título e versão do documento usado na resposta |
| Status de revisão | Se a resposta requer revisão humana |
| Fallback humano | Se a IA recomendou encaminhamento para atendente |
A tela de Auditoria Formal permite navegar pela timeline de eventos: ver a pergunta original, a resposta da IA, os feedbacks recebidos, incidentes abertos e correções aplicadas — tudo vinculado em uma única trilha.
Estados decisórios da IA:
| Estado | Quando ocorre | O que a IA faz |
|---|---|---|
| SAFE_TO_ANSWER | Evidência forte (score ≥ 0.78) | Responde com segurança, registra fonte e confiança |
| ANSWER_WITH_WARNING | Evidência parcial (0.58 a 0.78) | Responde de forma conservadora, marca revisão requerida |
| ABSTAIN_AND_REVIEW | Evidência insuficiente (< 0.58) | Não responde conclusivamente, recomenda revisão humana |
8. Módulo pedagógico
O modulo pedagogico permite que professores publiquem materiais didaticos por disciplina e turma. O conteúdo aprovado pela Coordenação alimenta um assistente de estudantes que responde duvidas sobre a materia.
Como funciona para o professor
- Acesse Curadoria Pedagógica no menu
- Selecione a disciplina e a turma
- Publique o material (texto, resumo, exercícios, orientações)
- O material ficará com status "pendente" até que a coordenação aprove
- Após aprovado, o conteúdo será embeddado e estará disponível para a IA
Como funciona para a coordenação
- Acesse Governança Pedagógica no menu
- Veja materiais pendentes de aprovação
- Revise o conteúdo e aprove ou rejeite com justificativa
- Acompanhe indicadores: materiais por disciplina, sessões de estudantes, temas mais consultados
Para o estudante
O estudante acessa o chat público da escola e pode perguntar sobre a matéria. A IA responde usando exclusivamente o conteúdo aprovado e publicado pelo professor daquela disciplina.
9. Suporte e dúvidas
Em caso de dificuldade de acesso, dúvidas sobre funcionalidades ou problemas técnicos:
- Fale com o gestor de rede ou superadmin da sua instituição
- Na tela de login, use o link "Suporte para credenciais e permissões"
- Dentro do sistema, use o menu de Notificações para acompanhar alertas pendentes
Este guia está disponível sem necessidade de login no endereço /guia-uso.