Skip to Content
SDK ReferenceContent Capture
💡
Quick overview

Content Capture

Content Capture is an enrichment module that stores a copy of the full prompt and response payload inside VeriProof, allowing reviewers and auditors to inspect the raw content of AI decisions.

Enabling content capture: Enable the content-capture enrichment in your SDK configuration and choose whether to store prompts, responses, or both.

Access control: Stored content is encrypted at rest. Access to raw content in the portal (Journey View → Payload tab) is controlled by the content:read permission, assigned via RBAC. By default, only Admin and ReviewAccess roles can view content.

Retention: Content is stored for the same retention window as decisions (default 90 days; configurable on enterprise plans). After expiry, the payload is deleted but the decision record is retained per policy.

Storage volume: Enabling content capture increases storage consumption. Monitor your storage usage under Settings → Billing.

Content Capture

Content capture controls whether VeriProof stores the raw text of prompts, model responses, and tool call inputs and outputs alongside a session trace. Captured content enables:

  • Time Machine — replaying exact prompts and responses in the Story panel
  • Review Queues — showing reviewers the full conversation that produced a decision
  • Evaluation Datasets — importing real production sessions as test cases with ground-truth content
  • Prompt Playground — running what-if experiments against the original session transcript

Without content capture, VeriProof records the structural trace (steps, latency, decision metadata, governance annotations) but the text fields are absent or summarised.


Capture Setting

SettingWhat is storedUse when
enable_content_capture: False (default)No text is capturedPII-sensitive applications, highest storage efficiency
enable_content_capture: TrueComplete input and output text from step dataDevelopment, testing, compliance-heavy applications

Enabling content capture stores verbatim user input and model output in VeriProof’s data store. Review your data processing agreement and confirm input content does not include regulated PII before enabling in a production environment.


Setting the Capture Mode

Content capture is configured per SDK client instance, not per session. This lets you apply different policies in different deployments or services.

import os from veriproof_sdk import VeriproofClient, VeriproofClientOptions # Disabled (default) client = VeriproofClient( VeriproofClientOptions( api_key=os.environ["VERIPROOF_API_KEY"], application_id="my-app", ) ) # Enabled client = VeriproofClient( VeriproofClientOptions( api_key=os.environ["VERIPROOF_API_KEY"], application_id="my-app", enable_content_capture=True, ) )

Attribute Redaction

For clients with content capture enabled, you can block specific OTel attribute keys from being stored. VeriProof replaces the value of any listed attribute with [REDACTED] before transmission.

client = VeriproofClient( VeriproofClientOptions( api_key=os.environ["VERIPROOF_API_KEY"], application_id="my-app", enable_content_capture=True, redacted_attributes=("gen_ai.input_messages", "gen_ai.output_messages"), ) )

Redacted attributes are excluded before transmission. The attribute key remains visible in the trace structure, but the value is replaced with [REDACTED].


Impact on Time Machine Richness

The capture mode you choose directly affects what reviewers see in the Time Machine:

Paneloffenabled
Story panelStep types and timestamps onlyFull verbatim transcript
DVR controlsAvailableAvailable
Decision SnapshotFull governance metadataFull governance metadata
Blockchain VerificationFullFull
Governance ContextFullFull

If your compliance program requires human review of flagged decisions, enable content capture in your application to make the full conversation transcript visible to reviewers in Time Machine.


Storage Implications

Full capture can significantly increase storage volume. As a rough guide:

Capture modeStorage per 1 M sessionsNotes
off (default)~80 MBStructural trace only
enabled400 MB – 4 GBDepends on average content length

Contact your account team if you need content capture storage isolated to a region-specific data store to meet data residency requirements.


Last updated on