Use case / Release testing for agents

Compare the new version to the old one.

A prompt or model change can feel better and still do worse. Tag every run with its release and compare the old and the new on real traffic.

Releases
Tagged
Runs
Compared
Rollbacks
Informed

Release comparison

The old version next to the new one.

  1. Every run carries a release label, set once in the SDK.

  2. You choose how much traffic the new release gets.

  3. Both releases are compared on the same measures.

  4. The failing runs are one click away, not an average.

  5. A rollback is a decision made from traces, not a guess.

Release testing for agents1 / 5 steps
  1. 01

    Release tagged

    Release 2.15 changes the system prompt.

    ok
  2. 02

    Traffic splits

    Ten percent of runs use 2.15.

    ok
  3. 03

    Runs compared

    Cost, speed and failures for both releases.

    ok
  4. 04

    Failures rise

    2.15 fails more on refund questions.

    worse
  5. 05

    Release rolled back

    Traffic goes back to 2.14.

    ok

Instrument it

Label the release once.

Pass a release to the SDK and every run is tagged, so two versions can be compared on the same screen.

$ npm install tracify-sdk

import { span, traceAgent } from "tracify-sdk";

export const answer = traceAgent(async (question: string) => {
  return span("answer", () => callModel(question), { type: "llm", input: question });
}, { environment: "production", release: "2.15" });

The failure to catch

A new prompt that looked better in a demo and failed more in production.

Tag runs with a release and compare cost, speed and failures side by side, so a prompt or model change is judged on real traces.

What you get

What Tracify watches.

Release tags

01

Recorded on every run, so it can be searched, compared and alerted on.

Failure rate by release

02

Recorded on every run, so it can be searched, compared and alerted on.

Cost by release

03

Recorded on every run, so it can be searched, compared and alerted on.

Latency by release

04

Recorded on every run, so it can be searched, compared and alerted on.