EvaluatorGenerationJob interface

Recurso de Generación de Trabajos de Evaluador — un trabajo de larga duración que genera definiciones de evaluadores basadas en rúbricas a partir de materiales fuente. En caso de éxito, el resultado es la EvaluatorVersion persistida.

Propiedades

created_at

La marca de tiempo en la que se creó el trabajo, representada en tiempo Unix (segundos desde el 1 de enero de 1970).

error

Detalles del error — que solo se llenan en caso de fallo.

evaluator_description

Descripción opcional amigable para el humano del evaluador resultante. Apareció como EvaluatorVersion.description en el evaluador persistente. Normalmente se recoge de la interfaz junto con evaluator_display_name. El evaluator_ prefijo desambigua esto de cualquier otro campo de descripción en modelos relacionados.

evaluator_display_name

Nombre de visualización opcional para el evaluador resultante. Apareció como EvaluatorVersion.display_name en el evaluador persistente. Cuando se omite, el servicio utiliza evaluator_name como nombre de visualización. El evaluator_ prefijo desambigua esto del identificador inmutable evaluator_name .

evaluator_name

El nombre del evaluador (identificador inmutable). 1-256 caracteres; los caracteres permitidos son las letras ASCII, los dígitos, el guion (_), el punto (.), la tilde (~) y el guion (-). El prefijo builtin. está reservado para evaluadores gestionados por sistemas y es rechazado por el servicio. Si un evaluador con este nombre ya existe en el proyecto (y es subtipo de rúbrica), el servicio crea una nueva versión bajo el mismo nombre y utiliza las versiones dimensions anteriores como contexto para mejoras incrementales (base del bucle adaptativo post//build). Las versiones antiguas siguen siendo consultables mediante get_version(name, version). Si el evaluador existente no es un evaluador de subtipo de rúbrica (incorporado, basado en prompts, basado en código), la solicitud se rechaza con 400 Bad Request.

finished_at

La marca de tiempo cuando terminaba el trabajo, representada en tiempo Unix (segundos desde el 1 de enero de 1970).

id

Identificador único asignado por el servidor.

input_quality_warnings

Avisos de calidad de insumos no fatales producidos por la cadena de generación. Solo lectura; generados por servicio; se ocupaba solo en trabajos terminales cuando se activaban los avisos. Omitido cuando la generación era limpia. Se elimina cuando un par posterior PATCHEvaluatorVersion.definition invalida los avisos.

model

El modelo LLM para usar en la generación de rúbricas (por ejemplo, 'gpt-4o'). Obligatorio — los usuarios deben proporcionar su propio modelo en lugar de depender de la capacidad propiedad del servicio.

result

Resultado producido con éxito.

sources

Materiales fuente para la generación — descripciones de agentes, prompts, trazas o conjuntos de datos. Cada entrada es una EvaluatorGenerationJobSource variante discriminada por type.

status

Estado actual del ciclo de vida.

usage

Resumen del consumo de tokens. Se llena cuando el trabajo alcanza un estado terminal.

Detalles de las propiedades

created_at

La marca de tiempo en la que se creó el trabajo, representada en tiempo Unix (segundos desde el 1 de enero de 1970).

created_at?: Date

Valor de propiedad

Date

error

Detalles del error — que solo se llenan en caso de fallo.

error?: ErrorModel

Valor de propiedad

evaluator_description

Descripción opcional amigable para el humano del evaluador resultante. Apareció como EvaluatorVersion.description en el evaluador persistente. Normalmente se recoge de la interfaz junto con evaluator_display_name. El evaluator_ prefijo desambigua esto de cualquier otro campo de descripción en modelos relacionados.

evaluator_description?: string

Valor de propiedad

string

evaluator_display_name

Nombre de visualización opcional para el evaluador resultante. Apareció como EvaluatorVersion.display_name en el evaluador persistente. Cuando se omite, el servicio utiliza evaluator_name como nombre de visualización. El evaluator_ prefijo desambigua esto del identificador inmutable evaluator_name .

evaluator_display_name?: string

Valor de propiedad

string

evaluator_name

El nombre del evaluador (identificador inmutable). 1-256 caracteres; los caracteres permitidos son las letras ASCII, los dígitos, el guion (_), el punto (.), la tilde (~) y el guion (-). El prefijo builtin. está reservado para evaluadores gestionados por sistemas y es rechazado por el servicio. Si un evaluador con este nombre ya existe en el proyecto (y es subtipo de rúbrica), el servicio crea una nueva versión bajo el mismo nombre y utiliza las versiones dimensions anteriores como contexto para mejoras incrementales (base del bucle adaptativo post//build). Las versiones antiguas siguen siendo consultables mediante get_version(name, version). Si el evaluador existente no es un evaluador de subtipo de rúbrica (incorporado, basado en prompts, basado en código), la solicitud se rechaza con 400 Bad Request.

evaluator_name: string

Valor de propiedad

string

finished_at

La marca de tiempo cuando terminaba el trabajo, representada en tiempo Unix (segundos desde el 1 de enero de 1970).

finished_at?: Date

Valor de propiedad

Date

id

Identificador único asignado por el servidor.

id?: string

Valor de propiedad

string

input_quality_warnings

Avisos de calidad de insumos no fatales producidos por la cadena de generación. Solo lectura; generados por servicio; se ocupaba solo en trabajos terminales cuando se activaban los avisos. Omitido cuando la generación era limpia. Se elimina cuando un par posterior PATCHEvaluatorVersion.definition invalida los avisos.

input_quality_warnings?: RubricGenerationInputQualityWarning[]

Valor de propiedad

model

El modelo LLM para usar en la generación de rúbricas (por ejemplo, 'gpt-4o'). Obligatorio — los usuarios deben proporcionar su propio modelo en lugar de depender de la capacidad propiedad del servicio.

model: string

Valor de propiedad

string

result

Resultado producido con éxito.

result?: EvaluatorVersion

Valor de propiedad

sources

Materiales fuente para la generación — descripciones de agentes, prompts, trazas o conjuntos de datos. Cada entrada es una EvaluatorGenerationJobSource variante discriminada por type.

sources: EvaluatorGenerationJobSourceUnion[]

Valor de propiedad

status

Estado actual del ciclo de vida.

status?: JobStatus

Valor de propiedad

usage

Resumen del consumo de tokens. Se llena cuando el trabajo alcanza un estado terminal.

usage?: EvaluatorGenerationTokenUsage

Valor de propiedad