Documentation Index
Fetch the complete documentation index at: https://docs.frankieone.com/llms.txt
Use this file to discover all available pages before exploring further.
Video Guide
Risk Assessment
FrankieOne calculates risk to help you assess customers and make informed decisions during onboarding, monitoring, and ongoing due diligence.Entity risk vs. Workflow risk
When viewing an entity in the Portal, you will see two related risk levels.| Level | What it measures | When it updates |
|---|---|---|
| Entity risk | The entity’s risk state, either based on the latest workflow run or as a cumulative risk across its lifetime (depending on configuration/model). | After each workflow run or a manual override. |
| Workflow risk | The risk score for a single workflow execution. | At the end of that workflow run. |
How is entity risk calculated
- Each check in a workflow returns one or more risk factors (for example, sanctions matches, device risk, jurisdiction).
- Each risk factor is assigned a score based on your configuration.
- FrankieOne aggregates these scores (sum or average, depending on your model) to produce a workflow risk score at the end of the workflow run.
- The score is mapped to a Risk Level (Low, Medium, High, Unacceptable).
How workflow risk and entity risk relate
- Workflow risk represents the risk for a single workflow execution (for example, an onboarding attempt).
- Entity risk represents the customer’s overall risk profile.
- Entity risk is derived from workflow risk, either:
- based on the latest workflow result, or
- as a cumulative view over time, depending on your configuration.
- A high workflow risk can increase the entity’s overall risk level (for example, from Medium to High).
Entity risk vs Workflow risk
| Aspect | Workflow Risk | Entity Risk |
|---|---|---|
| Scope | Single workflow execution (point-in-time assessment) | Overall customer risk profile |
| Purpose | Identifies risk in a specific onboarding or assessment attempt | Reflects ongoing risk across the customer lifecycle |
| Calculation basis | Risk factors from a single workflow run | Derived from one or more workflow results (latest or cumulative model) |
| Update timing | At the end of each workflow run | After each workflow run or manual override (depending on configuration) |
| Typical use case | Detecting immediate issues during onboarding or screening | Maintaining long-term risk posture for the entity |
Risk accumulation over timeEntity risk is updated as new workflows are executed for the same entity. New workflows can change the risk score based on new or updated signals, so the entity risk may increase, decrease, or remain unchanged.Example: A customer is onboarded and assessed as Low risk. Later, during ongoing monitoring, new AML alerts are triggered and the workflow returns High risk. The entity’s risk level is then updated to High.
Risk score and Risk levels
| Risk level | Score range (example) | Typical action |
|---|---|---|
| Low | 1–30 | Auto-approve. |
| Medium | 31–50 | Require extra checks. |
| High | 51–75 | Manual review and EDD. |
| Unacceptable | >75 | Auto-fail. |
Risk factors
Risk factors are defined in your Risk Scorecard and appear in the Risk drawer with their individual scores.| Factor | What it measures | Example values |
|---|---|---|
num_sanctions | Count of sanctions matches. | 0, 1+ |
num_pep | Count of PEP matches. | 0, 1+ |
device_risk | Fraud score from device intelligence. | Low, High |
jurisdiction | Country risk tier. | Tier 1–4 |
document_age | Document expiry status. | Valid, Expired |
behaviour | Biometrics or usage anomalies. | Normal, Suspicious |
Overriding risk score
Authorised users can manually set a new Risk score in the Risk drawer (for example, lowering risk after enhanced due diligence).A manual override remains until any underlying risk factor changes in a future workflow run. When that happens, the system recalculates risk and clears the old override.
Where to find risk information
- Profile header – shows the current Entity risk badge
- Workflow events tab – each event row displays its Workflow risk level
- Risk score – click to open a drawer with risk factor details