Method: projects.locations.collections.dataStores.customModels.list

Recupera un elenco di tutti i modelli personalizzati.

Richiesta HTTP

GET https://discoveryengine.googleapis.com/v1alpha/{dataStore=projects/*/locations/*/collections/*/dataStores/*}/customModels

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
dataStore

string

Obbligatorio. Il nome della risorsa del datastore padre, ad esempio projects/*/locations/global/collections/default_collection/dataStores/default_data_store. Questo campo viene utilizzato per identificare il datastore da cui recuperare i modelli.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

Messaggio di risposta per il metodo SearchTuningService.ListCustomModels.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "models": [
    {
      object (CustomTuningModel)
    }
  ]
}
Campi
models[]

object (CustomTuningModel)

Elenco dei modelli ottimizzati personalizzati.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/discoveryengine.readwrite

Per ulteriori informazioni, consulta Authentication Overview.

Autorizzazioni IAM

Richiede la seguente autorizzazione IAM per la risorsa dataStore:

  • discoveryengine.dataStores.listCustomModels

Per saperne di più, consulta la documentazione di IAM.

CustomTuningModel

Metadati che descrivono un modello personalizzato.

Rappresentazione JSON 
{
  "name": string,
  "displayName": string,
  "modelVersion": string,
  "modelState": enum (ModelState),
  "createTime": string,
  "trainingStartTime": string,
  "metrics": {
    string: number,
    ...
  },
  "errorMessage": string
}
Campi
name

string

Obbligatorio. Il nome risorsa completo del modello.

Formato: projects/{project}/locations/{location}/collections/{collection}/dataStores/{dataStore}/customTuningModels/{custom_tuning_model}.

Il modello deve essere una stringa alfanumerica con un limite di 40 caratteri.
displayName

string

Il nome visualizzato del modello.
modelVersion

string (int64 format)

La versione del modello.
modelState

enum (ModelState)

Lo stato in cui si trova il modello (ad es.TRAINING o TRAINING_FAILED).
createTime
(deprecated)

string (Timestamp format)

Obsoleto: timestamp della creazione del modello.

Utilizza RFC 3339, in cui l'output generato è sempre normalizzato in base al fuso orario UTC e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
trainingStartTime

string (Timestamp format)

Timestamp dell'avvio dell'addestramento del modello.

Utilizza RFC 3339, in cui l'output generato è sempre normalizzato in base al fuso orario UTC e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
metrics

map (key: string, value: number)

Le metriche del modello addestrato.
errorMessage

string

Al momento, questo campo viene compilato solo se lo stato del modello è INPUT_VALIDATION_FAILED.

ModelState

Lo stato del modello.

Enum
MODEL_STATE_UNSPECIFIED Valore predefinito.
TRAINING_PAUSED Il modello è in stato di addestramento in pausa.
TRAINING Il modello è attualmente in fase di addestramento.
TRAINING_COMPLETE L'addestramento del modello è stato completato.
READY_FOR_SERVING Il modello è pronto per la pubblicazione.
TRAINING_FAILED L'addestramento del modello non è riuscito.
NO_IMPROVEMENT L'addestramento del modello è stato completato correttamente, ma le metriche non sono migliorate.
INPUT_VALIDATION_FAILED La convalida dei dati di input non è riuscita. L'addestramento del modello non è stato avviato.