Standard Entity Rules

Pre-trained detectors for the categories regulations care about

Standard Entity Rules are pre-trained detectors for sensitive data categories: personal information, payment data, government IDs, network identifiers. Each entity has a detector and an action that fires when the detector matches a tool call’s arguments. This page is the per-entity reference. For where the scan sits in the request path, start with the Security Gateway overview.

Configuration lives at Security → PII detection, where the entities are grouped by region into one expandable section each: Global sensitive data types for the detectors that apply everywhere, US sensitive data types for the US-specific ones. You only get a section for a region your catalog covers, so there is nothing to reason about for a region you do not operate in.

How detection works

Detection runs on a Presidio-based stack. For each entity type, Workforce scans the tool arguments against:

  • Pattern recognizers, regex for things with structure: credit card numbers, SSNs, IBANs
  • Named-entity recognizers, NLP for things with no clean pattern: person names, locations
  • Context analyzers, words near the candidate that raise confidence, such as “SSN” beside a nine-digit number. These show up as NLP in the Detection method column.

The detection method for each entity is shown on its row, which is the fastest way to predict how it will behave: pattern entities are precise, NLP entities are fuzzy and will occasionally fire on ordinary prose.

What you set per entity

ColumnWhat it does
Entity typeThe detector, such as US_SSN
DescriptionWhat it matches
Detection methodHow the entity is found, such as Pattern match, Pattern match and NLP, or Pattern match, NLP and checksum
Pre-run actionLog, Redact, or Block when the entity appears in tool arguments
EnabledMaster switch for this entity in this region

Entity rules act on the way out, on the arguments a client sends. To screen what a third party sends back, use an AI Guardrail that screens responses.

The three actions

  • Log. The match is recorded as a violation and nothing is altered or stopped. Use it for visibility without enforcement.
  • Redact. The match is replaced with a placeholder, [REDACTED:EMAIL] for example, and the call proceeds.
  • Block. The call is canceled and the client receives an error saying a security rule fired.

Log is how you size a rule before enforcing it. Redact is the right default for most categories. Block is for the categories you do not want crossing the boundary at all.

Entity catalog

Workforce ships detectors for the categories below. Some are region-specific, and the region they sit under controls whether they fire.

Personal identity

EntityWhat it detects
PERSONPerson names. NLP-based, so less precise than pattern entities and more prone to firing on common words.
EMAIL_ADDRESSEmail addresses. High-precision regex; rarely false-positives.
PHONE_NUMBERPhone numbers, international and domestic
LOCATIONCities, countries, addresses. NLP-based; can match common product names.
NRPNationality, religious affiliation, political group. NLP-based; useful for HR contexts.
DATE_TIMEDates and times. Usually left off, because most tool calls legitimately contain dates.

Government and financial IDs

EntityWhat it detectsRegion
US_SSNUS Social Security NumbersUS
US_ITINUS Individual Taxpayer Identification NumbersUS
US_PASSPORTUS passport numbersUS
US_DRIVER_LICENSEUS driver’s license numbersUS
US_BANK_NUMBERUS bank account and routing numbersUS
IBAN_CODEInternational Bank Account NumbersGlobal

Payment

EntityWhat it detects
CREDIT_CARDCredit card numbers across major networks (Visa, Mastercard, Amex, Discover, Diners, JCB), validated with the Luhn algorithm
CRYPTOCryptocurrency wallet addresses (BTC, ETH, and others)

Health

EntityWhat it detects
MEDICAL_LICENSEUS medical license and DEA numbers

Network

EntityWhat it detects
IP_ADDRESSIPv4 and IPv6 addresses
URLURLs. Frequently fires on internal slugs that look like URLs, so most organizations leave it on Log or off.

Per-Tool-Pack overrides

Default rules apply organization-wide, and a Tool Pack’s overrides are authoritative for that pack. An override can change a rule’s action, add an entity the organization has no rule for, or switch one off for that pack alone. Common patterns: block credit cards organization-wide and log them on a finance pack, redact emails organization-wide and allow them through on a CRM pack, block government IDs everywhere except the payroll pack.

Configure overrides on the Tool Pack’s Rules tab. Each override picks an entity and an action.

Before you enforce

Two moves save most of the tuning. Set a new rule to Log and read a week of real traffic in Violations and alerts before you switch it to Redact or Block: the fuzzy entities in particular fire in places nobody predicts. And run a realistic sample through the Guardrail tester first, which shows you every entity the sample trips and the action each one would take.

For anything the standard catalog does not cover, internal customer IDs, project codes, employee numbers, use Custom Regex Rules.

Next

Detect the identifiers only your business uses with Custom Regex Rules.