Evaluation loop

Define a challenge, run an Episode, judge the result, record a reward, and update a skill.

Versalist uses the term training for instruction and skill changes. It does not mean model weight updates.

Evaluation sequence

  1. Define the challenge. Record inputs, constraints, tools, required artifacts, and acceptance criteria.
  2. Run an Episode. Execute the agent and record model calls, tool calls, logs, and outputs.
  3. Judge the result. Apply tests, rubric criteria, baseline comparisons, or reviewer decisions.
  4. Record the reward. Store the score, result status, failure mode, and supporting evidence.
  5. Update the skill. Change an instruction only when the evidence supports the change.

Artifacts

Challenge

A challenge defines a repeatable task environment. Its fixed boundary makes different runs comparable.

Episode

An Episode records one agent attempt. The record can include trace events, logs, intermediate files, and final artifacts.

Evaluation

An evaluation applies a defined method to an Episode result. Use deterministic tests when the task permits them.

Reward

A reward converts the evaluation into a structured result. It can contain a score, pass state, failure category, and evidence links.

Skill version

A skill version contains reusable agent instructions. Its provenance must identify the evidence that caused the change.

Compare runs

  1. Keep the challenge definition unchanged.
  2. Keep the evaluator unchanged.
  3. Change one agent variable.
  4. Run the candidate.
  5. Compare scores, failures, traces, and artifacts.
  6. Accept or reject the change.

A score change without trace evidence can hide a regression. Review both the result and the execution behavior.

Provider roles

Provider keys

Provider keys let Versalist send supported model calls through a user-managed account. Manage these keys in Integrations.

Custom model endpoints

This capability is planned. The current product does not expose a general endpoint adapter.

Compute adapters

This capability is planned. A catalog entry does not mean that a runtime adapter exists.

  • Challenges explains environment selection and creation.
  • Skill bundles explains skill inspection and reuse.
  • CLI explains local run and comparison records.
Was this page helpful?