All docs
EvaluationIntroduction to evaluationcode

Introduction to evaluation

What you can evaluate, which guide fits the shape of your application, and how measuring turns into deciding.

What you'll have

A clear route through this section: the guide that matches your application, and what to do with the scores once they arrive.

This section is about getting your application scored, and then about deciding things with the scores. What the first part takes depends on one thing: the shape of your application.

What you can evaluate

What it isGuide
Single turnOne request in, one answer out — a support reply, a summary, a classificationQuickstart
RAGRetrieval then generation, where answers must come from your sourcesScore a RAG answer
Multi-stepA pipeline — retriever, reranker, generatorScore every step
Multi-turnA conversation where context accumulatesScore a conversation
AgenticSeveral agents, tool calls, a final synthesisScore a multi-agent trace

Each is a complete setup you can follow on its own. They differ only in what you hand to observe(), because that decides which scores can be computed at all: retrieved chunks turn on grounding, a conversation id turns on cross-turn coherence, agent names turn on trajectory.

Choose your path

Measure first. Observe mode scores your live traffic without changing your prompts, your model or your control flow. It tells you where you stand and which answers are failing. Every guide above sets that up.

Then compare. Once you have a baseline worth beating, BYOR runs two versions against the same traffic at the same time, so a difference is attributable to your change rather than to the week. Scores move for all sorts of reasons — traffic shifts, the retriever changes, a provider ships a model update — and only a controlled comparison separates yours from those.

Most teams do both, in that order. Measuring first is what makes the comparison meaningful: you have to know what normal looks like before you can tell that something improved.

What else is in this section

Once traffic is arriving, the rest of it is about turning that into decisions.

Decide what to measure

Compare versions

What you get either way

  • 49 dimensions across six categories on every response, deterministic and reproducible
  • A scoring profile you control — weights, thresholds, and the dimensions you care about
  • Diagnosis, not just a number — which claim was unsupported, which step drifted, which tool was called that should not have been
  • A statistical verdict when you compare versions, rather than two averages and an eyeball