Track 07 · Data & governanceLesson 10 of 11
The audit pack
Logs, evidence and explanations you can hand over six months after go-live.
- Specialisation · Financial services
- 30 min read
- 60 min hands-on
- Pro
What you'll be able to do
01- Distinguish an audit log from an application log and a trace, and explain why observability telemetry is not audit evidence.
- Specify what to record for every agent decision: input references, versions, retrieved evidence, tool calls, controls, model output, human approval and final action.
- Implement a hash-chained, append-only audit log with signed checkpoints, and show that it detects edits, deletions and wholesale rewrites.
- Design retention and minimisation so the evidence survives for years without becoming a store of personal data nobody should hold.
- Reconstruct a decision from logged evidence, without re-running the model, into an explanation pack for an auditor, regulator or customer.
- Defend an evidence-based approach to explainability for LLM agents, and a sampling plan an auditor will accept.
Before you start
- Registries for models, prompts and agents: the release hash and approval chain each audit record points to.
- Finding and masking personal data: tokens and vaults keep personal data out of the log.
- Lineage: proving where an answer came from: where evidence came from, and as of when.
- Answers with receipts: grounding and citations: citations are the raw material of an explanation.
- Approval gates and bounded autonomy: the human decision you must record.
The short version
Six months after go-live, someone with authority will pick cases and ask: what did the system do, on what evidence, under which approved version, who decided, and can you prove the record has not changed since? Application logs and traces will not answer that: they are sampled, short-lived, mutable and written for engineers. An audit log is a separate, complete, structured, append-only record of decision events. Each record holds references and fingerprints rather than raw personal data, chains to the previous record by hash, and is periodically sealed by a signed checkpoint stored where the system's operators cannot write, ideally on WORM storage. From those records you reconstruct, never replay, each decision into an explanation pack: what the AI was allowed to do, what evidence it used, what it proposed, what the person decided and what was sent. For LLM agents the explanation is the evidence and the controls, not saliency maps and not the model's own narrative of its reasoning.
- Audit evidence is a product with a customer: the auditor. Design its schema, retention and access deliberately.
- Log references and fingerprints, not copies. Content stays in the system of record under its retention rules.
- Tamper evidence needs an anchor outside the log. A hash chain the operators can recompute proves nothing on its own.
- Reconstruct from evidence; do not replay the model. Models are non-deterministic and retire.
- Explain with evidence and controls. Chain-of-thought text is not a faithful account of why a model produced an output.
Pro lesson
The rest of this lesson is in Pro.
The mental model, worked example, field note, failure table, exercise and self-check, with the voice tutor.
- Every stage and specialisation, in full
- Every lab and every role project
- Halden weeks 2–10, on your record
- Every drill, live in the playground
- All solutions, plus the server judge
- Lab Assistant and every Teach with AI