Run an evaluator on the labelled items and compare its answers with the annotators
Once Meena and Kabir have labelled the items in “Check tutor replies”, run the evaluator on the same items. Calibrate then compares the evaluator’s answers with theirs.
Run the evaluator
Open the task from the Tasks tab on the Human alignment page.
On the Dataset tab, tick the items to evaluate. To pick every item, tick the box in the header row.
Click Evaluate selected. To evaluate one item, click Evaluate on its row.
In Run evaluators, select “Explains step by step” and pick the version to run.
Click Run.
The evaluation run page opens. Every run is also listed on the Evaluation runs tab of the task.
Read the evaluation run
The Summary tab of Evaluator results has one row per evaluator:
Score: what the evaluator scored across the items. Here, it marked 75% of the replies Correct.
Agreement with humans: how often the evaluator gave the same answer as the annotators, with its kappa. The line on the bar and the Chance figure under it show the agreement chance alone would produce.
Here, the evaluator agreed with the annotators 88% of the time. Chance alone would give 56%, so the kappa is 0.71 and the bar is green. The evaluator agrees well with Meena and Kabir. It disagrees only with Kabir, on the reply “Saves progress after a solved question”.
The Items tab shows the evaluator’s answer and each annotator’s answer on every item. Click Show disagreements only to see only the items where they differ.Other buttons at the top of the run page:
Send for review: send the items shown to annotators to label.
Share: make a public link to the run.
Read the task overview
The Overview tab of the task brings the numbers together:
Evaluator scores: what each evaluator scored across the items.
Human scores: what the annotators scored across the same items.
Score reliability: the Annotator agreement and Evaluator agreement with humans, each with its kappa.
Agreement between annotators shows how clear the question is. If Meena and Kabir often disagree, make the evaluator’s question clearer before trusting any evaluator on it.
Track agreement across versions
Each time you change the evaluator’s prompt, run it again on the same items. To see whether a change helped, open the evaluator from Agent simulations → Evaluators in the sidebar and click the Agreement tab. The Agreement trend chart shows the agreement and kappa for each version.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Calibrate","colors":{"primary":"#16A34A","light":"#07C983","dark":"#15803D"},"logo":{"light":"https://mintcdn.com/amandalmia/TsDdvjhyewlsTagk/logo/light.svg?fit=max\u0026auto=format\u0026n=TsDdvjhyewlsTagk\u0026q=85\u0026s=fc75161f50c310dfdb624daa2ba2902f","dark":"https://mintcdn.com/amandalmia/TsDdvjhyewlsTagk/logo/dark.svg?fit=max\u0026auto=format\u0026n=TsDdvjhyewlsTagk\u0026q=85\u0026s=9bce685ee4f5c31857b277b793bfb3b6"},"favicon":"https://mintcdn.com/amandalmia/j8YDDTRMPRzAIjqK/favicon.svg?fit=max\u0026auto=format\u0026n=j8YDDTRMPRzAIjqK\u0026q=85\u0026s=aeb4bd7fdbe6fbf9d56dc0060f0246e2","api":{"openapi":"api-reference/openapi.json","playground":{"display":"interactive"},"examples":{"defaults":"required","languages":["curl","python"],"autogenerate":true}},"navbar":{"links":[{"href":"https://chat.whatsapp.com/JygDNcZ943a3VmZDXYMg5Z","label":"Join WhatsApp"},{"href":"https://github.com/artpark-sahai-org/calibrate","label":"GitHub"}],"primary":{"type":"button","label":"Get Started","href":"https://calibrate.artpark.ai"}},"footer":{"socials":{"github":"https://github.com/artpark-sahai-org/calibrate"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"GitHub","icon":"github","href":"https://github.com/artpark-sahai-org/calibrate"},{"anchor":"WhatsApp","icon":"whatsapp","href":"https://chat.whatsapp.com/JygDNcZ943a3VmZDXYMg5Z"},{"anchor":"Changelog","icon":"clock-rotate-left","href":"https://calibrate.artpark.ai/changelog"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"amandalmia","hasAudioNarration":false,"actualSubdomain":"amandalmia","customDomains":["docs.calibrate.artpark.ai"],"gitSource":{"type":"github","owner":"artpark-sahai-org","repo":"calibrate","deployBranch":"main","contentDirectory":"docs","isPrivate":false,"mountPath":"","label":""},"entitlements":{},"buildId":"6af40e7426748fe2e4145223","clientVersion":"0.0.4143","searchFilterCounts":[{"language":"default","tag":"API reference","count":48},{"language":"default","tag":"Python SDK","count":48},{"language":"default","tag":"Home","count":38},{"language":"default","tag":"Agents","count":26},{"language":"default","tag":"Annotation tasks","count":22},{"language":"default","tag":"Agent tests","count":20},{"language":"default","tag":"Guides","count":19},{"language":"default","tag":"Evaluators","count":11},{"language":"default","tag":"Calibrate Local","count":11},{"language":"default","tag":"CLI","count":11}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"app/human-alignment/agreement","slug":"/app/human-alignment/agreement","pageMetadata":{"title":"Check how well an evaluator agrees with people","description":"Run an evaluator on the labelled items and compare its answers with the annotators","href":"/app/human-alignment/agreement"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Run an evaluator on the labelled items and compare its answers with the annotators\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,li:`li`,ol:`ol`,p:`p`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{Frame,Heading,OptimizedImage,Tip}=_components;if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Tip)_missingMdxReference(`Tip`,true);return _jsxs(_Fragment,{children:[_jsx(`video`,{controls:true,className:`mint-w-full mint-aspect-video mint-rounded-xl`,src:`https://mintcdn.com/amandalmia/eC2smNZTZjZjvk8E/videos/app-human-alignment-agreement.mp4?fit=max\u0026auto=format\u0026n=eC2smNZTZjZjvk8E\u0026q=85\u0026s=5267f4653682688ce8721c9fd8a2ed48`,\"data-path\":`videos/app-human-alignment-agreement.mp4`}),`\n`,_jsx(_components.p,{children:`Once Meena and Kabir have labelled the items in “Check tutor replies”, run the evaluator on the same items. Calibrate then compares the evaluator’s answers with theirs.`}),`\n`,_jsx(Heading,{level:`2`,id:`run-the-evaluator`,children:`Run the evaluator`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`Open the task from the `,_jsx(_components.strong,{children:`Tasks`}),` tab on the `,_jsx(_components.strong,{children:`Human alignment`}),` page.`]}),`\n`,_jsxs(_components.li,{children:[`On the `,_jsx(_components.strong,{children:`Dataset`}),` tab, tick the items to evaluate. To pick every item, tick the box in the header row.`]}),`\n`,_jsxs(_components.li,{children:[`Click `,_jsx(_components.strong,{children:`Evaluate selected`}),`. To evaluate one item, click `,_jsx(_components.strong,{children:`Evaluate`}),` on its row.`]}),`\n`,_jsxs(_components.li,{children:[`In `,_jsx(_components.strong,{children:`Run evaluators`}),`, select “Explains step by step” and pick the version to run.`]}),`\n`]}),`\n`,_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/amandalmia/Ruc8IMSY1ImbuaB4/images/app/human-alignment-run-evaluators.png?fit=max\u0026auto=format\u0026n=Ruc8IMSY1ImbuaB4\u0026q=85\u0026s=9bffa59e63c3f1f88ffed36f1fc3dcdd`,alt:`The Run evaluators window with Explains step by step selected and version v2, marked Live, picked`,\"data-og-width\":`1440`,width:`1440`,\"data-og-height\":`900`,height:`900`,\"data-path\":`images/app/human-alignment-run-evaluators.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/amandalmia/Ruc8IMSY1ImbuaB4/images/app/human-alignment-run-evaluators.png?w=280\u0026fit=max\u0026auto=format\u0026n=Ruc8IMSY1ImbuaB4\u0026q=85\u0026s=1d0867a2880b6a28502cbdca227e372f 280w, https://mintcdn.com/amandalmia/Ruc8IMSY1ImbuaB4/images/app/human-alignment-run-evaluators.png?w=560\u0026fit=max\u0026auto=format\u0026n=Ruc8IMSY1ImbuaB4\u0026q=85\u0026s=d1af12de6a4327dcf066d2034164409a 560w, https://mintcdn.com/amandalmia/Ruc8IMSY1ImbuaB4/images/app/human-alignment-run-evaluators.png?w=840\u0026fit=max\u0026auto=format\u0026n=Ruc8IMSY1ImbuaB4\u0026q=85\u0026s=4f15bb63e614df1ac1bc084690ede86e 840w, https://mintcdn.com/amandalmia/Ruc8IMSY1ImbuaB4/images/app/human-alignment-run-evaluators.png?w=1100\u0026fit=max\u0026auto=format\u0026n=Ruc8IMSY1ImbuaB4\u0026q=85\u0026s=5ce33d36c9613fc49dfbdccdc9fe329c 1100w, https://mintcdn.com/amandalmia/Ruc8IMSY1ImbuaB4/images/app/human-alignment-run-evaluators.png?w=1650\u0026fit=max\u0026auto=format\u0026n=Ruc8IMSY1ImbuaB4\u0026q=85\u0026s=f344eb0c6a3ea6146efe21d581382a06 1650w, https://mintcdn.com/amandalmia/Ruc8IMSY1ImbuaB4/images/app/human-alignment-run-evaluators.png?w=2500\u0026fit=max\u0026auto=format\u0026n=Ruc8IMSY1ImbuaB4\u0026q=85\u0026s=82815bc0c8d851bee3946878203be69c 2500w`})}),`\n`,_jsxs(_components.ol,{start:`5`,children:[`\n`,_jsxs(_components.li,{children:[`Click `,_jsx(_components.strong,{children:`Run`}),`.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`The evaluation run page opens. Every run is also listed on the `,_jsx(_components.strong,{children:`Evaluation runs`}),` tab of the task.`]}),`\n`,_jsx(Heading,{level:`2`,id:`read-the-evaluation-run`,children:`Read the evaluation run`}),`\n`,_jsxs(_components.p,{children:[`The `,_jsx(_components.strong,{children:`Summary`}),` tab of `,_jsx(_components.strong,{children:`Evaluator results`}),` has one row per evaluator:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Score`}),`: what the evaluator scored across the items. Here, it marked 75% of the replies `,_jsx(_components.strong,{children:`Correct`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Agreement with humans`}),`: how often the evaluator gave the same answer as the annotators, with its kappa. The line on the bar and the `,_jsx(_components.strong,{children:`Chance`}),` figure under it show the agreement chance alone would produce.`]}),`\n`]}),`\n`,_jsx(_components.p,{children:`Here, the evaluator agreed with the annotators 88% of the time. Chance alone would give 56%, so the kappa is 0.71 and the bar is green. The evaluator agrees well with Meena and Kabir. It disagrees only with Kabir, on the reply “Saves progress after a solved question”.`}),`\n`,_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/amandalmia/Ruc8IMSY1ImbuaB4/images/app/human-alignment-evaluation-run.png?fit=max\u0026auto=format\u0026n=Ruc8IMSY1ImbuaB4\u0026q=85\u0026s=08dcb5a1af21f32d2cdd379445d2a7b6`,alt:`An evaluation run of Explains step by step v2, scoring 75% Correct with 88% agreement with humans, 56% chance and a kappa of 0.71`,\"data-og-width\":`1440`,width:`1440`,\"data-og-height\":`900`,height:`900`,\"data-path\":`images/app/human-alignment-evaluation-run.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/amandalmia/Ruc8IMSY1ImbuaB4/images/app/human-alignment-evaluation-run.png?w=280\u0026fit=max\u0026auto=format\u0026n=Ruc8IMSY1ImbuaB4\u0026q=85\u0026s=c2580592b2c06ef9dd32e892ab8ed7a9 280w, https://mintcdn.com/amandalmia/Ruc8IMSY1ImbuaB4/images/app/human-alignment-evaluation-run.png?w=560\u0026fit=max\u0026auto=format\u0026n=Ruc8IMSY1ImbuaB4\u0026q=85\u0026s=2066bde3f457969dc80ef56b243d0c42 560w, https://mintcdn.com/amandalmia/Ruc8IMSY1ImbuaB4/images/app/human-alignment-evaluation-run.png?w=840\u0026fit=max\u0026auto=format\u0026n=Ruc8IMSY1ImbuaB4\u0026q=85\u0026s=6399a3ab5984f5fa6ff03d737c688784 840w, https://mintcdn.com/amandalmia/Ruc8IMSY1ImbuaB4/images/app/human-alignment-evaluation-run.png?w=1100\u0026fit=max\u0026auto=format\u0026n=Ruc8IMSY1ImbuaB4\u0026q=85\u0026s=ccec212065e103f6af4e7a46642b458d 1100w, https://mintcdn.com/amandalmia/Ruc8IMSY1ImbuaB4/images/app/human-alignment-evaluation-run.png?w=1650\u0026fit=max\u0026auto=format\u0026n=Ruc8IMSY1ImbuaB4\u0026q=85\u0026s=862547b8bcb897a516a2c21fb7607a9e 1650w, https://mintcdn.com/amandalmia/Ruc8IMSY1ImbuaB4/images/app/human-alignment-evaluation-run.png?w=2500\u0026fit=max\u0026auto=format\u0026n=Ruc8IMSY1ImbuaB4\u0026q=85\u0026s=81f8db5903f06101f621a1f8a08f831c 2500w`})}),`\n`,_jsxs(_components.p,{children:[`The `,_jsx(_components.strong,{children:`Items`}),` tab shows the evaluator’s answer and each annotator’s answer on every item. Click `,_jsx(_components.strong,{children:`Show disagreements only`}),` to see only the items where they differ.`]}),`\n`,_jsx(_components.p,{children:`Other buttons at the top of the run page:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Send for review`}),`: send the items shown to annotators to label.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Share`}),`: make a public link to the run.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`read-the-task-overview`,children:`Read the task overview`}),`\n`,_jsxs(_components.p,{children:[`The `,_jsx(_components.strong,{children:`Overview`}),` tab of the task brings the numbers together:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Evaluator scores`}),`: what each evaluator scored across the items.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Human scores`}),`: what the annotators scored across the same items.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Score reliability`}),`: the `,_jsx(_components.strong,{children:`Annotator agreement`}),` and `,_jsx(_components.strong,{children:`Evaluator agreement with humans`}),`, each with its kappa.`]}),`\n`]}),`\n`,_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/amandalmia/Ruc8IMSY1ImbuaB4/images/app/human-alignment-task-overview.png?fit=max\u0026auto=format\u0026n=Ruc8IMSY1ImbuaB4\u0026q=85\u0026s=b5c729e4128d8be5274287e8fa469009`,alt:`The Overview tab of Check tutor replies: evaluator score 75%, human score 63%, annotator agreement 75% and evaluator agreement with humans 88%`,\"data-og-width\":`1440`,width:`1440`,\"data-og-height\":`900`,height:`900`,\"data-path\":`images/app/human-alignment-task-overview.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/amandalmia/Ruc8IMSY1ImbuaB4/images/app/human-alignment-task-overview.png?w=280\u0026fit=max\u0026auto=format\u0026n=Ruc8IMSY1ImbuaB4\u0026q=85\u0026s=7429787f7b2a6062745b717d64847ada 280w, https://mintcdn.com/amandalmia/Ruc8IMSY1ImbuaB4/images/app/human-alignment-task-overview.png?w=560\u0026fit=max\u0026auto=format\u0026n=Ruc8IMSY1ImbuaB4\u0026q=85\u0026s=e33833538abc222b3c62431a131ae0ca 560w, https://mintcdn.com/amandalmia/Ruc8IMSY1ImbuaB4/images/app/human-alignment-task-overview.png?w=840\u0026fit=max\u0026auto=format\u0026n=Ruc8IMSY1ImbuaB4\u0026q=85\u0026s=e5a10baebe1ea7fd76240a69c1541167 840w, https://mintcdn.com/amandalmia/Ruc8IMSY1ImbuaB4/images/app/human-alignment-task-overview.png?w=1100\u0026fit=max\u0026auto=format\u0026n=Ruc8IMSY1ImbuaB4\u0026q=85\u0026s=b6254098b2258441b8f37bb6cf716fc9 1100w, https://mintcdn.com/amandalmia/Ruc8IMSY1ImbuaB4/images/app/human-alignment-task-overview.png?w=1650\u0026fit=max\u0026auto=format\u0026n=Ruc8IMSY1ImbuaB4\u0026q=85\u0026s=939156ca0ce01c502dacabbe4080d7b6 1650w, https://mintcdn.com/amandalmia/Ruc8IMSY1ImbuaB4/images/app/human-alignment-task-overview.png?w=2500\u0026fit=max\u0026auto=format\u0026n=Ruc8IMSY1ImbuaB4\u0026q=85\u0026s=73337c94a9e03c09a905593979c62bee 2500w`})}),`\n`,_jsx(Tip,{children:_jsx(_components.p,{children:`Agreement between annotators shows how clear the question is. If Meena and Kabir often disagree, make the evaluator’s question clearer before trusting any evaluator on it.`})}),`\n`,_jsx(Heading,{level:`2`,id:`track-agreement-across-versions`,children:`Track agreement across versions`}),`\n`,_jsxs(_components.p,{children:[`Each time you change the evaluator’s prompt, run it again on the same items. To see whether a change helped, open the evaluator from `,_jsx(_components.strong,{children:`Agent simulations`}),` → `,_jsx(_components.strong,{children:`Evaluators`}),` in the sidebar and click the `,_jsx(_components.strong,{children:`Agreement`}),` tab. The `,_jsx(_components.strong,{children:`Agreement trend`}),` chart shows the agreement and kappa for each version.`]}),`\n`,_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/amandalmia/Ruc8IMSY1ImbuaB4/images/app/human-alignment-agreement-trend.png?fit=max\u0026auto=format\u0026n=Ruc8IMSY1ImbuaB4\u0026q=85\u0026s=d890901eff0d24f0e368bca623277e1d`,alt:`The Agreement tab of Explains step by step, showing the Agreement trend chart with agreement and kappa for versions v1 and v2`,\"data-og-width\":`1440`,width:`1440`,\"data-og-height\":`900`,height:`900`,\"data-path\":`images/app/human-alignment-agreement-trend.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/amandalmia/Ruc8IMSY1ImbuaB4/images/app/human-alignment-agreement-trend.png?w=280\u0026fit=max\u0026auto=format\u0026n=Ruc8IMSY1ImbuaB4\u0026q=85\u0026s=b2953b101e3a36a6451739ee15f404a7 280w, https://mintcdn.com/amandalmia/Ruc8IMSY1ImbuaB4/images/app/human-alignment-agreement-trend.png?w=560\u0026fit=max\u0026auto=format\u0026n=Ruc8IMSY1ImbuaB4\u0026q=85\u0026s=6ffe343d7301120fd8c8d453a9656dd2 560w, https://mintcdn.com/amandalmia/Ruc8IMSY1ImbuaB4/images/app/human-alignment-agreement-trend.png?w=840\u0026fit=max\u0026auto=format\u0026n=Ruc8IMSY1ImbuaB4\u0026q=85\u0026s=5334b62e963640ce51112b82773331ea 840w, https://mintcdn.com/amandalmia/Ruc8IMSY1ImbuaB4/images/app/human-alignment-agreement-trend.png?w=1100\u0026fit=max\u0026auto=format\u0026n=Ruc8IMSY1ImbuaB4\u0026q=85\u0026s=cce94bd84ce4898c57b2e1149e026541 1100w, https://mintcdn.com/amandalmia/Ruc8IMSY1ImbuaB4/images/app/human-alignment-agreement-trend.png?w=1650\u0026fit=max\u0026auto=format\u0026n=Ruc8IMSY1ImbuaB4\u0026q=85\u0026s=239c2eda723717da42109d76c05045f3 1650w, https://mintcdn.com/amandalmia/Ruc8IMSY1ImbuaB4/images/app/human-alignment-agreement-trend.png?w=2500\u0026fit=max\u0026auto=format\u0026n=Ruc8IMSY1ImbuaB4\u0026q=85\u0026s=f26cdd1f3a0364ecdfcb75e434447bc1 2500w`})}),`\n`,_jsx(Heading,{level:`2`,id:`learn-how-the-numbers-are-worked-out`,children:`Learn how the numbers are worked out`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.a,{href:`/reference/human-alignment`,children:`Human alignment computation`}),` walks through a full example with Meena, Kabir and the tutor’s evaluators.`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Check how well an evaluator agrees with people","description":"Run an evaluator on the labelled items and compare its answers with the annotators","href":"/app/human-alignment/agreement"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Run the evaluator","slug":"run-the-evaluator","depth":2,"children":[]},{"title":"Read the evaluation run","slug":"read-the-evaluation-run","depth":2,"children":[]},{"title":"Read the task overview","slug":"read-the-task-overview","depth":2,"children":[]},{"title":"Track agreement across versions","slug":"track-agreement-across-versions","depth":2,"children":[]},{"title":"Learn how the numbers are worked out","slug":"learn-how-the-numbers-are-worked-out","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"dynamicCss":".mint-aspect-video {\n aspect-ratio: 16 / 9\n}\n.mint-w-full {\n width: 100%\n}\n.mint-rounded-xl {\n border-radius: 0.75rem\n}","subdomain":"amandalmia","siteName":"Calibrate","title":"Check how well an evaluator agrees with people - Calibrate","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-03T09:05:14.123Z","originalFileLocation":"app/human-alignment/agreement.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Run an evaluator on the labelled items and compare its answers with the annotators\">\u003cmeta data-mint-head name=\"application-name\" content=\"Calibrate\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/amandalmia/qn-FcGdaE2quP6EV/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/amandalmia/qn-FcGdaE2quP6EV/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/amandalmia/qn-FcGdaE2quP6EV/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/amandalmia/qn-FcGdaE2quP6EV/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/amandalmia/qn-FcGdaE2quP6EV/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/amandalmia/qn-FcGdaE2quP6EV/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/amandalmia/qn-FcGdaE2quP6EV/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/amandalmia/qn-FcGdaE2quP6EV/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/amandalmia/qn-FcGdaE2quP6EV/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Check how well an evaluator agrees with people - Calibrate\">\u003cmeta data-mint-head property=\"og:description\" content=\"Run an evaluator on the labelled items and compare its answers with the annotators\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Calibrate\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.calibrate.artpark.ai/app/human-alignment/agreement\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://amandalmia.mintlify.site/_mintlify/api/og/v2?division=Human+alignment\u0026amp;title=Check+how+well+an+evaluator+agrees+with+people\u0026amp;description=Run+an+evaluator+on+the+labelled+items+and+compare+its+answers+with+the+annotators\u0026amp;theme=e0ebd667abdfd31e60f36807\u0026amp;signature=bbb59c6d4e9351f447a4f21dbea897c351822ad275e3b197523e838f62fc0009\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Check how well an evaluator agrees with people - Calibrate\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Run an evaluator on the labelled items and compare its answers with the annotators\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://amandalmia.mintlify.site/_mintlify/api/og/v2?division=Human+alignment\u0026amp;title=Check+how+well+an+evaluator+agrees+with+people\u0026amp;description=Run+an+evaluator+on+the+labelled+items+and+compare+its+answers+with+the+annotators\u0026amp;theme=e0ebd667abdfd31e60f36807\u0026amp;signature=bbb59c6d4e9351f447a4f21dbea897c351822ad275e3b197523e838f62fc0009\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/amandalmia/qn-FcGdaE2quP6EV/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Calibrate\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#16A34A\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.calibrate.artpark.ai/app/human-alignment/agreement\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/app/human-alignment/agreement.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.calibrate.artpark.ai/#organization\",\"name\":\"Calibrate\",\"url\":\"https://docs.calibrate.artpark.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/amandalmia/TsDdvjhyewlsTagk/logo/light.svg?fit=max\u0026auto=format\u0026n=TsDdvjhyewlsTagk\u0026q=85\u0026s=fc75161f50c310dfdb624daa2ba2902f\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.calibrate.artpark.ai#website\",\"name\":\"Calibrate\",\"url\":\"https://docs.calibrate.artpark.ai\",\"publisher\":{\"@id\":\"https://docs.calibrate.artpark.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.calibrate.artpark.ai/app/human-alignment/agreement#webpage\",\"url\":\"https://docs.calibrate.artpark.ai/app/human-alignment/agreement\",\"name\":\"Check how well an evaluator agrees with people\",\"description\":\"Run an evaluator on the labelled items and compare its answers with the annotators\",\"dateModified\":\"2026-11-03T09:05:14.123Z\",\"isPartOf\":{\"@id\":\"https://docs.calibrate.artpark.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.calibrate.artpark.ai/app/human-alignment/agreement#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.calibrate.artpark.ai/app/human-alignment/agreement#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Human alignment\",\"item\":\"https://docs.calibrate.artpark.ai/app/human-alignment/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Check how well an evaluator agrees with people\",\"item\":\"https://docs.calibrate.artpark.ai/app/human-alignment/agreement\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.calibrate.artpark.ai/app/human-alignment/agreement#article\",\"headline\":\"Check how well an evaluator agrees with people\",\"name\":\"Check how well an evaluator agrees with people\",\"description\":\"Run an evaluator on the labelled items and compare its answers with the annotators\",\"url\":\"https://docs.calibrate.artpark.ai/app/human-alignment/agreement\",\"mainEntityOfPage\":{\"@id\":\"https://docs.calibrate.artpark.ai/app/human-alignment/agreement#webpage\"},\"dateModified\":\"2026-11-03T09:05:14.123Z\",\"publisher\":{\"@id\":\"https://docs.calibrate.artpark.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.calibrate.artpark.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Calibrate\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Calibrate\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/app/human-alignment/agreement.md","siteName":"Calibrate","nav":{"global":{"anchors":[{"anchor":"GitHub","icon":"github","href":"https://github.com/artpark-sahai-org/calibrate"},{"anchor":"WhatsApp","icon":"whatsapp","href":"https://chat.whatsapp.com/JygDNcZ943a3VmZDXYMg5Z"},{"anchor":"Changelog","icon":"clock-rotate-left","href":"https://calibrate.artpark.ai/changelog"}]},"tabs":[{"tab":"Home","groups":[{"group":"Get started","pages":[{"title":"Introduction","href":"/getting-started/introduction"},{"title":"Create your account","href":"/getting-started/create-account"},{"title":"Quickstart","href":"/getting-started/quickstart"}]},{"group":"Agents","pages":[{"title":"Agents overview","sidebarTitle":"Overview","href":"/app/agents/overview"},{"title":"Build an agent in Calibrate","sidebarTitle":"Build an agent","href":"/core-concepts/agents"},{"title":"Connect your own agent","href":"/core-concepts/agent-connections"},{"title":"Add tools to an agent","sidebarTitle":"Add tools","href":"/core-concepts/tools"},{"title":"Evaluate your agent with unit tests","href":"/app/agents/tests"},{"title":"Compare models on your tests","sidebarTitle":"Benchmark models on latency, cost and accuracy","href":"/app/agents/compare-models"},{"title":"Monitor your agent in production","sidebarTitle":"Continuously monitor your agent","href":"/app/agents/monitoring"}]},{"group":"Evaluators","pages":[{"title":"Evaluators overview","sidebarTitle":"Overview","href":"/app/evaluators/overview"},{"title":"Create an evaluator","href":"/app/evaluators/create"},{"title":"Edit an evaluator and manage versions","sidebarTitle":"Update an evaluator and track its versions","href":"/app/evaluators/versions"}]},{"group":"Human alignment","pages":[{"title":"Human alignment overview","sidebarTitle":"Overview","href":"/app/human-alignment/overview"},{"title":"Create a labelling task","href":"/app/human-alignment/labelling-tasks"},{"title":"Invite annotators","description":"Add the people who label items, and see how they label them","href":"/app/human-alignment/annotators"},{"title":"Check how well an evaluator agrees with people","href":"/app/human-alignment/agreement"},{"title":"Human alignment computation","description":"How Calibrate computes human and evaluator scores, and measures agreement among humans and between evaluators and humans","href":"/reference/human-alignment"}]},{"group":"Simulations","pages":[{"title":"Simulations overview","sidebarTitle":"Overview","href":"/app/simulations/overview"},{"title":"Personas","href":"/core-concepts/personas"},{"title":"Scenarios","href":"/core-concepts/scenarios"},{"title":"Simulation evaluators","sidebarTitle":"Evaluate agent quality in a simulation","href":"/core-concepts/metrics"},{"title":"Run a text or voice simulation","sidebarTitle":"Run a simulation","href":"/quickstart/simulations"}]},{"group":"Speech-to-text","pages":[{"title":"Benchmark speech-to-text models","sidebarTitle":"Benchmark different models","href":"/quickstart/speech-to-text"},{"title":"Speech-to-text metrics","sidebarTitle":"Metrics","href":"/core-concepts/speech-to-text"},{"title":"Speech-to-text datasets","sidebarTitle":"Datasets","href":"/app/speech-to-text/datasets"}]},{"group":"Text-to-speech","pages":[{"title":"Benchmark text-to-speech models","sidebarTitle":"Benchmark different models","href":"/quickstart/text-to-speech"},{"title":"Text-to-speech metrics","sidebarTitle":"Metrics","href":"/core-concepts/text-to-speech"},{"title":"Text-to-speech datasets","sidebarTitle":"Datasets","href":"/app/text-to-speech/datasets"}]},{"group":"Workspaces for Teams","pages":[{"title":"Overview","href":"/app/workspace-settings/overview"},{"title":"Members","href":"/app/workspace-settings/members"},{"title":"Settings","href":"/app/workspace-settings/settings"},{"title":"Bring your own keys (BYOK)","href":"/reference/byok"},{"title":"API keys","href":"/reference/api-keys"},{"title":"Rate limits","href":"/reference/rate-limits"}]},{"group":"Reference","pages":[{"title":"Product tour","href":"/reference/product-tour"},{"title":"Learning resources","href":"/reference/learning-resources"},{"title":"GitHub Action","href":"/reference/github-actions"}]}]},{"tab":"Agents","pages":[{"title":"Agents","href":"/agents/overview"}]},{"tab":"API reference","pages":[{"title":"API reference","href":"/api-reference/introduction"}]},{"tab":"CLI","pages":[{"title":"CLI","href":"/cli/calibrate/overview"}]},{"tab":"Python SDK","pages":[{"title":"Python SDK","href":"/sdk/overview"}]},{"tab":"MCP","pages":[{"title":"MCP","href":"/mcp/overview"}]},{"tab":"Calibrate Local","pages":[{"title":"Calibrate Local","href":"/cli/overview"}]},{"tab":"Integrations","pages":[{"title":"Integrations","href":"/integrations/setup"}]},{"tab":"Use cases","href":"https://calibrate.artpark.ai/#use-cases"}]},"basePath":"","title":"Check how well an evaluator agrees with people - Calibrate","buildId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","deploymentId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","dynamics":["07c022d89b","a74be98ba7"],"chunks":["Frame-D2acuaLg.js","DynamicMarkdown-Co5nikxh.js","zoom-image-lightbox-BbK2OBGL.js","lightbox-handle-r17bVUz3.js"]}