Copie um modelo no Registo de modelos do Vertex AI

A preparação dos seus modelos personalizados, grandes modelos e modelos do AutoML no Vertex AI ao nível pretendido requer tempo e experimentação. Se tiver um modelo com bom desempenho que queira usar noutro projeto ou localização, preparar um novo modelo não é a melhor opção. A preparação do modelo é de natureza não determinística. Por isso, é improvável que acabe com um modelo idêntico a partir de dados idênticos. Além disso, preparar um modelo em cada região ou projeto não é uma forma infalível de manter a consistência do comportamento do modelo entre regiões. Com o modelo de cópia do Registo de modelos do Vertex AI, pode copiar um modelo do Registo de modelos do Vertex AI para uma localização separada no mesmo projeto ou para um projeto diferente.

Quando faz uma cópia de um modelo, se não especificar a versão do modelo que quer copiar, é copiada a versão do modelo predefinida. Para saber mais acerca do modelo predefinido ou do alias do modelo, consulte o artigo Como usar aliases de modelos.

Limitações

Quando copia um modelo, nem todas as informações do modelo são copiadas. O modelo copiado não retém o seguinte:

  • Aliases de versões.
  • O ID do modelo personalizado. Pode especificar um novo ID assim que o modelo for copiado.
  • Qualquer avaliação de modelo existente.
  • Especificações de encriptação. Tem de especificar a chave de encriptação quando copiar o modelo para a região de destino.
  • Implementações e inferências em lote.

Para a cópia entre projetos, não pode copiar modelos personalizados que tenham uma imagem de contentor de terceiros.

Copie modelos entre projetos

Pré-requisitos

Para copiar um modelo entre projetos, o proprietário do modelo de origem tem de conceder primeiro a autorização de exportação do modelo ao projeto de destino:

  1. Selecione o seu projeto na Google Cloud consola.
  2. Navegue para a página IAM e administrador.
  3. Na página de autorizações da IAM, clique em Conceder acesso. É apresentada uma janela de pop-up que lhe permite adicionar um novo principal ao projeto de origem.
  4. Obtenha a conta de serviço por produto e por projeto (P4SA) service-{project_number}@gcp-sa-aiplatform.iam.gserviceaccount.com do projeto de destino.
  5. Adicione a P4SA do projeto de destino como um novo principal ao projeto de origem e atribua-lhe a função de agente do serviço Vertex AI.
  6. Depois de clicar em Guardar, a P4SA do projeto de destino tem autorizações para exportar modelos do projeto de origem.

REST

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

  • DESTINATION_LOCATION: a região para a qual quer copiar o modelo. Por exemplo, us-central1
  • DESTINATION_PROJECT_ID: o ID do projeto ou o número do projeto para o qual quer copiar o modelo.
  • SOURCE_PROJECT_ID: o ID ou o número do projeto.
  • SOURCE_LOCATION: A região da Vertex AI a partir da qual está a copiar um modelo.
  • SOURCE_MODEL_ID: a origem do ID do modelo a copiar.
  • VERSION_ID: (Opcional) ID da versão do modelo a copiar (se não for fornecido, é copiada a versão predefinida)

Método HTTP e URL: 

POST https://DESTINATION_LOCATION-aiplatform.googleapis.com/v1/projects/DESTINATION_PROJECT_ID/locations/DESTINATION_LOCATION/models:copy

Corpo JSON do pedido: 

   {
    "sourceModel": "projects/SOURCE_PROJECT_ID/locations/SOURCE_LOCATION/models/SOURCE_MODEL_ID"
    }

Para enviar o seu pedido, expanda uma destas opções:

Deve receber uma resposta JSON semelhante à seguinte:

  {
    "name": "projects/PROJECT_ID/locations/LOCATION/models/MODEL_ID/operations/OPERATION_ID",
    "metadata": {
      "@type": "type.googleapis.com/google.cloud.aiplatform.v1.CopyModelOperationMetadata",
      "genericMetadata": {
        "createTime": "2022-07-01T00:10:55.621355Z",
        "updateTime": "2022-07-01T00:10:55.621355Z"
      }
    }
  }

Consola


Use as instruções seguintes para copiar modelos para um projeto diferente.

  1. Na Google Cloud consola, aceda à página Registo de modelos da Vertex AI. Aceda ao Registo de modelos Vertex AI
  2. No Model Registry, selecione o menu Mais ações para o modelo que quer copiar.
  3. Clique em Copiar modelo.
  4. Escolha Para outro projeto ou Para outra região.

Copie o modelo para um projeto diferente

  1. Escolha Para outro projeto.
  2. Escolha a versão do modelo que quer copiar.
  3. Escolha o projeto de destino para o qual quer copiar.
  4. Escolha a região de destino, por exemplo, us-central1.
  5. Opções avançadas: opcional para escolher o método de encriptação, usando um Google-owned and Google-managed encryption key ou uma chave do Cloud KMS.

Copie modelos entre localizações

REST

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

  • DESTINATION_LOCATION: a região onde está a usar o Vertex AI. Por exemplo, us-central1
  • SOURCE_LOCATION: A região da Vertex AI a partir da qual vai copiar o modelo.
  • PROJECT_ID: o ID ou o número do projeto.
  • MODEL_ID:ID do modelo a copiar.
  • VERSION_ID: (Opcional) ID da versão do modelo a copiar (se não for fornecido, é copiada a versão predefinida)

Método HTTP e URL: 

POST https://DESTINATION_LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/models:copy

Corpo JSON do pedido: 


{"sourceModel": "projects/PROJECT_ID/locations/SOURCE_LOCATION/models/MODEL_ID[@VERSION_ID]"
}

Para enviar o seu pedido, expanda uma destas opções:

Deve receber uma resposta JSON semelhante à seguinte:

  {
    "name": "projects/PROJECT_ID/locations/LOCATION/models/MODEL_ID/operations/OPERATION_ID",
    "metadata": {
      "@type": "type.googleapis.com/google.cloud.aiplatform.v1.CopyModelOperationMetadata",
      "genericMetadata": {
        "createTime": "2022-07-01T00:10:55.621355Z",
        "updateTime": "2022-07-01T00:10:55.621355Z"
      }
    }
  }

Consola


Com uma cópia entre regiões, pode copiar um modelo como um novo modelo na região de destino ou como uma nova versão de um modelo existente nessa região.

Siga as instruções abaixo para copiar modelos.

  1. Na Google Cloud consola, aceda à página Registo de modelos da Vertex AI. Aceda ao Registo de modelos
  2. No Model Registry, selecione o menu Mais ações para o modelo que quer copiar.
  3. Clique em Copiar modelo
  4. Escolha Para outro projeto ou Para outra região.

Copie o modelo para uma região diferente

  1. Escolha Para outra região.
  2. Escolha a versão do modelo que quer copiar.
  3. Selecione Copiar como novo modelo ou Copiar como nova versão.
  4. Escolha a região de destino.
  5. Adicione o nome do modelo de destino ou o ID do modelo. Se copiar um modelo pela primeira vez, é-lhe atribuído o alias predefinido na nova região.