Skip to content

Using AI Case Checks

New in Atfinity 17.

An AI Case Check evaluates a case against a plain-language description of a potential problem and reports whether the problem is present, how severe it is and how confident the assessment is. Use one wherever a pattern is easy for a compliance officer to recognise but hard to write as a rule condition.

How a check is built

A check has:

  • Condition: a RuLa condition, like a rule's, that decides which instances it runs against.
  • Problem description: a Jinja template describing the potential problem. It is rendered against the matched instance before being sent to the AI, so {{ p.first_name }} becomes a real value such as Thorben.
  • Max severity level: the highest of the five severity levels (Very Low, Low, Medium, High, Very High) the check is allowed to report. A result assessed as more severe than this is capped at it.

A check only runs for a process once it is added on that process's Components page, on the 'AI Case Checks' tab.

The minimum confidence threshold

Every result carries a confidence, shown to the user as a percentage from 50% to 95%. The 'AI Features' tab of the configuration settings has a minimum confidence, on a scale of 1 to 10: results below it are not shown to the user at all.

In the case wizard

A check is only shown in a case if its result is a problem and its confidence is at or above the threshold. Each result shows the instances it applies to. A user can raise the minimum severity or confidence shown, and can ignore a result. An ignored result stays hidden until the case data behind it changes, which reruns the check.

Badges next to the 'AI Case Check' tab in the case menu count the current results, grouped into low (Very Low and Low), medium and high (High and Very High) severity.

When it is off or unavailable

Turning AI Case Check off in the configuration settings stops it from running and hides existing results, but checks can still be created and edited; the 'AI Case Checks' tab shows a banner saying the feature is off. If the tenant does not have Atfinity Intelligence at all, that tab and the 'AI Features' settings tab show an empty state asking the user to contact Atfinity instead.

Example

A check with condition p is Person, max severity Very High and this problem description:

A person works as {{ p.occupation }} at {{ p.employer }} with is_pep set to {{ p.is_pep }}.
If this occupation or employer suggests political exposure but it's not set, this needs to be checked.

flags a person whose occupation is state governor and whose is_pep is false: the occupation suggests political exposure that the data does not reflect.