REST Resource: tunedModels

Recurso: TunedModel

Um modelo ajustado criado usando ModelService.CreateTunedModel.

Representação JSON
{
  "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
}
Campos
name

string

Apenas saída. O nome do modelo ajustado. Um nome exclusivo vai ser gerado na criação. Exemplo: tunedModels/az2mb0bpw6i se "displayName" for definido ao criar, a parte "id" do nome será definida concatenando as palavras de "displayName" com hifens e adicionando uma parte aleatória para exclusividade. Exemplo: displayName = "Sentence Tradutor" = "tunedModels/sentence-translator-u3b7m"

displayName

string

Opcional. O nome a ser exibido para este modelo nas interfaces do usuário. O nome de exibição precisa ter até 40 caracteres, incluindo espaços.

description

string

Opcional. Uma breve descrição deste modelo.

state

enum (State)

Apenas saída. O estado do modelo ajustado.

createTime

string (Timestamp format)

Apenas saída. O carimbo de data/hora em que esse modelo foi criado.

Um carimbo de data/hora no formato UTC "Zulu" RFC3339, com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

updateTime

string (Timestamp format)

Apenas saída. O carimbo de data/hora em que este modelo foi atualizado.

Um carimbo de data/hora no formato UTC "Zulu" RFC3339, com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

tuningTask

object (TuningTask)

Obrigatório. A tarefa de ajuste que cria o modelo ajustado.

Campo de união source_model. O modelo usado como ponto de partida para o ajuste. source_model pode ser apenas de um dos tipos a seguir:
tunedModelSource

object (TunedModelSource)

Opcional. TunedModel para usar como ponto de partida para treinar o novo modelo.

baseModel

string

Imutável. Nome do Model a ser ajustado. Exemplo: models/text-bison-001

temperature

number

Opcional. Controla a aleatoriedade da saída.

Os valores podem variar para mais de [0.0,1.0], inclusive. Um valor mais próximo de 1.0 produzirá respostas mais variadas, enquanto um valor mais próximo de 0.0 normalmente resultará em respostas menos surpreendentes do modelo.

Esse valor especifica que o padrão será usado pelo modelo base durante a criação dele.

topP

number

Opcional. Para amostragem Nucleus.

A amostragem Nucleus considera o menor conjunto de tokens cuja soma de probabilidade é de pelo menos topP.

Esse valor especifica que o padrão será usado pelo modelo base durante a criação dele.

topK

integer

Opcional. Para amostragem Top-k.

A amostragem top-k considera o conjunto de topK tokens mais prováveis. Esse valor especifica o padrão a ser usado pelo back-end ao fazer a chamada para o modelo.

Esse valor especifica que o padrão será usado pelo modelo base durante a criação dele.

TunedModelSource

Modelo ajustado como fonte para treinar um novo modelo.

Representação JSON
{
  "tunedModel": string,
  "baseModel": string
}
Campos
tunedModel

string

Imutável. O nome do TunedModel a ser usado como ponto de partida para treinar o novo modelo. Exemplo: tunedModels/my-tuned-model

baseModel

string

Apenas saída. O nome da base Model em que o TunedModel foi ajustado. Exemplo: models/text-bison-001

Estado

O estado do modelo ajustado.

Enums
STATE_UNSPECIFIED O valor padrão. Esse valor não é usado.
CREATING O modelo está sendo criado.
ACTIVE O modelo está pronto para ser usado.
FAILED Falha ao criar o modelo.

TuningTask

Tarefas de ajuste que criam modelos ajustados.

Representação JSON
{
  "startTime": string,
  "completeTime": string,
  "snapshots": [
    {
      object (TuningSnapshot)
    }
  ],
  "trainingData": {
    object (Dataset)
  },
  "hyperparameters": {
    object (Hyperparameters)
  }
}
Campos
startTime

string (Timestamp format)

Apenas saída. O carimbo de data/hora ao ajustar este modelo.

Um carimbo de data/hora no formato UTC "Zulu" RFC3339, com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

completeTime

string (Timestamp format)

Apenas saída. O carimbo de data/hora de conclusão do ajuste do modelo.

Um carimbo de data/hora no formato UTC "Zulu" RFC3339, com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

snapshots[]

object (TuningSnapshot)

Apenas saída. Métricas coletadas durante o ajuste.

trainingData

object (Dataset)

Obrigatório. Apenas entrada. Imutável. Os dados de treinamento do modelo.

hyperparameters

object (Hyperparameters)

Imutável. Hiperparâmetros que controlam o processo de ajuste. Se não for fornecido, os valores padrão serão usados.

TuningSnapshot

Registre uma única etapa de ajuste.

Representação JSON
{
  "step": integer,
  "epoch": integer,
  "meanLoss": number,
  "computeTime": string
}
Campos
step

integer

Apenas saída. A etapa de ajuste.

epoch

integer

Apenas saída. A época de que esta etapa fazia parte.

meanLoss

number

Apenas saída. Perda média dos exemplos de treinamento desta etapa.

computeTime

string (Timestamp format)

Apenas saída. O carimbo de data/hora em que essa métrica foi calculada.

Um carimbo de data/hora no formato UTC "Zulu" RFC3339, com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

Conjunto de dados

Conjunto de dados para treinamento ou validação.

Representação JSON
{

  // Union field dataset can be only one of the following:
  "examples": {
    object (TuningExamples)
  }
  // End of list of possible types for union field dataset.
}
Campos
Campo de união dataset. Dados inline ou uma referência aos dados. dataset pode ser apenas de um dos tipos a seguir:
examples

object (TuningExamples)

Opcional. Exemplos inline.

TuningExamples

Um conjunto de exemplos de ajuste. Podem ser dados de treinamento ou de validação.

Representação JSON
{
  "examples": [
    {
      object (TuningExample)
    }
  ]
}
Campos
examples[]

object (TuningExample)

Obrigatório. Os exemplos. A entrada de exemplo pode ser de texto ou discussão, mas todos os exemplos em um conjunto precisam ser do mesmo tipo.

TuningExample

Um único exemplo de ajuste.

Representação JSON
{
  "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.
}
Campos
output

string

Obrigatório. Saída do modelo esperada.

Campo de união model_input. A entrada para o modelo deste exemplo. model_input pode ser apenas de um dos tipos a seguir:
textInput

string

Opcional. Entrada do modelo de texto.

Hiperparâmetros

Hiperparâmetros que controlam o processo de ajuste. Leia mais em https://ai.google.dev/docs/model_tuning_guidance

Representação JSON
{

  // 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
}
Campos
Campo de união learning_rate_option. Opções para especificar a taxa de aprendizado durante o ajuste. learning_rate_option pode ser apenas de um dos tipos a seguir:
learningRate

number

Opcional. Imutável. O hiperparâmetro da taxa de aprendizado para ajuste. Se não for definido, um padrão de 0,001 ou 0,0002 será calculado com base no número de exemplos de treinamento.

learningRateMultiplier

number

Opcional. Imutável. O multiplicador da taxa de aprendizado é usado para calcular uma taxa de aprendizado final com base no valor padrão (recomendado). Taxa de aprendizado real := learningRateMultiplicador * padrão de taxa de aprendizado A taxa de aprendizado padrão depende do modelo base e do tamanho do conjunto de dados. Se não for definido, um padrão de 1.0 será usado.

epochCount

integer

Imutável. O número de períodos de treinamento. Um período é uma passagem pelos dados de treinamento. Se não for definido, um padrão de 5 será usado.

batchSize

integer

Imutável. O hiperparâmetro do tamanho do lote para ajuste. Se não for definido, um padrão de 4 ou 16 será usado com base no número de exemplos de treinamento.

Métodos

create

Cria um modelo ajustado.

delete

Exclui um modelo ajustado.

generateContent

Gera uma resposta do modelo com base em uma entrada GenerateContentRequest.

generateText

Gera uma resposta do modelo com base em uma mensagem de entrada.

get

Recebe informações sobre um TunedModel específico.

list

Lista os modelos ajustados pertencentes ao usuário.

patch

Atualiza um modelo ajustado.

transferOwnership

Transfere a propriedade do modelo ajustado.