Create your own evaluator to match your specific needs. You can start right away with custom criteria for full flexibility, or use one of our recommended formats as a starting point.
This option lets you write the evaluator prompt from scratch by adding the desired messages (System, Assistant, User, or Developer) and configuring the model along with its settings.
The evaluator prompt can be automatically configured by Traceloop by clicking on the Generate Evaluator button.
To enable the button, map the column you want to evaluate (such as an LLM response) and add any additional data columns required for prompt creation.
Describe the evaluator’s purpose and reference the relevant data columns in the description.The system generates a prompt template that you can edit and customize as needed.
Before creating an evaluator, you can test it on existing Playground data.
This allows you to refine and correct the evaluator prompt before saving the final version.
{"docsConfig":{"$schema":"https://mintlify.com/docs.json","theme":"mint","name":"traceloop","colors":{"primary":"#EAB308","light":"#EAB308","dark":"#EAB308"},"favicon":"https://mintcdn.com/enrolla/-xQ9K52hAYrcQGvz/favicon.png?fit=max\u0026auto=format\u0026n=-xQ9K52hAYrcQGvz\u0026q=85\u0026s=6066426161fe311654d19ebca89ee7c0","logo":{"light":"https://mintcdn.com/enrolla/GspX1ocwd1gETLy0/logo/traceloop-light.png?fit=max\u0026auto=format\u0026n=GspX1ocwd1gETLy0\u0026q=85\u0026s=e245f77b5b8af11ef9aa4a0ce2ee97a6","dark":"https://mintcdn.com/enrolla/GspX1ocwd1gETLy0/logo/traceloop-dark.png?fit=max\u0026auto=format\u0026n=GspX1ocwd1gETLy0\u0026q=85\u0026s=d34d3b622526506a2a4512b32d4ebb9b"},"api":{"openapi":"openapi.json","mdx":{"server":"https://app.traceloop.com/api","auth":{"method":"bearer","name":null}}},"appearance":{"default":"dark","strict":null},"background":{"decoration":null,"color":{"light":null,"dark":"#09090B"}},"navbar":{"links":[{"label":"Community","href":"https://traceloop.com/slack"},{"label":"Support","href":"https://support.traceloop.com"}],"primary":{"type":"button","label":"Start now","href":"https://app.traceloop.com/"}},"footer":{"socials":{"github":"https://github.com/traceloop","twitter":"https://twitter.com/traceloopdev"}},"integrations":{"gtm":{"tagId":"GTM-NDQVZMH"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"enrolla","hasAudioNarration":false,"actualSubdomain":"enrolla","customDomains":["www.traceloop.com"],"gitSource":{"type":"github","owner":"traceloop","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6a50ddc4a3ca9e4edbc90a63","collectionId":"adc0afa5-95ac-4624-90b0-9d9b79bb22a1","schemaVersion":"v3"},"feedback":{"thumbs":true,"edits":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6a50ddc4a3ca9e4edbc90a63:success","clientVersion":"0.0.3971","searchFilterCounts":[{"language":"default","tag":"Dashboard API","count":55},{"language":"default","tag":"OpenLLMetry","count":55},{"language":"default","tag":"Evaluators","count":43},{"language":"default","tag":"Integrations","count":34},{"language":"default","tag":"Documentation","count":30},{"language":"default","tag":"Tracing","count":14},{"language":"default","tag":"Quick Start","count":9},{"language":"default","tag":"Auto-monitor-setups","count":6},{"language":"default","tag":"Playgrounds","count":4},{"language":"default","tag":"Self-host","count":4}]},"assistantConfig":{},"basePath":"/docs","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","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":"editor-v7-file-tree","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":"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":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","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":"per-site-search-delta","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":"editor-private-page-search","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":"editor-nav-generations","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":"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":"byok-sep-25","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":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","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":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"isAtlas":false,"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"#topbar-cta-button span,#topbar-cta-button svg{color:#09090b!important}#topbar-cta-button span.absolute{border-radius:8px!important}.nav-logo{width:140px!important}"}],"page":{"pagePath":"evaluators/custom-evaluator","slug":"/evaluators/custom-evaluator","pageMetadata":{"title":"Custom Evaluators","description":"Define an evaluator for your specific needs ","href":"/evaluators/custom-evaluator"},"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: \"Define an evaluator for your specific needs\"\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`,code:`code`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,..._provideComponents(),...props.components},{CodeBlock,Frame,Heading,OptimizedImage}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Create your own evaluator to match your specific needs. You can start right away with custom criteria for full flexibility, or use one of our recommended formats as a starting point.`}),`\n`,_jsxs(Frame,{children:[_jsx(OptimizedImage,{className:`mint-block dark:mint-hidden`,src:`https://mintcdn.com/enrolla/-xQ9K52hAYrcQGvz/img/evaluator/eval-custom-light.png?fit=max\u0026auto=format\u0026n=-xQ9K52hAYrcQGvz\u0026q=85\u0026s=875e3060f650ac2058742288d3b27e6b`,\"data-og-width\":`2376`,width:`2376`,\"data-og-height\":`1386`,height:`1386`,\"data-path\":`img/evaluator/eval-custom-light.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/enrolla/-xQ9K52hAYrcQGvz/img/evaluator/eval-custom-light.png?w=280\u0026fit=max\u0026auto=format\u0026n=-xQ9K52hAYrcQGvz\u0026q=85\u0026s=46090a7c162198e95eedba1069a737a9 280w, https://mintcdn.com/enrolla/-xQ9K52hAYrcQGvz/img/evaluator/eval-custom-light.png?w=560\u0026fit=max\u0026auto=format\u0026n=-xQ9K52hAYrcQGvz\u0026q=85\u0026s=4e724aaebbf402b3d4fddc0c0f5af7f8 560w, https://mintcdn.com/enrolla/-xQ9K52hAYrcQGvz/img/evaluator/eval-custom-light.png?w=840\u0026fit=max\u0026auto=format\u0026n=-xQ9K52hAYrcQGvz\u0026q=85\u0026s=23a9193a3a12b71db60670ac5c41c50d 840w, https://mintcdn.com/enrolla/-xQ9K52hAYrcQGvz/img/evaluator/eval-custom-light.png?w=1100\u0026fit=max\u0026auto=format\u0026n=-xQ9K52hAYrcQGvz\u0026q=85\u0026s=77c1bee4cfc3a5d79b0820078a47d118 1100w, https://mintcdn.com/enrolla/-xQ9K52hAYrcQGvz/img/evaluator/eval-custom-light.png?w=1650\u0026fit=max\u0026auto=format\u0026n=-xQ9K52hAYrcQGvz\u0026q=85\u0026s=62a3082c072511bc4386e295325c0fc7 1650w, https://mintcdn.com/enrolla/-xQ9K52hAYrcQGvz/img/evaluator/eval-custom-light.png?w=2500\u0026fit=max\u0026auto=format\u0026n=-xQ9K52hAYrcQGvz\u0026q=85\u0026s=fb22928102050d38984b1b6d193692fe 2500w`}),_jsx(OptimizedImage,{className:`mint-hidden dark:mint-block`,src:`https://mintcdn.com/enrolla/-xQ9K52hAYrcQGvz/img/evaluator/eval-custom-dark.png?fit=max\u0026auto=format\u0026n=-xQ9K52hAYrcQGvz\u0026q=85\u0026s=d272ae37ea8e3a2a7d9e057700fac28d`,\"data-og-width\":`2378`,width:`2378`,\"data-og-height\":`1388`,height:`1388`,\"data-path\":`img/evaluator/eval-custom-dark.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/enrolla/-xQ9K52hAYrcQGvz/img/evaluator/eval-custom-dark.png?w=280\u0026fit=max\u0026auto=format\u0026n=-xQ9K52hAYrcQGvz\u0026q=85\u0026s=cce8b473e983b6f5648f5ad7e028437f 280w, https://mintcdn.com/enrolla/-xQ9K52hAYrcQGvz/img/evaluator/eval-custom-dark.png?w=560\u0026fit=max\u0026auto=format\u0026n=-xQ9K52hAYrcQGvz\u0026q=85\u0026s=bc8f1475d3199e7ddc3afc48711659d3 560w, https://mintcdn.com/enrolla/-xQ9K52hAYrcQGvz/img/evaluator/eval-custom-dark.png?w=840\u0026fit=max\u0026auto=format\u0026n=-xQ9K52hAYrcQGvz\u0026q=85\u0026s=445f31e8076a38eb936011ebf96d3a1d 840w, https://mintcdn.com/enrolla/-xQ9K52hAYrcQGvz/img/evaluator/eval-custom-dark.png?w=1100\u0026fit=max\u0026auto=format\u0026n=-xQ9K52hAYrcQGvz\u0026q=85\u0026s=c54626e6a201e59b9abe9cecfff9cfd6 1100w, https://mintcdn.com/enrolla/-xQ9K52hAYrcQGvz/img/evaluator/eval-custom-dark.png?w=1650\u0026fit=max\u0026auto=format\u0026n=-xQ9K52hAYrcQGvz\u0026q=85\u0026s=321db37b71c27f1cc2c09d2bf4e2259c 1650w, https://mintcdn.com/enrolla/-xQ9K52hAYrcQGvz/img/evaluator/eval-custom-dark.png?w=2500\u0026fit=max\u0026auto=format\u0026n=-xQ9K52hAYrcQGvz\u0026q=85\u0026s=e7b0312cc6d16dbcb7dc0fd41c226751 2500w`})]}),`\n`,_jsx(Heading,{level:`2`,id:`do-it-yourself`,children:`Do It Yourself`}),`\n`,_jsx(_components.p,{children:`This option lets you write the evaluator prompt from scratch by adding the desired messages (System, Assistant, User, or Developer) and configuring the model along with its settings.`}),`\n`,_jsxs(Frame,{children:[_jsx(OptimizedImage,{className:`mint-block dark:mint-hidden`,src:`https://mintcdn.com/enrolla/-xQ9K52hAYrcQGvz/img/evaluator/eval-do-it-yourself-light.png?fit=max\u0026auto=format\u0026n=-xQ9K52hAYrcQGvz\u0026q=85\u0026s=61ec66544fab9316edd6f5031a327393`,\"data-og-width\":`2698`,width:`2698`,\"data-og-height\":`1390`,height:`1390`,\"data-path\":`img/evaluator/eval-do-it-yourself-light.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/enrolla/-xQ9K52hAYrcQGvz/img/evaluator/eval-do-it-yourself-light.png?w=280\u0026fit=max\u0026auto=format\u0026n=-xQ9K52hAYrcQGvz\u0026q=85\u0026s=eed47bd859dfa451a4ec69aaf74f4fa6 280w, https://mintcdn.com/enrolla/-xQ9K52hAYrcQGvz/img/evaluator/eval-do-it-yourself-light.png?w=560\u0026fit=max\u0026auto=format\u0026n=-xQ9K52hAYrcQGvz\u0026q=85\u0026s=31ff1c84b1b85cdb43799e26081113c6 560w, https://mintcdn.com/enrolla/-xQ9K52hAYrcQGvz/img/evaluator/eval-do-it-yourself-light.png?w=840\u0026fit=max\u0026auto=format\u0026n=-xQ9K52hAYrcQGvz\u0026q=85\u0026s=e1f43faeff043c4bc4f58e907d2e1cf8 840w, https://mintcdn.com/enrolla/-xQ9K52hAYrcQGvz/img/evaluator/eval-do-it-yourself-light.png?w=1100\u0026fit=max\u0026auto=format\u0026n=-xQ9K52hAYrcQGvz\u0026q=85\u0026s=2d4f4d3d282841e65b4efd3d7ed452ca 1100w, https://mintcdn.com/enrolla/-xQ9K52hAYrcQGvz/img/evaluator/eval-do-it-yourself-light.png?w=1650\u0026fit=max\u0026auto=format\u0026n=-xQ9K52hAYrcQGvz\u0026q=85\u0026s=837498e1e7073434223e21d4d3c0cd25 1650w, https://mintcdn.com/enrolla/-xQ9K52hAYrcQGvz/img/evaluator/eval-do-it-yourself-light.png?w=2500\u0026fit=max\u0026auto=format\u0026n=-xQ9K52hAYrcQGvz\u0026q=85\u0026s=b4cc117499e84a6597ba7ad8c7f5d77b 2500w`}),_jsx(OptimizedImage,{className:`mint-hidden dark:mint-block`,src:`https://mintcdn.com/enrolla/-xQ9K52hAYrcQGvz/img/evaluator/eval-do-it-yourself-dark.png?fit=max\u0026auto=format\u0026n=-xQ9K52hAYrcQGvz\u0026q=85\u0026s=23e2088c62a4e3d2d1a2c89ed051ef06`,\"data-og-width\":`2392`,width:`2392`,\"data-og-height\":`1384`,height:`1384`,\"data-path\":`img/evaluator/eval-do-it-yourself-dark.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/enrolla/-xQ9K52hAYrcQGvz/img/evaluator/eval-do-it-yourself-dark.png?w=280\u0026fit=max\u0026auto=format\u0026n=-xQ9K52hAYrcQGvz\u0026q=85\u0026s=e07c34b541ba43740ec577876eeecc8b 280w, https://mintcdn.com/enrolla/-xQ9K52hAYrcQGvz/img/evaluator/eval-do-it-yourself-dark.png?w=560\u0026fit=max\u0026auto=format\u0026n=-xQ9K52hAYrcQGvz\u0026q=85\u0026s=429ff2171836d2f9d0895f9501c3fd23 560w, https://mintcdn.com/enrolla/-xQ9K52hAYrcQGvz/img/evaluator/eval-do-it-yourself-dark.png?w=840\u0026fit=max\u0026auto=format\u0026n=-xQ9K52hAYrcQGvz\u0026q=85\u0026s=fc119e56adf5d34686fadd729f2c8d66 840w, https://mintcdn.com/enrolla/-xQ9K52hAYrcQGvz/img/evaluator/eval-do-it-yourself-dark.png?w=1100\u0026fit=max\u0026auto=format\u0026n=-xQ9K52hAYrcQGvz\u0026q=85\u0026s=96434d7fc821fb8ef4d01380a5daaf89 1100w, https://mintcdn.com/enrolla/-xQ9K52hAYrcQGvz/img/evaluator/eval-do-it-yourself-dark.png?w=1650\u0026fit=max\u0026auto=format\u0026n=-xQ9K52hAYrcQGvz\u0026q=85\u0026s=5546b6489ea72cbcfd18ffcec9d2837f 1650w, https://mintcdn.com/enrolla/-xQ9K52hAYrcQGvz/img/evaluator/eval-do-it-yourself-dark.png?w=2500\u0026fit=max\u0026auto=format\u0026n=-xQ9K52hAYrcQGvz\u0026q=85\u0026s=b990e54c88d44a9449292381d1285cd4 2500w`})]}),`\n`,_jsx(Heading,{level:`2`,id:`generate-evaluator`,children:`Generate Evaluator`}),`\n`,_jsxs(_components.p,{children:[`The evaluator prompt can be automatically configured by Traceloop by clicking on the `,_jsx(_components.strong,{children:`Generate Evaluator`}),` button.\nTo enable the button, map the column you want to evaluate (such as an LLM response) and add any additional data columns required for prompt creation.\nDescribe the evaluator’s purpose and reference the relevant data columns in the description.`]}),`\n`,_jsx(_components.p,{children:`The system generates a prompt template that you can edit and customize as needed.`}),`\n`,_jsx(Heading,{level:`2`,id:`test-evaluator`,children:`Test Evaluator`}),`\n`,_jsx(_components.p,{children:`Before creating an evaluator, you can test it on existing Playground data.\nThis allows you to refine and correct the evaluator prompt before saving the final version.`}),`\n`,_jsx(Heading,{level:`2`,id:`execute-evaluator`,children:`Execute Evaluator`}),`\n`,_jsxs(_components.p,{children:[`Evaluators can be executed in `,_jsx(_components.a,{href:`/playgrounds/columns/column-management`,children:`playground columns`}),` and in `,_jsx(_components.a,{href:`/experiments/running-from-code`,children:`experiments through the SDK`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`create-via-api`,children:`Create via API`}),`\n`,_jsx(_components.p,{children:`You can programmatically create custom LLM-as-a-judge evaluators using the API.`}),`\n`,_jsx(CodeBlock,{numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`POST /v2/evaluators/custom-evaluator`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsxs(_components.p,{children:[`See the full `,_jsx(_components.a,{href:`/api-reference/evaluators/create-custom-evaluator`,children:`API reference`}),` for detailed parameter documentation.`]})]})}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":"Custom Evaluators","description":"Define an evaluator for your specific needs ","href":"/evaluators/custom-evaluator"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Do It Yourself","slug":"do-it-yourself","depth":2,"children":[]},{"title":"Generate Evaluator","slug":"generate-evaluator","depth":2,"children":[]},{"title":"Test Evaluator","slug":"test-evaluator","depth":2,"children":[]},{"title":"Execute Evaluator","slug":"execute-evaluator","depth":2,"children":[]},{"title":"Create via API","slug":"create-via-api","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/docs/_mintlify/custom/enrolla/99d79fc3a15df79c/vibekit.js","/docs/_mintlify/custom/enrolla/a052f9c2fb91f2bb/scripts/filter-openapi.js","/docs/_mintlify/custom/enrolla/f023a04dbd14c606/scripts/update-mint-navigation.js"],"dynamicCss":".mint-block {\n display: block\n}\n.mint-hidden {\n display: none\n}\n.dark\\:mint-block:is(.dark *) {\n display: block\n}\n.dark\\:mint-hidden:is(.dark *) {\n display: none\n}","subdomain":"enrolla","siteName":"traceloop","title":"Custom Evaluators - traceloop","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-02-04T15:36:49.115Z","originalFileLocation":"evaluators/custom-evaluator.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=\"dark\"}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=\"Define an evaluator for your specific needs\">\u003cmeta data-mint-head name=\"application-name\" content=\"traceloop\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/enrolla/c4jFPLhIQoqlp6LG/_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=\"/docs/mintlify-assets/_mintlify/favicons/enrolla/c4jFPLhIQoqlp6LG/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/enrolla/c4jFPLhIQoqlp6LG/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/enrolla/c4jFPLhIQoqlp6LG/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/enrolla/c4jFPLhIQoqlp6LG/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/enrolla/c4jFPLhIQoqlp6LG/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/enrolla/c4jFPLhIQoqlp6LG/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/enrolla/c4jFPLhIQoqlp6LG/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/enrolla/c4jFPLhIQoqlp6LG/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Custom Evaluators - traceloop\">\u003cmeta data-mint-head property=\"og:description\" content=\"Define an evaluator for your specific needs\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"traceloop\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://www.traceloop.com/docs/evaluators/custom-evaluator\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://enrolla.mintlify.app/_mintlify/api/og/v2?division=Evaluators\u0026amp;title=Custom+Evaluators\u0026amp;description=Define+an+evaluator+for+your+specific+needs+\u0026amp;theme=ff62921debafe09ea1aaaffe\u0026amp;signature=7a332ee85eba88b46ec8c39bb5348b1a80d36250aa45d292af960533e0c89016\">\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=\"Custom Evaluators - traceloop\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Define an evaluator for your specific needs\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://enrolla.mintlify.app/_mintlify/api/og/v2?division=Evaluators\u0026amp;title=Custom+Evaluators\u0026amp;description=Define+an+evaluator+for+your+specific+needs+\u0026amp;theme=ff62921debafe09ea1aaaffe\u0026amp;signature=7a332ee85eba88b46ec8c39bb5348b1a80d36250aa45d292af960533e0c89016\">\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=\"/docs/mintlify-assets/_mintlify/favicons/enrolla/c4jFPLhIQoqlp6LG/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"traceloop\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#EAB308\">\u003clink data-mint-head rel=\"canonical\" href=\"https://www.traceloop.com/docs/evaluators/custom-evaluator\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/evaluators/custom-evaluator.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://www.traceloop.com/#organization\",\"name\":\"traceloop\",\"url\":\"https://www.traceloop.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/enrolla/GspX1ocwd1gETLy0/logo/traceloop-light.png?fit=max\u0026auto=format\u0026n=GspX1ocwd1gETLy0\u0026q=85\u0026s=e245f77b5b8af11ef9aa4a0ce2ee97a6\"}},{\"@type\":\"WebSite\",\"@id\":\"https://www.traceloop.com/docs#website\",\"name\":\"traceloop\",\"url\":\"https://www.traceloop.com/docs\",\"publisher\":{\"@id\":\"https://www.traceloop.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://www.traceloop.com/docs/evaluators/custom-evaluator#webpage\",\"url\":\"https://www.traceloop.com/docs/evaluators/custom-evaluator\",\"name\":\"Custom Evaluators\",\"description\":\"Define an evaluator for your specific needs\",\"dateModified\":\"2026-02-04T15:36:49.115Z\",\"isPartOf\":{\"@id\":\"https://www.traceloop.com/docs#website\"},\"breadcrumb\":{\"@id\":\"https://www.traceloop.com/docs/evaluators/custom-evaluator#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://www.traceloop.com/docs/evaluators/custom-evaluator#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Evaluators\",\"item\":\"https://www.traceloop.com/docs/evaluators/intro\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Custom Evaluators\",\"item\":\"https://www.traceloop.com/docs/evaluators/custom-evaluator\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://www.traceloop.com/docs/evaluators/custom-evaluator#article\",\"headline\":\"Custom Evaluators\",\"name\":\"Custom Evaluators\",\"description\":\"Define an evaluator for your specific needs\",\"url\":\"https://www.traceloop.com/docs/evaluators/custom-evaluator\",\"mainEntityOfPage\":{\"@id\":\"https://www.traceloop.com/docs/evaluators/custom-evaluator#webpage\"},\"dateModified\":\"2026-02-04T15:36:49.115Z\",\"publisher\":{\"@id\":\"https://www.traceloop.com/#organization\"},\"isPartOf\":{\"@id\":\"https://www.traceloop.com/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"traceloop\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"traceloop","nav":{"global":null,"anchors":[{"anchor":"Documentation","icon":"book-open","groups":[{"group":"Learn","pages":[{"title":"Introduction","href":"/introduction"}]},{"group":"Self-host","pages":[{"title":"Self-Hosting Overview","href":"/self-host/introduction"},{"title":"Hybrid Deployment","href":"/self-host/hybrid-deployment"},{"title":"Full Platform Self-Hosting","href":"/self-host/full-deployment"},{"title":"Troubleshooting Guide","href":"/self-host/troubleshooting"}]},{"group":"Datasets","pages":[{"title":"Quick Start","href":"/datasets/quick-start"},{"title":"SDK usage","href":"/datasets/sdk-usage"}]},{"group":"Playgrounds","pages":[{"title":"Quick Start","href":"/playgrounds/quick-start"},{"group":"Columns","pages":[{"title":"Data Columns","href":"/playgrounds/columns/data-columns"},{"title":"Prompt Column","href":"/playgrounds/columns/prompt"},{"title":"Column Management","href":"/playgrounds/columns/column-management"}]}]},{"group":"Evaluators","pages":[{"title":"Introduction","href":"/evaluators/intro"},{"title":"Guardrails","description":"Real-time evaluation and safety checks for LLM applications","href":"/evaluators/guardrails"},{"title":"Custom Evaluators","href":"/evaluators/custom-evaluator"},{"title":"Made by Traceloop","description":"Pre-configured evaluators by Traceloop for common assessment tasks","href":"/evaluators/made-by-traceloop"},{"title":"Evaluator Slugs","href":"/evaluators/evaluator-slugs"}]},{"group":"Experiments","pages":[{"title":"Introduction","href":"/experiments/introduction"},{"title":"Result Overview","href":"/experiments/result-overview"},{"title":"Run via SDK","href":"/experiments/running-from-code"}]},{"group":"Monitoring","pages":[{"title":"Introduction","href":"/monitoring/introduction"},{"title":"Defining Monitors","href":"/monitoring/defining-monitors"},{"title":"Using Monitors","href":"/monitoring/using-monitors"}]},{"group":"Prompt Management","pages":[{"title":"Quick Start","href":"/prompts/quick-start"},{"title":"Prompt Registry","href":"/prompts/registry"},{"title":"Fetching Prompts","href":"/prompts/sdk-usage"}]},{"group":"Settings","pages":[{"title":"Managing API Keys","href":"/settings/managing-api-keys"},{"title":"Projects and Environments","href":"/settings/projects-and-environments"}]},{"group":"Integrations","pages":[{"title":"Posthog","href":"/integrations/posthog"},{"title":"Slack","href":"/integrations/slack"},{"title":"GitHub","href":"/integrations/github"}]}]},{"anchor":"OpenLLMetry","icon":"telescope","pages":[{"title":"OpenLLMetry","href":"/openllmetry/introduction"}]},{"anchor":"Hub","icon":"arrows-to-dot","pages":[{"title":"Hub","href":"/hub/getting-started"}]},{"anchor":"Dashboard API","icon":"webhook","pages":[{"title":"Dashboard API","href":"/api-reference/introduction"}]},{"anchor":"Community","href":"https://traceloop.com/slack","icon":"slack"},{"anchor":"GitHub","href":"https://github.com/traceloop","icon":"github"}]},"title":"Custom Evaluators - traceloop","buildId":"dpl_GvhK4qVXq51DpfYJLCtPpYNN4YHN","deploymentId":"dpl_GvhK4qVXq51DpfYJLCtPpYNN4YHN","dynamics":["07c022d89b","a74be98ba7"],"chunks":["Frame-5VlDM5Io.js","DynamicMarkdown-DO1Fz7ar.js","zoom-image-lightbox-uyuQJRFs.js","lightbox-handle-r17bVUz3.js"]}