Sensitive data
A faithful record of what an agent did will sooner or later contain things you do not want every reviewer to read: email addresses, account numbers, medical details, credentials. Dropping those values from the record weakens the audit trail; keeping them in plain view turns the audit trail itself into an exposure. Prefactor resolves this by letting your integration mark the sensitive values in a span’s payload, and then handling those values differently from the rest of the record: stored separately, redacted by default, revealed on demand, and removable for good.
Prefactor does not detect sensitive data for you. The team building the agent knows which fields carry a customer’s email and which carry a search query, so marking is done in your integration, at the point where the payload is built.
Marking values
Section titled “Marking values”Marking uses the sensitive encoding: your integration wraps each sensitive value in a marker that names the categories of data it contains, such as personal identifiers, contact information, or credentials. The labels travel with the value wherever it appears, so a reviewer always knows what kind of data was redacted even when they cannot see the value itself.
What Prefactor does with marked values
Section titled “What Prefactor does with marked values”Marked values never sit in the main span record. On write, Prefactor splits them out: the span’s payload keeps a redacted marker (the type and labels, no value), and the values move to a separate secure store attached to the span. The split is a storage arrangement, not something you manage.
In the web app, sensitive values are redacted by default. Span summaries and conversation views render with the values hidden, and the span detail panel shows each marked value as a labelled placeholder. A Show sensitive information toggle in the panel reveals the values for that viewing; it is off again the next time you look.
Instance payloads
Section titled “Instance payloads”The same handling applies to the input, result, and metadata recorded on an instance. Marked values in those payloads are stored apart from the rest, redacted by default, and removable. There are two differences from spans: marking is always on for instance payloads, with no flag to enable it, and discarding works on the whole instance at once rather than span by span. The instance page’s Show sensitive information for this instance toggle reveals the values for your current viewing only.
Judges read the real values, not the redacted ones. A judge’s own run records what it was sent as ordinary, unmarked content, so sensitive values you pass to a judge are not redacted on the judge’s run.
Discarding values
Section titled “Discarding values”Some values should not be retrievable at all once a run has been reviewed, or should never have been captured in the first place. The Discard sensitive action on a span permanently deletes its stored sensitive values. The span keeps its redacted markers, so the record still shows that sensitive data of those categories was present; only the values are gone, and there is no way to recover them. Discard is also available through the API, span by span, and for an instance’s input, result, and metadata together.
Sensitive markers and risk
Section titled “Sensitive markers and risk”Markers and risk scoring share a vocabulary but do different jobs. Risk is scored from the activity schema’s declarations (which data categories each span type can touch), because risk is about what the agent is capable of handling, assessed before and across runs. Markers annotate the actual values in an actual run, so they drive redaction and discard, not the risk score. An agent whose schema declares personal_identifiers scores for it whether or not a given run marked any values; a marked value in a run does not add to the score.
Further reading
Section titled “Further reading”- Span — the record that carries payloads, results, and sensitive markers.
- Sensitive encoding — the marker format and flag your integration uses to mark values.
- Risk — what data sensitivity means for scoring and classification.
- Agent › Instance › Activity tab — where redacted values, the reveal toggle, and the discard action appear.
- Agent › Instance › Details tab — where an instance’s redacted input, result, and metadata appear.