Skip to content

docs(evaluation): Understanding Evaluation concept#711

Merged
khushalsonawat merged 3 commits into
docs/evaluation-revampfrom
docs/eval-understanding-evaluation
Jul 9, 2026
Merged

docs(evaluation): Understanding Evaluation concept#711
khushalsonawat merged 3 commits into
docs/evaluation-revampfrom
docs/eval-understanding-evaluation

Conversation

@YashMohan23

Copy link
Copy Markdown

The four-object data model (template → config → run → score), the quality loop, and the three eval types. Retitled to 'Understanding Evaluation', no ## About, 156. Draft — batched Evaluation revamp.

🤖 Generated with Claude Code

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@khushalsonawat khushalsonawat marked this pull request as ready for review July 8, 2026 07:17

@khushalsonawat khushalsonawat left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Check comments

<Card title="Judge models" icon="robot" href="/docs/evaluation/concepts/judge-models">
The models that read and score a response
</Card>
<Card title="Scores & results" icon="chart-mixed" href="/docs/evaluation/concepts/eval-results">

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

concepts/eval-results is gone after the remap on the base branch, this 404s now. Point it at /docs/evaluation/concepts/output-types and title the card Output types

---

## About
Evaluation is Future AGI's quality measurement layer. You define what "good" means once, and the platform scores every response against that definition, returning a result and a plain-language reason for each one. Because the same definition runs everywhere your work lives, a score means the same thing on a dataset, a simulation, a live trace, or a pull request.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Concept pages open directly at the first H2, no hero paragraph (same shape as the Observe concept pages). Fold this into the description and the first section. Also "a plain-language reason for each one": the reason is optional, don't promise it on every response

Evaluation is Future AGI's quality measurement layer. You define what "good" means once, and the platform scores every response against that definition, returning a result and a plain-language reason for each one. Because the same definition runs everywhere your work lives, a score means the same thing on a dataset, a simulation, a live trace, or a pull request.

Evaluation in Future AGI is a systematic way to measure whether your AI is producing the right outputs. You define what "right" means once, using an eval template, and the platform scores every response automatically against that definition, returning a result and a reason for each one.
## The four objects

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is the anchor concept and it has no diagram or example. Add the one Mermaid (template -> config -> run -> score) and one short worked example, one groundedness template on one row is enough

3. **Pick a judge model**: Choose a Future AGI model (e.g. `turing_flash`) or bring your own via a custom model integration. The judge reads each row and applies the template criteria.

4. **Run**: The platform processes every row in parallel. Each row gets a result (pass/fail or a score) and a reason explaining the judgment.
- A **template** defines *what* to measure: the criteria, the expected output type, and a pass threshold. Templates are reusable and versioned, and are either built by Future AGI or written by you

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Link first mentions: templates -> eval-templates here, and optimize -> /docs/optimization in the quality loop section. Judge model is linked, these should be too

@khushalsonawat khushalsonawat merged commit 824ccc1 into docs/evaluation-revamp Jul 9, 2026
@khushalsonawat khushalsonawat deleted the docs/eval-understanding-evaluation branch July 9, 2026 07:55
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants