Skip to main content
Role-aware adverse media helps Minerva distinguish adverse-media articles that appear to involve the screened subject from articles that only mention the same or a similar name. Access: Requires the Admin role or above. In the sidebar, go to Administration > Configuration > Adverse Media, then open Role-Aware Adverse Media. Role-aware adverse media is workspace-scoped. Use a Calibration workspace to review labels and thresholds before applying stricter behavior in Live. Use this guide to understand what role-aware adverse media controls, choose between Hint Mode and Decision Mode, and tune confidence thresholds by workflow. It also covers the visible article labels and API metadata, and how to review, audit, or roll back role-aware changes.
Decision Mode can change which adverse-media potential matches analysts see. Start in Hint Mode when calibrating, review examples, and save clear change descriptions before moving to automatic filtering.

​
How role-aware adverse media works

Role-aware adverse media runs after Minerva has retrieved and analyzed news or open-source articles. It is one of three signals Minerva reads from a search:
  • Adverse media categories define the risk topics an article may carry. For how articles are found and scored, see Adverse Media.
  • Risk inference reads PEP, Criminal, and High Risk Industry context from the resolved profile text.
  • Role-aware adverse media, the subject of this page, checks each flagged article for subject relevance.
At a high level, Minerva:
  1. Retrieves articles from the selected adverse-media sources
  2. Identifies negative or risky articles through adverse-media analysis
  3. Checks whether each qualifying article appears related to the screened subject
  4. Either shows the result as an article label or uses it to filter out unrelated adverse-media articles, depending on the workflow configuration
Role-aware adverse media does not broaden article retrieval on its own.
Role-aware adverse media complements match scoring. Match scoring controls candidate thresholds; role-aware adverse media controls confident article-subject relevance signals after article analysis.

​
Configure role-aware adverse media

The Role-Aware Adverse Media page is organized by workflow, so each screening path can use its own labels, mode, and threshold. Minerva currently separates:

​
Controls

​
Enable role-aware insights

Turn on Enable role-aware insights when you want Minerva to run role-aware checks for a workflow. When this setting is off, role-aware thresholds do not affect that workflow.

​
Automatic role-based filtering

After role-aware insights are enabled, choose how Minerva should use the output:

​
Role-aware confidence threshold

The Role-aware confidence threshold controls when labels and Decision Mode removals apply.
  • Range: 0.00 to 1.00
  • Default: 0.50
  • Higher values are stricter and require stronger model confidence
  • Lower values are broader and can show or filter more articles

​
Analyst-facing labels

When role-aware output is visible, Minerva can show these adverse-media article labels: These labels are review aids. They do not replace analyst review of the article, source context, and full screening result.

​
API and export output

When role-aware metadata is present, returned adverse-media articles can include a role_aware_prediction object.
The label is suspect or non-suspect. The related_to_subject field is the boolean form of that label, and score is the confidence score for the selected label. Role-aware metadata is optional. It appears only when the workflow is configured to run role-aware checks, the article qualifies for analysis, and the model confidence meets the configured threshold.

​
Relationship to match scoring

News and adverse-media tuning has three related layers: For threshold and News retrieval details, see the Match Scoring Guide. Use this sequence when calibrating role-aware adverse media:
  1. Start in Hint Mode for the workflow you want to evaluate.
  2. Review common-name and article-mention false positives.
  3. Compare role-aware labels against the underlying articles and analyst decisions.
  4. Raise the threshold if labels feel too uncertain.
  5. Lower the threshold only after reviewing representative examples.
  6. Move to Decision Mode when confident non-subject articles should stop contributing to adverse-media potential matches.
  7. Tune one workflow at a time and save a clear change description.

​
Reviewing and confirming changes

When you click Review changes, Minerva shows a grouped confirmation view before anything is saved. The review dialog shows:
  • The number of changes and sections affected
  • Each workflow with changed role-aware insight settings
  • Each changed Hint Mode or Decision Mode setting
  • Each changed confidence threshold
  • An optional Change Description field
Use the change description to capture the reason for the calibration, such as a false-positive review, a Calibration-to-Live rollout, or a post-launch monitoring adjustment.

​
Deployment history and rollback

The Role-Aware Adverse Media page includes history and rollback tools so you can audit prior deployments and restore an older configuration when needed. The full history page includes:
  • Changed: when the configuration was saved or rolled back
  • Action: whether the event was an update or rollback
  • Summary: the key role-aware changes
  • Changed by: the user who performed the change
  • Actions: rollback entry points for older deployments
Rollback restores a previous deployment by writing a new history entry. It does not delete prior history.