Introduction
PII detection is where most governance programmes start, because it is the risk everyone already has a policy about and the one an agent is most likely to encounter by accident.
It is also the check most likely to produce useful incidents in week one, which makes it a good first control.
What it detects
Personal data such as email addresses, phone numbers and national identifiers.
Choose which detectors to run, each with a likelihood (High, Medium or Low; default High): Email address, Phone number, US Social Security number, Credit card number, Bank account number, Date of birth, IP address, Passport number. Names are not detected.
Where to run it
Applied on | Catches |
| Users volunteering personal data to an agent that should not receive it |
| The agent emitting personal data — including someone else's |
| Personal data leaving for a third-party system or a training pipeline |
| Personal data arriving from a data source the agent queried |
The two that matter most are the ones teams reach for last. Tool input is where personal data leaves your boundary; Agent output is where it reaches someone who should not see it. A control on user input alone governs the least consequential direction.
Actions
PII detection reports where the match occurred, so all three actions are available.
Action | Use when |
| Always first. You need the false-positive rate before acting. |
| The response continues, with the personal data replaced by a token. Usually the best fit — the agent stays useful. |
| The interaction fails. Reserve for paths where personal data must never appear at all. |
Mask is the underused one. Blocking a support conversation because the customer typed their own phone number is a worse outcome than masking it and carrying on.
Tuning
Consider the direction, not just the presence — A customer giving their own email to a support agent is usually fine. The same email leaving in a tool call to an external system may not be. Separate controls per apply point let you treat those differently.
Do not run one control across all four points — You lose the ability to set different actions where the risk differs.
Known limitations
Detection, not classification of sensitivity — It finds personal data; it does not know whose, or whether this context is authorised.
Actions beyond Flag need an enforced connection — On
Observe · Advisory, aMaskcontrol records the match and does not mask.Incident titles contain the match — An incident list for a PII control is, by construction, a list of personal data. Scope access accordingly.