Guardrails in code
Instrument the pre/post guardrail pipeline
Page 6 adds signals that distinguish bad input from component failure in the pre/post output guardrail pipeline.
1Learn the idea
Read
Emit stage signals
Instrument the pre/post output guardrail pipeline so a run records enough structure to debug offline: counts, latency if relevant, pass/fail of block rate, false-block samples, escape rate on red-team set, and a stable stage name. Redact secrets and raw credentials from every event.
Read
Emit and assert
import json
print(json.dumps({'stage':'guardrails','blocked':2,'false_block_samples':0,'model_calls_skipped':2}))
Expected evidence: guardrail telemetry. Prefer JSON or structured text you can grep in CI over prose logs for guardrails-in-code.
Read
Lock signals with a regression test
Turn one historical failure—especially post-guard only that still bills the model for blocked intents—into a test that fails if the signal disappears for the pre/post guardrail pipeline. Observability without a failing test is optional decoration; observability with a test is part of the guardrails-in-code artifact.
Read
Lab notebook: signal schema
Draft a three-field event for the pre/post guardrail pipeline: stage, ok, and one domain field derived from block rate, false-block samples, escape rate on red-team set. Add fixture_id or docs_version when content can change. Explicitly list fields that must never appear (tokens, passwords, raw prompts) because logging blocked prompts that contain secrets into an unredacted sink is in scope for this lab.
Wire one assertion that fails if the pre/post guardrail pipeline event is missing after a run. Observability that cannot fail a test will not survive contact with a busy guardrails-in-code repository.
Read
Worked judgment
Imagine a teammate opens only your event stream after a bad deploy. Could they tell whether policy with PII and self-harm categories + sample prompts was wrong, whether post-guard only that still bills the model for blocked intents, or regex gaps on obfuscation returned, or whether logging blocked prompts that contain secrets into an unredacted sink slipped through? If not, rename fields until those three stories are distinguishable.
Read
Why this stage matters for the pre/post guardrail pipeline
At the testing and observability stage for guardrails-in-code, the job is narrower than finishing a product demo. You are creating one progressive evidence piece about policy with PII and self-harm categories + sample prompts that later pages inherit without redefining success. Keep that fixture small enough to inspect by hand, keep outputs copy-pasteable as text, and refuse to narrate this baseline as if it were a production SLA: model call with no guards on the same fixtures.
For this page specifically, success looks like a structured event schema locked by a test while still centering the user decision to block unsafe prompts and strip or refuse unsafe completions before they reach users. If you cannot point to a file, command, or assertion that proves that for the pre/post guardrail pipeline, stay on this page instead of advancing.
Go deeper
Before you start
Why this matters
Write the single log line or metric event that would tell you whether a bad result came from input vs implementation for the pre/post guardrail pipeline. If your line could not tell them apart, redesign it before coding.
In the wild
See how this idea shows up as a product and a company — then come back to the lesson. Skills transfer across vendors.
Related lessons
Check your understanding
Page assessment
Answer from memory. Completion is saved from this evidence, not from opening the next page.
All responses are required.