Skip to content

kindgi eval-suites

Eval suites and test sets built from judgments (list / show / from-judgments / cases).

List eval suites (the latest version of each).

Terminal window
kindgi eval-suites list [--project=<id>] [--kind=accuracy|pairwise|regression|human-review|benchmark|custom|judged] [--include-retired] [--limit=<n>] [--cursor=<c>]

Flags:

  • --cursor <value>: Resume after this cursor, from the previous page's nextCursor.
  • --include-retired: Include retired suites (every version unregistered), each as its highest version with unregisteredAt.
  • --kind <value>: Only this kind: accuracy, pairwise, regression, human-review, benchmark, custom, judged.
  • --limit <value>: The most to return (default 25, at most 100).
  • --project <value>: Only suites in this project.

Show an eval suite: its latest version, or the one named by --suite-version.

Terminal window
kindgi eval-suites show <suite-id> [--suite-version=<semver>]

Flags:

  • --suite-version <value>: The version to show. Default: the latest.

Build a test set: publish a judged suite version whose cases are copies of an agent's or flow's judged runs, with each item's judgments summed up.

Terminal window
kindgi eval-suites from-judgments <suite-id> --suite-version=<semver> --project=<id> (--agent=<id> [--agent-version=<v>] | --flow=<id>) [--since=<iso>] [--until=<iso>] [--class=<judge-class-id> ...] [--min-judgments=<n>] [--segment=<key:value> ...] [--description=<text>]

Flags:

  • --agent <value>: Use judged runs of this agent.
  • --agent-version <value>: Only runs of this agent version. Needs --agent.
  • --class <value>: Count only judgments under this judge class id. Repeat the flag for several classes. (repeatable)
  • --description <value>: A description for the suite version.
  • --flow <value>: Use judged runs of this flow.
  • --min-judgments <value>: Leave out runs with fewer counted judgments (default 1).
  • --project <value>: The project whose judged runs to use. Required.
  • --segment <value>: Only runs started in this segment or below it, as key:value; repeat it for a path, coarse to fine (--segment=company:acme --segment=role:cfo). (repeatable)
  • --since <value>: Only runs first judged at or after this time: an ISO 8601 time with a zone, or a date (its start, UTC).
  • --suite-version <value>: The version to publish. Required.
  • --until <value>: Only runs first judged before this time: an ISO 8601 time with a zone, or a date (its start, UTC).

List the cases of a judged suite version.

Terminal window
kindgi eval-suites cases <suite-id> --suite-version=<semver> [--limit=<n>] [--cursor=<c>]

Flags:

  • --cursor <value>: Resume after this cursor, from the previous page's nextCursor.
  • --limit <value>: The most to return (default 25, at most 100).
  • --suite-version <value>: The suite version. Required.

Every command also takes the global flags.