Curadoria de Conhecimento
Deixar a IA gerar conteúdo e colocá-lo em uso direto seria arriscado; revisar tudo em planilhas paralelas, lento e sem rastro. A Curadoria de Conhecimento resolve esse dilema: todo ativo gerado por IA — documento otimizado, FAQ e glossário — nasce como rascunho e só entra em uso depois que uma pessoa compara o conteúdo com os trechos-fonte, edita se precisar e aprova, com trilha de auditoria de cada decisão. Você ganha a velocidade da geração automática sem abrir mão do controle humano.
A curadoria não é acessório: é o portão de segurança funcional de todo o ciclo. Um termo de glossário só passa a influenciar a busca do chat depois de aprovado, e a exportação de conteúdo para sistemas externos só serve o que já foi aprovado.
Para entender como os ativos são gerados, veja o guia de preparação de conhecimento.
Como chegar à página (estado atual): a Curadoria de Conhecimento ainda não tem entrada no menu — acesse pelo endereço direto
/curadoria-conhecimento.html. O breadcrumb já mostra Governança › Curadoria de Conhecimento, e a ligação ao menu está pendente.
As quatro abas
A página se organiza em quatro abas, cada uma com link direto — dá para favoritar a que você mais usa:
| Aba | O que mostra |
|---|---|
| Fila de revisão | Ativos em rascunho, paginados (20 por página, mais recentes primeiro), filtráveis por domínio e tipo, com seleção múltipla para ações em lote |
| Glossário | Termos em rascunho do catálogo, com edição inline da definição e aprovação/rejeição em lote |
| Decisões de fonte | Documentos que sumiram da origem monitorada, aguardando decisão humana |
| Indicadores | Painel operacional da base (funil de curadoria, backlog, qualidade da geração, últimos lotes) |
Revisando um ativo (lado a lado)
Clique em um item da fila para abrir o painel de revisão:
- Esquerda: o conteúdo gerado (seções, pares de pergunta e resposta ou termos).
- Direita: os trechos-fonte citados — apenas os trechos do documento original que fundamentam cada item. É aqui que você confere, sem sair da tela, se a IA realmente se apoiou no documento. Em telas estreitas as duas visões viram as abas "Gerado" e "Fonte".
Editar antes de aprovar
O ícone de lápis abre um editor de texto por item. Aplicar (prévia) só atualiza a tela; Salvar edição grava de fato — o ativo continua em rascunho, fica marcado como editado por humano e mantém a mesma versão. Um banner âmbar avisa quando há edições não salvas, e o botão Aprovar fica desabilitado até você salvar: você nunca aprova algo diferente do que está vendo.
A edição passa pela mesma validação de fontes da geração, porém mais rígida: todo item precisa manter ao menos uma citação de trecho real do documento — uma citação inválida rejeita a edição com uma mensagem explicando o motivo.
Aprovar ou rejeitar
- Aprovar — pede confirmação num dialog da própria interface; ao confirmar, aparece o aviso "Ativo aprovado. Já elegível para uso no retrieval.".
- Rejeitar — o dialog exige o motivo (campo obrigatório, que "fica registrado na auditoria"); o ativo vira REJECTED e sai da fila.
Diff entre versões
Quando o item tem uma versão aprovada anterior (re-geração depois de uma mudança no documento de origem), aparece o link Ver mudanças. A comparação é calculada no servidor, item a item — seção, pergunta ou termo, casados pela chave: pills ADICIONADO / REMOVIDO / ALTERADO / IGUAL, e itens alterados curtos ganham comparação linha a linha (verde e vermelho). Você revisa só o que mudou, em vez de reler tudo.
Aprovação em lote
Selecione itens na fila pelas caixas de seleção — a barra de lote aparece com Aprovar / Rejeitar / Limpar. O dialog de confirmação mostra a contagem exata e avisa: "Cada item gera um evento de auditoria individual.". A rejeição em lote também exige motivo, aplicado a todos.
- Até 200 ativos por operação de lote (o glossário aceita até 500 termos).
- A falha de um item não derruba o lote: o resultado informa "N com sucesso, M falha(s)" com os motivos por item.
- Termos de glossário aprovados passam a ser resolvidos pelo chat em até 5 minutos — é a janela do cache que os serve.
Exemplo prático — revisando um lote de FAQ
- Um lote de geração terminou para o domínio de normas (você acompanhou pela aba Indicadores). Abra a Curadoria de Conhecimento.
- Na aba Fila de revisão, filtre por tipo FAQ. Aparecem 12 rascunhos da "Portaria 1.234/2026".
- Clique no primeiro. À esquerda, o par "Quem pode solicitar o benefício? / Servidores ativos com mais de 5 anos…"; à direita, o trecho da portaria que fundamenta a resposta. Confere.
- Em um dos pares, a resposta está correta mas verbosa: clique no lápis, enxugue o texto, Salvar edição e então Aprovar.
- Volte à fila, selecione os 10 pares restantes que você já conferiu e use a barra de lote: Aprovar → confirme. Cada aprovação fica auditada individualmente.
- Em minutos o FAQ aprovado já está elegível para a busca do chat e para a exportação externa.
Glossário
A aba lista os termos em rascunho do catálogo, com a proveniência (de qual documento cada termo nasceu) para os que vieram da geração automática. Você pode:
- editar a definição inline;
- aprovar ou rejeitar em lote.
Quem tem apenas visualização de catálogo vê a lista em modo somente-leitura; editar e agir em lote exigem a permissão GLOSSARY_EDIT.
Decisões de fonte
Documentos que sumiram da origem monitorada não são desativados automaticamente — a decisão é sua. A aba lista os documentos marcados como fora da origem no domínio selecionado, para triagem humana.
Estado atual: o botão Desativar documento está desabilitado ("Disponível em breve") — a ação depende da integração com o ciclo de vigência de documentos, ainda não disponível. A listagem já funciona e permite a triagem manual.
Indicadores
O painel é agregado no servidor e se atualiza sozinho a cada 60 segundos; aprovações recentes aparecem em até 1 minuto, porque o cache de 60 segundos é invalidado a cada aprovação.
| Indicador | Significado |
|---|---|
| Funil de curadoria | contagem por status: rascunho / aprovados / rejeitados / depreciados |
| Backlog antigo | rascunhos com mais de 7 dias — sinal de fila represada |
| Aprovação sem edição | % de aprovados que não precisaram de edição humana (termômetro da qualidade da geração; meta ≥ 70%) |
| Por tipo de ativo | distribuição documento otimizado / FAQ / glossário |
| Últimos lotes de geração | até 5 execuções recentes com totais e falhas |
O frescor por fonte monitorada aparece como "em desenvolvimento" — esse dado ainda não é preenchido e chega junto com a integração do monitoramento de fontes.
Permissões por ação
A interface esconde ou desabilita o que você não pode fazer, lendo as permissões do seu próprio acesso, mas a regra vale no servidor: chamadas diretas sem permissão são negadas com mensagem em português e ficam auditadas.
| Ação | Permissão exigida |
|---|---|
| Abrir a página, ver fila / ativo / fonte / diff / indicadores | KNOWLEDGE_ASSET_VIEW |
| Aprovar ou rejeitar (individual e em lote), editar conteúdo | KNOWLEDGE_ASSET_APPROVE |
| Editar ou aprovar termos do glossário | GLOSSARY_EDIT (listar exige CATALOG_VIEW) |
| Desativar documento fora da origem | KNOWLEDGE_ASSET_APPROVE (ação ainda indisponível) |
Perfis padrão: administradores e stewards (ADVANCEDUSER) aprovam; analistas apenas visualizam. Sem `KNOWLEDGEASSET_APPROVE`, a página mostra "Você está em modo de visualização.". Essas operações também estão disponíveis pela referência de API.
Comportamento e acessibilidade
- Confirmações em dialogs da própria interface (nunca janelas nativas do navegador); Escape fecha e o foco é gerenciado.
- Avisos de sucesso e erro em português com fechamento automático em 5 segundos; erros de rede, de permissão e de funcionalidade ainda indisponível têm mensagens específicas e botão Tentar novamente.
- Carregamento com skeletons; toda aba tem orientação quando está vazia.
- Layout responsivo: no celular, a fila empilha e a revisão lado a lado vira abas.
- A página é instrumentada com telemetria de frontend, que acompanha cada ação e a liga à chamada correspondente no servidor.
Solução de problemas
| Sintoma | Causa provável | O que fazer |
|---|---|---|
| "Você não tem permissão para esta ação." | Perfil sem KNOWLEDGE_ASSET_APPROVE ou GLOSSARY_EDIT | Pedir a permissão ao administrador (perfis steward e admin já a possuem) |
| Aprovar desabilitado no painel de revisão | Edições não salvas | Clicar em Salvar edição (ou descartar) antes de aprovar |
| "Funcionalidade ainda não disponível." | Ação Desativar documento ainda não integrada ao ciclo de vigência | Aguardar a entrega da integração; a listagem já permite triagem manual |
| Termo aprovado não muda o chat na hora | Janela de propagação do glossário, de até 5 minutos | Esperar a janela do cache |
| Indicadores parados | Cache de 60 segundos somado à atualização automática de 60 segundos | Usar o botão de atualização manual; se persistir, acionar o administrador |
| Fila vazia mas há documentos no domínio | Nenhuma geração foi disparada, ou tudo já foi revisado | Disparar a geração (veja o guia de preparação de conhecimento) |