Skip to main content
The eval evaluator command group manages evaluators: browse built-in templates, list and show existing evaluators, create evaluators, update TEA drafts, submit TEA versions, and delete evaluators. An evaluator is typically a rubric prompt backed by a judge model; it receives input fields and produces a score or distribution.
--project applies only to the Coze evaluation backend; the TEA backend ignores it. TEA version commands are available only on the TEA evaluation backend.

evaluator template list

List built-in evaluator templates. evaluator templates is a compatibility entry point equivalent to evaluator template list.

evaluator template show

Show a built-in evaluator template, including its prompt and input fields.

evaluator list

List evaluators in the current project or workspace.

evaluator show

Show an evaluator’s details: rubric prompt, model configuration, and input fields. On TEA, you can select a specific evaluator version.

evaluator create

Create an evaluator. You can clone rubric and input schema from a built-in template, or define the evaluator with a custom prompt file. On Coze, provide at least one of --from-template or --prompt-file. On TEA, you can create from a template or from a custom prompt and input fields.
Reference input fields in the prompt with placeholders like , , and ; these field names are the evaluator’s input schema and are mapped automatically during eval run.

evaluator update-draft

Update a TEA evaluator draft. When --evaluator-content-file is passed, that JSON file is used as the complete evaluator content and overrides --prompt-file, --model, and --input-schemas-json.
evaluator update-draft is supported only on the TEA evaluation backend.

evaluator version list

List TEA evaluator versions.

evaluator version submit

Submit a TEA evaluator draft as a version.

evaluator delete

Delete an evaluator. (Alias: rm)
This command deletes the evaluator. Check the target first; the CLI prompts for confirmation unless you pass --yes.
Last modified on September 19, 2026