AI data loss prevention for LangGraph
Users paste sensitive data into AI prompts – card numbers, phone numbers, home addresses, and whole résumés – often without realizing the risk. Once that data reaches your AI provider it can end up in logs, training pipelines, or model outputs, well outside your control.
Arcjet sensitive info detection scans prompt content inside your application, before it reaches the AI provider. Detection runs locally in your own environment, so the raw text never leaves your app: only the decision – whether sensitive data was found – is reported to Arcjet. When something is detected you choose what happens next: block the request, strip the data, or warn the user.
Get started
Section titled “Get started”This example scans a free-text tool argument for personal information before the tool executes. Detection runs locally. Don’t pass opaque IDs such as an order number to the detector.
We assume you already have a LangGraph project set up. For helper options and denial behavior, see the LangGraph agent guard.
Install the dependencies:
# Export your Arcjet API key from https://console.arcjet.comexport ARCJET_KEY="ajkey_..."
npm install @arcjet/guard @langchain/langgraph @langchain/coreCreate the example:
import { launchArcjet, localDetectSensitiveInfo } from "@arcjet/guard";import { guardTool } from "@arcjet/guard/langgraph/v1";import { tool } from "@langchain/core/tools";import { z } from "zod";
const arcjet = launchArcjet({ key: process.env.ARCJET_KEY! });const detectPii = localDetectSensitiveInfo();
export const saveNote = guardTool( arcjet, tool( async ({ orderId, note }) => ({ orderId, note }), { name: "save_note", description: "Save a free-text note on an order", schema: z.object({ orderId: z.string(), note: z.string() }), }, ), { action: "note.saved", rules: (input) => [detectPii(input.note)], },);Then start or invoke the agent with a test prompt.
Requests appear in your Arcjet dashboard in real time.
How detection works
Section titled “How detection works”Sensitive info detection runs through a detection backend – the engine that scans the text and identifies entities. There are two:
- Built-in engine (default). A WebAssembly engine bundled with the SDK. It detects four structured types – card numbers, email addresses, phone numbers, and IP addresses – runs anywhere the SDK runs (including edge runtimes), and needs no extra dependencies.
- Rampart backend (optional). An on-device named-entity-recognition (NER) model that adds the free-form PII people actually paste into prompts – names, street addresses, and government or financial identifiers. This is often the more valuable engine for AI data loss prevention, because that is exactly the data a structured-pattern matcher can’t catch.
Both engines run entirely on your own infrastructure. Nothing is sent to a third party for analysis, which is what makes this safe to put in front of an AI provider in the first place.
Configure detection
Section titled “Configure detection”Choose which PII to block
Section titled “Choose which PII to block”Use deny to list the entity types to block, or allow to block everything
except the types you list (the two are mutually exclusive). Tune the list to
your app – for a support bot that legitimately collects phone numbers, leave
PHONE_NUMBER out of deny:
The built-in engine detects CREDIT_CARD_NUMBER, PHONE_NUMBER, EMAIL, and
IP_ADDRESS. See the
entity detection table
for every type each backend supports, and for defining your own custom
detectors.
Detect names, addresses, and IDs
Section titled “Detect names, addresses, and IDs”Choose what text to scan
Section titled “Choose what text to scan”Pass the text to scan as sensitiveInfoValue (JS) / sensitive_info_value
(Python). For a chat endpoint this is usually the user’s most recent message.
Pass the full conversation history instead if you want to scan every message,
not just the latest one – useful when PII may have been introduced earlier in
the exchange.
Test before you block
Section titled “Test before you block”Set mode to "DRY_RUN" (JS) / Mode.DRY_RUN (Python) to log detections
without blocking any requests. Run this in production for a while to audit what
PII actually shows up in your prompts, then switch to "LIVE" once you’re
confident in the entity list.
Combine with other protections
Section titled “Combine with other protections”Sensitive info detection controls what data reaches your AI provider. Pair it with the other AI protection layers for full coverage:
- Prompt injection detection blocks hostile instructions and jailbreak attempts.
- AI abuse protection and AI budget control block automated clients and enforce per-user token budgets.
- Agent guards apply PII detection directly inside agent tool handlers and pipelines that don’t route through HTTP. A local policy input keeps the raw string in the SDK while reporting policy evidence to Arcjet.