EvaluatorGenerationJob interface

Recurso de Geração de Avaliação — um trabalho de longa duração que gera definições de avaliadores baseadas em rubricas a partir dos materiais fonte. Em caso de sucesso, o resultado é a persistência do EvaluatorVersion.

Propriedades

created_at

O carimbo de data e hora em que o trabalho foi criado, representado em tempo Unix (segundos desde 1º de janeiro de 1970).

error

Detalhes do erro — preenchidos apenas em caso de falha.

evaluator_description

Descrição opcional para o avaliador resultante. Surgiu como EvaluatorVersion.description no avaliador persistente. Normalmente coletado da interface junto com evaluator_display_nameo arquivo . O evaluator_ prefixo desambigua isso de quaisquer outros campos de descrição em modelos relacionados.

evaluator_display_name

Nome de exibição opcional e amigável para o avaliador resultante. Surgiu como EvaluatorVersion.display_name no avaliador persistente. Quando omitido, o serviço é usado evaluator_name como nome de exibição. O evaluator_ prefixo desambigua isso do identificador imutável evaluator_name .

evaluator_name

O nome do avaliador (identificador imutável). 1-256 caracteres; caracteres permitidos são letras ASCII, dígitos, sublinhado (_), ponto (.), tilde (~) e hífen (-). O prefixo builtin. é reservado para avaliadores gerenciados pelo sistema e é rejeitado pelo serviço. Se um avaliador com esse nome já existir no projeto (e for subtipo de rubrica), o serviço cria uma nova versão com o mesmo nome e usa as versões dimensions anteriores como contexto para melhorias incrementais (base do ciclo adaptativo pós-//build). Versões antigas permanecem consultáveis via get_version(name, version). Se o avaliador existente não for um avaliador de subtipo de rubrica (embutido, baseado em prompt, baseado em código), a solicitação é rejeitada com 400 Bad Request.

finished_at

O carimbo de data e hora quando o trabalho terminou, representado em tempo Unix (segundos desde 1º de janeiro de 1970).

id

Identificador único atribuído pelo servidor.

input_quality_warnings

Avisos de qualidade de entrada não fatais produzidos pelo pipeline de geração. Somente leitura; gerado por serviço; preenchidos apenas em trabalhos terminais quando os avisos eram disparados. Omitido quando a geração estava limpa. É liberado quando um par subsequente PATCHEvaluatorVersion.definition invalida os avisos.

model

O modelo LLM a ser usado para geração de rubricas (por exemplo, 'gpt-4o'). Obrigatório — os usuários devem fornecer seu próprio modelo em vez de depender da capacidade detida pelo serviço.

result

Resultado obtido com sucesso.

sources

Materiais de origem para geração — descrições de agentes, prompts, rastreios ou conjuntos de dados. Cada entrada é uma EvaluatorGenerationJobSource variante discriminada por type.

status

Status atual do ciclo de vida.

usage

Resumo do consumo de tokens. Preenchido quando o trabalho atinge um estado terminal.

Detalhes da propriedade

created_at

O carimbo de data e hora em que o trabalho foi criado, representado em tempo Unix (segundos desde 1º de janeiro de 1970).

created_at?: Date

Valor da propriedade

Date

error

Detalhes do erro — preenchidos apenas em caso de falha.

error?: ErrorModel

Valor da propriedade

evaluator_description

Descrição opcional para o avaliador resultante. Surgiu como EvaluatorVersion.description no avaliador persistente. Normalmente coletado da interface junto com evaluator_display_nameo arquivo . O evaluator_ prefixo desambigua isso de quaisquer outros campos de descrição em modelos relacionados.

evaluator_description?: string

Valor da propriedade

string

evaluator_display_name

Nome de exibição opcional e amigável para o avaliador resultante. Surgiu como EvaluatorVersion.display_name no avaliador persistente. Quando omitido, o serviço é usado evaluator_name como nome de exibição. O evaluator_ prefixo desambigua isso do identificador imutável evaluator_name .

evaluator_display_name?: string

Valor da propriedade

string

evaluator_name

O nome do avaliador (identificador imutável). 1-256 caracteres; caracteres permitidos são letras ASCII, dígitos, sublinhado (_), ponto (.), tilde (~) e hífen (-). O prefixo builtin. é reservado para avaliadores gerenciados pelo sistema e é rejeitado pelo serviço. Se um avaliador com esse nome já existir no projeto (e for subtipo de rubrica), o serviço cria uma nova versão com o mesmo nome e usa as versões dimensions anteriores como contexto para melhorias incrementais (base do ciclo adaptativo pós-//build). Versões antigas permanecem consultáveis via get_version(name, version). Se o avaliador existente não for um avaliador de subtipo de rubrica (embutido, baseado em prompt, baseado em código), a solicitação é rejeitada com 400 Bad Request.

evaluator_name: string

Valor da propriedade

string

finished_at

O carimbo de data e hora quando o trabalho terminou, representado em tempo Unix (segundos desde 1º de janeiro de 1970).

finished_at?: Date

Valor da propriedade

Date

id

Identificador único atribuído pelo servidor.

id?: string

Valor da propriedade

string

input_quality_warnings

Avisos de qualidade de entrada não fatais produzidos pelo pipeline de geração. Somente leitura; gerado por serviço; preenchidos apenas em trabalhos terminais quando os avisos eram disparados. Omitido quando a geração estava limpa. É liberado quando um par subsequente PATCHEvaluatorVersion.definition invalida os avisos.

input_quality_warnings?: RubricGenerationInputQualityWarning[]

Valor da propriedade

model

O modelo LLM a ser usado para geração de rubricas (por exemplo, 'gpt-4o'). Obrigatório — os usuários devem fornecer seu próprio modelo em vez de depender da capacidade detida pelo serviço.

model: string

Valor da propriedade

string

result

Resultado obtido com sucesso.

result?: EvaluatorVersion

Valor da propriedade

sources

Materiais de origem para geração — descrições de agentes, prompts, rastreios ou conjuntos de dados. Cada entrada é uma EvaluatorGenerationJobSource variante discriminada por type.

sources: EvaluatorGenerationJobSourceUnion[]

Valor da propriedade

status

Status atual do ciclo de vida.

status?: JobStatus

Valor da propriedade

usage

Resumo do consumo de tokens. Preenchido quando o trabalho atinge um estado terminal.

usage?: EvaluatorGenerationTokenUsage

Valor da propriedade