ENGINEER / TRACE BEFORE GUESSING
Do not debug AI by feel.
Once AI is inside a system, bad output may come from retrieval, permissions, tool calls, latency, graders or infrastructure. Engineer helps you trace the request path and decide what to measure first.
Choose the layer to inspect ↓
01 / APPLICATIONinput · session · UI state
02 / GATEWAY & ACCESSauth · route · tool permission
03 / RETRIEVAL & TOOLScontext · lookup · external action
04 / MODEL & VALIDATIONgeneration · schema · grader
TRACE ILLUSTRATION
Not live telemetry.
Measure each layer before changing the model.
DIAGNOSTIC MAP
Start from the symptom. Measure the right layer first.
QUALITY / EVALS
Look here when: output quality drops after a model, prompt or tool change. The failure may be an unrepresentative task set or vague grader.
Measure first: representative task set, pass/fail criteria, failure taxonomy and version regression.
RETRIEVAL / RAG
Look here when: answers sound plausible but miss context or retrieve the wrong documents.
Measure first: query set, relevance judgment, missing-context failures and reranking impact. Separate retrieval quality from answer quality.
PERMISSIONS
Look here when: an agent can call tools, read protected data or take consequential actions.
Measure first: tool permissions, protected-data boundaries, human approval points and audit trail.
OWASP GenAI ↗ · NIST GenAI Profile ↗
LATENCY
Look here when: the app feels slow even though a model benchmark looks fast. Vendor throughput is not app latency.
Measure first: network, queue, TTFT, generation, tool execution and retries in an end-to-end trace.
INFRA / COST
Look here when: you own SLA, throughput, memory or cost for a production workload.
Measure first: workload shape, latency target, throughput, memory, batching and failure budget before choosing serving trade-offs.