Knowledge Curation
Letting AI generate content and put it straight into use would be risky; reviewing everything in side spreadsheets is slow and leaves no trail. Knowledge Curation solves that dilemma: every AI-generated asset — optimized document, FAQ and glossary — is born as a draft and only goes into use after a person compares the content with the source excerpts, edits it if needed and approves it, with an audit trail for each decision. You get the speed of automatic generation without giving up human control.
Curation is not an accessory: it is the functional safety gate of the whole cycle. A glossary term only starts influencing chat search after it is approved, and the export of content to external systems only serves what has already been approved.
To understand how assets are generated, see the knowledge preparation guide.
How to reach the page (current state): Knowledge Curation still has no menu entry — open it at the direct address
/curadoria-conhecimento.html. The breadcrumb already shows Governança › Curadoria de Conhecimento, and the menu link is pending.
The four tabs
The page is organized in four tabs, each with a direct link — you can bookmark the one you use most:
| Tab | What it shows |
|---|---|
| Fila de revisão | Draft assets, paginated (20 per page, most recent first), filterable by domain and type, with multi-selection for batch actions |
| Glossário | Draft catalog terms, with inline editing of the definition and batch approve/reject |
| Decisões de fonte | Documents that vanished from the monitored source, awaiting a human decision |
| Indicadores | Operational panel for the base (curation funnel, backlog, generation quality, latest batches) |
Reviewing an asset (side by side)
Click an item in the queue to open the review panel:
- Left: the generated content (sections, question-and-answer pairs or terms).
- Right: the cited source excerpts — only the excerpts of the original document that ground each item. This is where you check, without leaving the screen, whether the AI really relied on the document. On narrow screens the two views become the "Gerado" and "Fonte" tabs.
Editing before approving
The pencil icon opens a text editor per item. Aplicar (prévia) only updates the screen; Salvar edição actually saves — the asset stays a draft, is marked as human-edited and keeps the same version. An amber banner warns when there are unsaved edits, and the Aprovar button stays disabled until you save: you never approve something different from what you are looking at.
Editing goes through the same source validation as generation, only stricter: every item must keep at least one citation of a real excerpt from the document — an invalid citation rejects the edit with a message explaining why.
Approving or rejecting
- Aprovar — asks for confirmation in an in-app dialog; on confirmation, the notice "Ativo aprovado. Já elegível para uso no retrieval." appears.
- Rejeitar — the dialog requires a reason (a mandatory field that "fica registrado na auditoria"); the asset becomes REJECTED and leaves the queue.
Diff between versions
When an item has a previously approved version (a re-generation after a change in the source document), the Ver mudanças link appears. The comparison is computed on the server, item by item — section, question or term, matched by key: ADICIONADO / REMOVIDO / ALTERADO / IGUAL pills, and short changed items get a line-by-line comparison (green and red). You review only what changed, instead of rereading everything.
Batch approval
Select items in the queue with the checkboxes — the batch bar appears with Aprovar / Rejeitar / Limpar. The confirmation dialog shows the exact count and warns: "Cada item gera um evento de auditoria individual.". Batch rejection also requires a reason, applied to all items.
- Up to 200 assets per batch operation (the glossary accepts up to 500 terms).
- One item failing does not bring down the batch: the result reports "N com sucesso, M falha(s)" with the reason for each item.
- Approved glossary terms start being resolved by chat within 5 minutes — that is the cache window that serves them.
Practical example — reviewing a batch of FAQs
- A generation batch finished for the regulations domain (you followed it in the Indicadores tab). Open Knowledge Curation.
- In the Fila de revisão tab, filter by type FAQ. Twelve drafts of "Portaria 1.234/2026" appear.
- Click the first one. On the left, the pair "Quem pode solicitar o benefício? / Servidores ativos com mais de 5 anos…"; on the right, the excerpt of the regulation that grounds the answer. It checks out.
- In one of the pairs the answer is correct but wordy: click the pencil, trim the text, Salvar edição and then Aprovar.
- Go back to the queue, select the remaining 10 pairs you already checked and use the batch bar: Aprovar → confirm. Each approval is audited individually.
- Within minutes the approved FAQ is eligible for chat search and for external export.
Glossary
The tab lists the catalog's draft terms, with the provenance (which document each term came from) for those born of automatic generation. You can:
- edit the definition inline;
- approve or reject in batch.
Users with catalog view only see the list in read-only mode; editing and batch actions require the GLOSSARY_EDIT permission.
Source decisions
Documents that vanished from the monitored source are not deactivated automatically — the decision is yours. The tab lists the documents flagged as out of source in the selected domain, for human triage.
Current state: the Desativar documento button is disabled ("Disponível em breve") — the action depends on the integration with the document validity cycle, not available yet. The listing already works and allows manual triage.
Indicators
The panel is aggregated on the server and refreshes itself every 60 seconds; recent approvals show up within 1 minute, because the 60-second cache is invalidated on every approval.
| Indicator | Meaning |
|---|---|
| Curation funnel | count by status: draft / approved / rejected / deprecated |
| Old backlog | drafts older than 7 days — a sign of a stalled queue |
| Approval without editing | % of approvals that needed no human editing (a thermometer of generation quality; target ≥ 70%) |
| By asset type | distribution across optimized document / FAQ / glossary |
| Latest generation batches | up to 5 recent runs with totals and failures |
Freshness per monitored source shows as "em desenvolvimento" — that data is not populated yet and arrives with the source-monitoring integration.
Permissions per action
The interface hides or disables what you cannot do, reading the permissions of your own access, but the rule holds on the server: direct calls without permission are denied with a message in Portuguese and are audited.
| Action | Required permission |
|---|---|
| Open the page, see queue / asset / source / diff / indicators | KNOWLEDGE_ASSET_VIEW |
| Approve or reject (individually and in batch), edit content | KNOWLEDGE_ASSET_APPROVE |
| Edit or approve glossary terms | GLOSSARY_EDIT (listing requires CATALOG_VIEW) |
| Deactivate a document out of source | KNOWLEDGE_ASSET_APPROVE (action still unavailable) |
Default profiles: administrators and stewards (ADVANCEDUSER) approve; analysts only view. Without `KNOWLEDGEASSET_APPROVE`, the page shows "Você está em modo de visualização.". These operations are also available through the API reference.
Behavior and accessibility
- Confirmations in in-app dialogs (never native browser windows); Escape closes them and focus is managed.
- Success and error notices in Portuguese, auto-dismissed after 5 seconds; network errors, permission errors and not-yet-available features have specific messages and a Tentar novamente button.
- Loading with skeletons; every tab has guidance when it is empty.
- Responsive layout: on mobile, the queue stacks and the side-by-side review turns into tabs.
- The page is instrumented with frontend telemetry, which follows each action and ties it to the corresponding call on the server.
Troubleshooting
| Symptom | Likely cause | What to do |
|---|---|---|
| "Você não tem permissão para esta ação." | Profile without KNOWLEDGE_ASSET_APPROVE or GLOSSARY_EDIT | Ask the administrator for the permission (steward and admin profiles already have it) |
| Aprovar disabled in the review panel | Unsaved edits | Click Salvar edição (or discard) before approving |
| "Funcionalidade ainda não disponível." | The Desativar documento action is not yet integrated with the validity cycle | Wait for the integration; the listing already allows manual triage |
| An approved term does not change chat right away | Glossary propagation window of up to 5 minutes | Wait for the cache window |
| Indicators appear frozen | The 60-second cache plus the 60-second auto-refresh | Use the manual refresh button; if it persists, contact the administrator |
| Empty queue although the domain has documents | No generation was triggered, or everything has already been reviewed | Trigger the generation (see the knowledge preparation guide) |