KnowledgeEvaluation

An Evaluation of a Knowledge base version or of its working set (1.53.0): metrics, per-query ranks by id, the thresholds applied and the gate outcome. Immutable once final; never content.

An object with 20 fields.

Fields

Field	Type	Required	Description
`baseline`	KnowledgeEvaluationBaseline or null	yes	Null when no version is active or the active one has no completed Evaluation, so no relative check applied.
`corpus_sha256`	string	yes	The digest of the ids and revisions of the corpus queries it ran.
`created_at`	Timestamp	yes
`created_by`	ActorRef or null	yes	Who asked for it; null when an automatic publish ran it after a sync.
`error_code`	string or null	yes	Why it `failed`, such as `embedding_failed`; null otherwise.
`failing_checks`	array of KnowledgeGateCheck	yes	The checks the metrics fail, also when the outcome is advisory.
`finished_at`	Timestamp or null	yes
`gate`	KnowledgeGateOutcome or null	yes	`passed`, `failed` or `advisory` once `completed` (`knowledgeGateOutcome`); null before.
`id`	KnowledgeEvaluationId	yes
`job_id`	JobId	yes	The `knowledge.evaluation` job that runs it.
`knowledge_base_id`	KnowledgeBaseId	yes
`manifest_sha256`	string	yes	The digest of the Document revisions and configuration it searched; a publish compares it with the working set.
`metrics`	KnowledgeEvaluationMetrics or null	yes	Null until `completed`.
`object`	`"knowledge_evaluation"`	yes
`results`	array of KnowledgeEvalResult	yes
`started_at`	Timestamp or null	yes
`status`	KnowledgeEvaluationStatus	yes
`thresholds`	KnowledgeGateThresholds	yes
`top_k`	integer	yes
`version`	integer or null	yes	The version evaluated; null for the working set.

Used by

The operations whose parameters, request body or responses name this shape directly.