REST Resource: tunedModels

Ressource: TunedModel

Ein abgestimmtes Modell, das mit ModelService.CreateTunedModel erstellt wurde.

JSON-Darstellung
{
  "name": string,
  "displayName": string,
  "description": string,
  "state": enum (State),
  "createTime": string,
  "updateTime": string,
  "tuningTask": {
    object (TuningTask)
  },

  // Union field source_model can be only one of the following:
  "tunedModelSource": {
    object (TunedModelSource)
  },
  "baseModel": string
  // End of list of possible types for union field source_model.
  "temperature": number,
  "topP": number,
  "topK": integer
}
Felder
name

string

Nur Ausgabe Der Name des abgestimmten Modells. Bei der Erstellung wird ein eindeutiger Name generiert. Beispiel: tunedModels/az2mb0bpw6i Wenn „displayName“ beim Erstellen festgelegt wird, wird der ID-Teil des Namens festgelegt, indem die Wörter des displayName mit Bindestrichen verkettet und durch Hinzufügen eines zufälligen Teils zur Eindeutigkeit hinzugefügt werden. Beispiel: displayName = "Sentence Translator" name = "tunedModels/sentence-translator-u3b7m"

displayName

string

Optional. Der Name, der für dieses Modell auf der Benutzeroberfläche angezeigt werden soll. Der Anzeigename darf einschließlich Leerzeichen maximal 40 Zeichen lang sein.

description

string

Optional. Eine kurze Beschreibung dieses Modells.

state

enum (State)

Nur Ausgabe Der Status des abgestimmten Modells.

createTime

string (Timestamp format)

Nur Ausgabe Der Zeitstempel für den Zeitpunkt, zu dem dieses Modell erstellt wurde.

Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".

updateTime

string (Timestamp format)

Nur Ausgabe Der Zeitstempel für den Zeitpunkt, zu dem dieses Modell aktualisiert wurde.

Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".

tuningTask

object (TuningTask)

Erforderlich. Die Abstimmungsaufgabe, mit der das abgestimmte Modell erstellt wird.

Union-Feld source_model. Das Modell, das als Ausgangspunkt für die Abstimmung verwendet wird. Für source_model ist nur einer der folgenden Werte zulässig:
tunedModelSource

object (TunedModelSource)

Optional. TunedModel, das als Ausgangspunkt zum Trainieren des neuen Modells verwendet werden soll.

baseModel

string

Nicht veränderbar. Der Name des abzustimmenden Model. Beispiel: models/text-bison-001

temperature

number

Optional. Steuert die Zufälligkeit der Ausgabe.

Werte können über [0.0,1.0] (einschließlich) liegen. Ein Wert, der näher an 1.0 liegt, führt zu vielfältigeren Antworten, während ein Wert näher an 0.0 zu weniger überraschenden Antworten des Modells führt.

Mit diesem Wert wird der Standardwert angegeben, der vom Basismodell beim Erstellen des Modells verwendet wird.

topP

number

Optional. Für Nucleus-Proben.

Bei der Nucleus-Stichprobe werden die kleinsten Tokens berücksichtigt, deren Wahrscheinlichkeitssumme mindestens topP beträgt.

Mit diesem Wert wird der Standardwert angegeben, der vom Basismodell beim Erstellen des Modells verwendet wird.

topK

integer

Optional. Für Top-K-Stichproben.

Bei der Top-K-Stichprobe wird die Gruppe der topK wahrscheinlichsten Tokens berücksichtigt. Mit diesem Wert wird angegeben, dass er beim Aufruf des Modells standardmäßig vom Back-End verwendet wird.

Mit diesem Wert wird der Standardwert angegeben, der vom Basismodell beim Erstellen des Modells verwendet wird.

TunedModelSource

Abgestimmtes Modell als Quelle zum Trainieren eines neuen Modells.

JSON-Darstellung
{
  "tunedModel": string,
  "baseModel": string
}
Felder
tunedModel

string

Nicht veränderbar. Der Name des TunedModel, der als Ausgangspunkt für das Training des neuen Modells verwendet werden soll. Beispiel: tunedModels/my-tuned-model

baseModel

string

Nur Ausgabe Der Name der Basis-Model, von der diese TunedModel abgestimmt wurde. Beispiel: models/text-bison-001

Status

Der Status des abgestimmten Modells.

Enums
STATE_UNSPECIFIED Der Standardwert. Dieser Wert wird nicht verwendet.
CREATING Das Modell wird erstellt.
ACTIVE Das Modell ist einsatzbereit.
FAILED Das Modell konnte nicht erstellt werden.

TuningTask

Abstimmungsaufgaben, die abgestimmte Modelle erstellen.

JSON-Darstellung
{
  "startTime": string,
  "completeTime": string,
  "snapshots": [
    {
      object (TuningSnapshot)
    }
  ],
  "trainingData": {
    object (Dataset)
  },
  "hyperparameters": {
    object (Hyperparameters)
  }
}
Felder
startTime

string (Timestamp format)

Nur Ausgabe Der Zeitstempel für den Start der Abstimmung dieses Modells.

Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".

completeTime

string (Timestamp format)

Nur Ausgabe Der Zeitstempel für den Abschluss der Abstimmung dieses Modells.

Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".

snapshots[]

object (TuningSnapshot)

Nur Ausgabe Während der Abstimmung erfasste Messwerte.

trainingData

object (Dataset)

Erforderlich. Nur Eingabe. Nicht veränderbar. Die Modelltrainingsdaten.

hyperparameters

object (Hyperparameters)

Nicht veränderbar. Hyperparameter, die den Abstimmungsprozess steuern. Wenn nicht angegeben, werden Standardwerte verwendet.

TuningSnapshot

Aufzeichnung für einen einzelnen Abstimmungsschritt.

JSON-Darstellung
{
  "step": integer,
  "epoch": integer,
  "meanLoss": number,
  "computeTime": string
}
Felder
step

integer

Nur Ausgabe Der Schritt der Abstimmung.

epoch

integer

Nur Ausgabe Die Epoche, zu der dieser Schritt gehörte.

meanLoss

number

Nur Ausgabe Der mittlere Verlust der Trainingsbeispiele für diesen Schritt.

computeTime

string (Timestamp format)

Nur Ausgabe Der Zeitstempel für den Zeitpunkt, zu dem dieser Messwert berechnet wurde.

Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".

Dataset

Dataset für Training oder Validierung.

JSON-Darstellung
{

  // Union field dataset can be only one of the following:
  "examples": {
    object (TuningExamples)
  }
  // End of list of possible types for union field dataset.
}
Felder
Union-Feld dataset. Inline-Daten oder ein Verweis auf die Daten. Für dataset ist nur einer der folgenden Werte zulässig:
examples

object (TuningExamples)

Optional. Inline-Beispiele

TuningExamples

Eine Reihe von Abstimmungsbeispielen. Dies können Trainings- oder Validierungsdaten sein.

JSON-Darstellung
{
  "examples": [
    {
      object (TuningExample)
    }
  ]
}
Felder
examples[]

object (TuningExample)

Erforderlich. Die Beispiele. Die Beispieleingabe kann „Text“ oder „Diskussion“ sein. Alle Beispiele in einem Satz müssen jedoch vom gleichen Typ sein.

TuningExample

Ein einzelnes Beispiel für die Feinabstimmung.

JSON-Darstellung
{
  "output": string,

  // Union field model_input can be only one of the following:
  "textInput": string
  // End of list of possible types for union field model_input.
}
Felder
output

string

Erforderlich. Die erwartete Modellausgabe.

Union-Feld model_input. Die Eingabe für das Modell in diesem Beispiel. Für model_input ist nur einer der folgenden Werte zulässig:
textInput

string

Optional. Textmodelleingabe.

Hyperparameter

Hyperparameter, die den Abstimmungsprozess steuern. Weitere Informationen finden Sie unter https://ai.google.dev/docs/model_tuning_guidance.

JSON-Darstellung
{

  // Union field learning_rate_option can be only one of the following:
  "learningRate": number,
  "learningRateMultiplier": number
  // End of list of possible types for union field learning_rate_option.
  "epochCount": integer,
  "batchSize": integer
}
Felder
Union-Feld learning_rate_option. Optionen zum Angeben der Lernrate während der Feinabstimmung. Für learning_rate_option ist nur einer der folgenden Werte zulässig:
learningRate

number

Optional. Nicht veränderbar. Der Lernraten-Hyperparameter für die Abstimmung. Wenn nichts festgelegt ist, wird basierend auf der Anzahl der Trainingsbeispiele ein Standardwert von 0,001 oder 0,0002 berechnet.

learningRateMultiplier

number

Optional. Nicht veränderbar. Der Lernratenmultiplikator wird verwendet, um eine endgültige learningRate auf der Grundlage des Standardwerts (empfohlen) zu berechnen. Tatsächliche Lernrate := learningRateMultiplikator * Standard-Lernrate Die Standardlernrate ist abhängig von der Größe des Basismodells und der Datenmenge. Wenn die Richtlinie nicht konfiguriert ist, wird der Standardwert „1,0“ verwendet.

epochCount

integer

Nicht veränderbar. Die Anzahl der Trainingsphasen. Eine Epoche ist ein Durchlauf der Trainingsdaten. Wenn die Richtlinie nicht konfiguriert ist, wird der Standardwert 5 verwendet.

batchSize

integer

Nicht veränderbar. Der Batchgrößen-Hyperparameter für die Abstimmung. Wenn nichts festgelegt ist, wird je nach Anzahl der Trainingsbeispiele ein Standardwert von 4 oder 16 verwendet.

Methoden

create

Erstellt ein abgestimmtes Modell.

delete

Löscht ein abgestimmtes Modell.

generateContent

Generiert eine Antwort vom Modell auf Basis einer GenerateContentRequest-Eingabe.

generateText

Generiert eine Antwort vom Modell auf eine Eingabenachricht.

get

Ruft Informationen zu einem bestimmten TunedModel ab.

list

Listet abgestimmte Modelle auf, die dem Nutzer gehören.

patch

Aktualisiert ein abgestimmtes Modell.

transferOwnership

Überträgt die Eigentümerschaft des abgestimmten Modells.