Recurso de REST: projects.locations.studies.trials

Recurso: Prueba

Un mensaje que representa una prueba.

Representación JSON 

{
  "name": string,
  "state": enum (State),
  "parameters": [
    {
      object (Parameter)
    }
  ],
  "finalMeasurement": {
    object (Measurement)
  },
  "measurements": [
    {
      object (Measurement)
    }
  ],
  "startTime": string,
  "endTime": string,
  "clientId": string,
  "trialInfeasible": boolean,
  "infeasibleReason": string
}
Campos
name

string

Solo salida. Nombre de la prueba asignada por el servicio.
state

enum (State)

El estado detallado de una prueba.
parameters[]

object (Parameter)

Los parámetros de la prueba.
finalMeasurement

object (Measurement)

La medida final que contiene el valor objetivo.
measurements[]

object (Measurement)

Lista de medidas lexicográficamente ordenadas de manera estricta por sus tuplas inducidas (steps, elapsedTime). Se usan para detener los cálculos con anticipación.
startTime

string (Timestamp format)

Solo salida. Hora a la que se inició la prueba.
endTime

string (Timestamp format)

Solo salida. Hora en la que el estado del período de prueba cambió a COMPLETED.
clientId

string

Solo salida. El identificador del cliente que en un principio solicitó esta prueba.
trialInfeasible

boolean

Solo salida. Si es verdadero, los parámetros de esta prueba no se vuelven a intentar.
infeasibleReason

string

Solo salida. Una string legible que describe por qué la prueba es inviable. Solo se debe establecer si trialInfeasible es verdadera.

Estado

Describe el estado de prueba.

Enums
STATE_UNSPECIFIED El estado de prueba no está especificado.
REQUESTED Indica que se solicitó una prueba específica, pero el servicio aún no la ha sugerido.
ACTIVE Indica que se sugirió la prueba.
COMPLETED Indica que la prueba finalizó y que tiene configurada una finalMeasurement, o que está marcada como trialInfeasible.
STOPPING Indica que la prueba debe detenerse según el servicio.

Parámetro

Un mensaje que representa un parámetro para ajustar. Contiene el nombre del parámetro y el valor sugerido para usar en esta prueba.

Representación JSON 

{
  "parameter": string,

  // Union field value can be only one of the following:
  "floatValue": number,
  "intValue": string,
  "stringValue": string
  // End of list of possible types for union field value.
}
Campos
parameter

string

El nombre del parámetro.
Campo de unión value. El valor del parámetro. value puede ser solo uno de los siguientes:
floatValue

number

Se debe configurar si ParameterType es DOUBLE o DISCRETE.
intValue

string (int64 format)

Debe configurarse si ParameterType es INTEGER.
stringValue

string

Debe configurarse si ParameterType es CATEGORICAL

Medida

Un mensaje que representa una medida.

Representación JSON 

{
  "elapsedTime": string,
  "stepCount": string,
  "metrics": [
    {
      object (Metric)
    }
  ]
}
Campos
elapsedTime

string (Duration format)

Solo salida. Tiempo durante el que se ejecutó la prueba al momento de esta medida.
stepCount

string (int64 format)

La cantidad de pasos para los que se entrenó un modelo de aprendizaje automático. No debe ser un valor negativo.
metrics[]

object (Metric)

Proporciona una lista de métricas que actúan como entradas en la función objetivo.

Métrica

Un mensaje que representa una métrica en la medida.

Representación JSON 

{
  "metric": string,
  "value": number
}
Campos
metric

string

Obligatorio. Nombre de la métrica.
value

number

Obligatorio. El valor de esta métrica.

Métodos

addMeasurement

 Agrega una medida de las métricas de objetivo a una prueba.

checkEarlyStoppingState

 Verifica si una prueba debe detenerse o no.

complete

 Marca una prueba como completa.

create

 Agrega una prueba proporcionada por el usuario a un estudio.

delete

 Borra una prueba.

get

 Obtiene una prueba.

list

 Enumera las pruebas asociadas con un estudio.

stop

 Detiene una prueba.

suggest

 Agrega una o más pruebas a un estudio, con valores del parámetro sugeridos por AI Platform Optimizer.