Trust concept this page illustrates: approval authority is a human act, not an AI capability. Content Review is where people exercise that authority under Operational Trust — a document only becomes eligible for AI and search use once an identified person, acting in a business role, confirms the required metadata and business links. AI never grants itself document authority, and every approval is retained as an evidence/audit trail of who decided a document was ready. If you only need the concept, this paragraph is enough; the steps below are a worked example for the people who actually run the queue.
Platform operator guide for the Content Review module (/content-review) — who approves, what done looks like, and how validation blockers appear in the UI. No developer workstation or integration manifest steps on this page. For the business-meaning concept — why document approval gates Knowledge exposure — see Document approval and governance.
Prerequisites
- Tenant ACTIVE and document datasources syncing successfully
- Business roles and approver permissions assigned (
document-record:readand approval-capable roles per your governance pack) - Data stewards identified for each document corpus (legal, sales operations, knowledge management)
- Integrator has published document-storage configuration with required dimensions and links declared
Where it happens
- Dataplane UI — Content Review (
/content-review) — pending queue, review panel, save draft, approve - Email, Slack, or Microsoft Teams — alerts when new documents need review (when enabled for the tenant)
- Enterprise search — approvers pick foreign-key targets through governed record search (same ABAC as end users)
Integrators configure required fields and processing flags on the Configure Content Review guide after you confirm steward roles and policy.
Steps
- Confirm approver roster — map business roles (for example Contract Steward, Sales Operations) to users who may open the approval queue.
- Open Content Review from the main navigation — verify you see the queue or the all-caught-up empty state.
- Triage pending items — use search and status filters; prioritize documents blocking assistant or search certification.
- Open a document for review — read Original vs Recommended metadata; note required field labels and validation banners.
- Resolve blockers before Approve — complete required dimensions (sensitivity, lifecycle stage, department) and required links (customer, deal, project) via the governed pickers.
- Save draft when work is partial — stale concurrent edits surface as a conflict; refresh and retry rather than overwriting a colleague.
- Approve only when validation clears — the Approve action stays disabled while required metadata or links fail eligibility.
- Monitor failed sync separately — failed ingestion is not the same as Needs Review; escalate to integrator or source system owner.
- Record accountability — note who approved high-risk corpora for audit requests (platform retains approval events).
What done looks like
| Signal | Meaning |
|---|---|
| Queue empty or only expected backlog | Healthy steady state |
| Document status Validated then Synced | Governed metadata committed and corpus-ready |
| Approve disabled with clear banner | Validation working — steward must fix metadata |
| Approver cannot see unrelated corpora | ABAC and dimensions scoped correctly |
| Audit can answer who approved what | Compliance path intact |
Review panel behavior
Operators should expect this order in the review panel:
- Source record key (or datasource name when no key is available), and a real AI confidence score only when AI validation produced one
- Validation blockers when approval is not allowed
- Metadata card with Original and Recommended columns for governed fields
- Human-readable sync labels (for example Needs Review instead of internal codes)
Required fields are labeled in the UI. Read-only manifest fields cannot be edited in the panel — if a value is wrong, escalate to the integrator to fix mappings or source extraction.
Processing status explains why AI or text enrichment did not run: disabled flags, no extracted text, an unchanged trusted file, or a failed processing stage. A configured AI flag is not a confidence score. An unchanged trusted file may retain a previous real score; fresh processing does not reuse an unverified stale score. Complete trusted metadata may become eligible without a steward click for each file, but unresolved required links or security review still go through the human queue.
Foreign-key and search empty states
When linking a document to a record (deal, customer, project), distinct empty states help triage:
| Empty state | Operator action |
|---|---|
| No search results | Verify target record exists and spelling; check sync on record datasource |
| Permission denied | Request ABAC or role fix from admin |
| Target datasource inactive | Ask integrator to activate or repair integration |
| ABAC excluded | Confirm steward has scope for that business entity |
Validate
- Pilot approver completes one end-to-end approval on a test document
- Approve remains disabled until required link is set when manifest marks link as required
- Non-approver user cannot access queue or foreign-key targets outside scope
- After approval, governed search returns the document for entitled users only
- Integrator sign-off on manifest matches steward expectations (documented on configure track)
Limits
Notification delivery depends on tenant configuration — email, Slack, and Microsoft Teams each require the integrator to publish a communication Connected System and the platform admin to connect channels per Connect assistant channels. Not every environment enables all channels on day one.
Bulk metadata update tools, when available, follow the same validation rules as single-document save; operators should not bypass the queue with unsupported bulk paths without integrator guidance.
Common mistakes
| Mistake | Fix |
|---|---|
| Approving with missing sensitivity or lifecycle | Complete required dimensions first |
| Expecting Approve when deal link unresolved | Set required foreign key via governed search |
| Treating failed sync as approval backlog | Fix ingestion or source system |
| Sharing approver credentials | Use individual accounts for audit |
| Skipping steward training on Recommended vs Original | Train on validation banners and draft save |