Curadoria no Knowledge Catalog

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 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.

Onde fica

A curadoria mora dentro do Knowledge Catalog: menu Descobrir › Knowledge Catalog, aba lateral Curadoria. A aba só aparece para quem tem a permissão de ver ativos de conhecimento (KNOWLEDGE_ASSET_VIEW).

A trilha de navegação mostra Knowledge Catalog › Curadoria › nome da sub-aba, e cada sub-aba tem endereço próprio — dá para favoritar a que você mais usa: index.html?view=catalogo&tab=curadoria&sub=fila (troque fila por fontes ou indicadores).

Links antigos continuam funcionando. Até setembro de 2026 a curadoria era uma tela própria, no grupo Governança do menu. Endereços salvos daquela época (?view=curadoria-conhecimento, inclusive com a aba no final) abrem a aba Curadoria na sub-aba correspondente; o antigo link da aba Glossário abre a aba Glossário do catálogo já filtrada nos rascunhos. Workspaces que tinham a funcionalidade "Curadoria de Conhecimento" habilitada passaram a ter "Knowledge Catalog".

As três sub-abas

Os termos de glossário não são decididos aqui: eles têm um lugar só, a aba Glossário do próprio Knowledge Catalog (veja a seção Glossário, abaixo). O texto de abertura da aba Curadoria traz o link Glossário, que leva direto à lista de termos em rascunho.

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.

O ativo do tipo Glossário

O ativo gerado do tipo Glossário (o conjunto de termos extraídos de um documento) continua aparecendo na Fila de revisão, como os demais: aprová-lo é o que libera esse conjunto para a exportação. Já cada termo individual é decidido na aba Glossário do catálogo — é a aprovação do termo que faz o chat passar a resolvê-lo.

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.
• A falha de um item não derruba o lote: o resultado informa "N com sucesso, M falha(s)" com os motivos por item.

Exemplo prático — revisando um lote de FAQ

1. Um lote de geração terminou para o domínio de normas (você acompanhou pela sub-aba Indicadores). Abra Knowledge Catalog › Curadoria.
2. Na sub-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

Os termos de glossário — os criados à mão e os que a geração automática extraiu dos documentos — ficam num lugar só: a aba Glossário do Knowledge Catalog. Os termos gerados chegam lá como Rascunho.

Encontrar os termos a decidir

A lista mostra termos de todos os status, e o filtro de status tem Rascunho, Aprovado, Rejeitado e Descontinuado. O link Glossário da aba Curadoria abre a lista já filtrada nos rascunhos — o mesmo que o endereço index.html?view=catalogo&tab=glossary&status=DRAFT.

No detalhe de um termo que veio da geração automática aparece a linha "Extraído pela IA do documento", seguida do código do documento de onde ele nasceu.

Aprovar, rejeitar e descontinuar

• Um termo: no detalhe, um termo em rascunho tem os botões Aprovar e Rejeitar; um termo aprovado tem Descontinuar.
• Em lote: marque as caixas de seleção dos termos — ou use "Selecionar os N termo(s) da lista" para marcar todos os que o filtro mostra — e a barra de lote aparece com Aprovar / Rejeitar / Descontinuar / Limpar.

Regras das decisões:

• Até 500 termos por lote.
• Rejeitar exige motivo, que fica registrado no histórico do termo e na auditoria.
• A transição é validada termo a termo: rascunho vira aprovado, rejeitado ou descontinuado; aprovado só vira descontinuado. Cada termo guarda o registro da decisão (status anterior e novo, quem decidiu, quando e o motivo), e o lote é registrado na auditoria.
• A falha de um termo não derruba o lote: o resultado informa "N com sucesso, M falha(s)" com os motivos.
• Termos aprovados passam a ser resolvidos pelo chat em até 5 minutos — é a janela do cache que os serve. Termos descontinuados deixam de ser resolvidos.

Editar um termo

O formulário de edição altera nome, definição, domínio e responsável. Ele não tem seletor de status: o status aparece só para leitura, com a nota "Muda pelos botões Aprovar, Rejeitar e Descontinuar." Editar a definição de um termo aprovado o mantém aprovado.

Quem tem apenas visualização de catálogo vê a lista em modo somente-leitura; editar, aprovar, rejeitar e descontinuar 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 sub-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.

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.

Perfis padrão: administradores e stewards (ADVANCEDUSER) aprovam; analistas apenas visualizam. Sem `KNOWLEDGEASSET_APPROVE`, a aba Curadoria 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 sub-aba tem orientação quando está vazia.
• Layout responsivo: no celular, a fila empilha e a revisão lado a lado vira abas.
• A aba é instrumentada com telemetria de frontend, que acompanha cada ação e a liga à chamada correspondente no servidor.

Solução de problemas