PT EN
Voltar ao site

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:

AbaO que mostra
Fila de revisãoAtivos 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árioTermos em rascunho do catálogo, com edição inline da definição e aprovação/rejeição em lote
Decisões de fonteDocumentos que sumiram da origem monitorada, aguardando decisão humana
IndicadoresPainel 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

  1. Um lote de geração terminou para o domínio de normas (você acompanhou pela aba Indicadores). Abra a Curadoria de Conhecimento.
  2. Na aba Fila de revisão, filtre por tipo FAQ. Aparecem 12 rascunhos da "Portaria 1.234/2026".
  3. 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.
  4. Em um dos pares, a resposta está correta mas verbosa: clique no lápis, enxugue o texto, Salvar edição e então Aprovar.
  5. 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.
  6. 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.

IndicadorSignificado
Funil de curadoriacontagem por status: rascunho / aprovados / rejeitados / depreciados
Backlog antigorascunhos 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 ativodistribuição documento otimizado / FAQ / glossário
Últimos lotes de geraçãoaté 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çãoPermissão exigida
Abrir a página, ver fila / ativo / fonte / diff / indicadoresKNOWLEDGE_ASSET_VIEW
Aprovar ou rejeitar (individual e em lote), editar conteúdoKNOWLEDGE_ASSET_APPROVE
Editar ou aprovar termos do glossárioGLOSSARY_EDIT (listar exige CATALOG_VIEW)
Desativar documento fora da origemKNOWLEDGE_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

SintomaCausa provávelO que fazer
"Você não tem permissão para esta ação."Perfil sem KNOWLEDGE_ASSET_APPROVE ou GLOSSARY_EDITPedir a permissão ao administrador (perfis steward e admin já a possuem)
Aprovar desabilitado no painel de revisãoEdições não salvasClicar 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ênciaAguardar a entrega da integração; a listagem já permite triagem manual
Termo aprovado não muda o chat na horaJanela de propagação do glossário, de até 5 minutosEsperar a janela do cache
Indicadores paradosCache de 60 segundos somado à atualização automática de 60 segundosUsar o botão de atualização manual; se persistir, acionar o administrador
Fila vazia mas há documentos no domínioNenhuma geração foi disparada, ou tudo já foi revisadoDisparar a geração (veja o guia de preparação de conhecimento)