Copiar um modelo no Vertex AI Model Registry

Treinar o AutoML, modelos grandes e modelos personalizados na Vertex AI no nível que você quer requer tempo e experimentação. Se você tem um modelo com bom desempenho que quer usar em outro projeto ou local, treinar um novo modelo não é a melhor opção. O treinamento do modelo não é determinístico por natureza, então é improvável que você acabe com um modelo idêntico de dados idênticos. Além disso, treinar um modelo em cada região ou projeto não é uma maneira infalível de manter a consistência do comportamento do modelo entre regiões. Com o modelo de cópia do Vertex AI Model Registry, é possível copiar um modelo do Vertex AI Model Registry para um local separado no mesmo projeto ou em um projeto diferente.

Ao executar uma cópia de modelo, se você não especificar a versão de modelo que quer copiar, a versão padrão do modelo será copiada. Para saber mais sobre o modelo padrão ou o alias de modelo, consulte Como usar aliases de modelo.

Limitações

Quando você copia um modelo, nem todas as informações dele são copiadas. O modelo copiado não terá o seguinte:

  • Aliases da versão.
  • ID do modelo personalizado: é possível especificar um novo ID depois que o modelo é copiado.
  • Qualquer avaliação de modelo atual.
  • Especificações de criptografia É necessário especificar um novo valor após a cópia para a região de destino.
  • Implantações e previsões em lote.
  • Para a cópia entre projetos, é possível copiar modelos personalizados com uma imagem de contêiner de terceiros.

Copiar modelos entre projetos

Pré-requisitos

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

  1. Selecione seu projeto no console do Google Cloud.
  2. Acesse a página IAM e administrador.
  3. Na página de permissões do IAM, clique em Conceder acesso. Uma janela pop-up será exibida para que você adicione um novo principal ao projeto de origem.
  4. Consiga o número do projeto de destino e a credencial P4SA do projeto de destino.
  5. Adicione a credencial P4SA do projeto de destino como o novo principal ao projeto de origem e atribua o papel de Agente de serviço da Vertex AI à P4SA do projeto de destino.
  6. Depois de clicar em Salvar, a P4SA do projeto de destino terá permissões para exportar modelos do projeto de origem.

REST

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

  • DESTINATION_LOCATION: a região para onde você quer copiar o modelo. Por exemplo, us-central1
  • DESTINATION_PROJECT_ID: o ID ou número do projeto para o qual você quer copiar o modelo.
  • SOURCE_PROJECT_ID: o ID ou o número do projeto;
  • SOURCE_LOCATION: a região da Vertex AI de onde você está copiando um modelo.
  • SOURCE_MODEL_ID: a origem do ID do modelo a ser copiado.
  • VERSION_ID: (opcional) ID da versão do modelo a ser copiado (se não for fornecido, a versão padrão será copiada)

Método HTTP e URL: 

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

Corpo JSON da solicitação:

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

Para enviar a solicitação, expanda uma destas opções:

Você receberá uma resposta JSON semelhante a esta:

  {
    "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"
      }
    }
  }

Console


Siga as instruções abaixo para copiar um modelo para um projeto diferente.

  1. No console do Google Cloud, acesse a página do Vertex AI Model Registry. Acessar o Vertex AI Model Registry
  2. No Model Registry, selecione o menu Mais ações para o modelo que você quer copiar.
  3. Clique em Copiar modelo.
  4. Escolha Para outro projeto ou Para outra região.

Copiar o modelo para um projeto diferente

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

Copiar modelos entre locais

REST

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

  • DESTINATION_LOCATION: a região em que você está usando a Vertex AI. Por exemplo, us-central1
  • SOURCE_LOCATION: a região da Vertex AI de onde você copiará o modelo.
  • PROJECT_ID: o ID ou o número do projeto;
  • MODEL_ID: ID do modelo a ser copiado.
  • VERSION_ID: (opcional) ID da versão do modelo a ser copiado (se não for fornecido, a versão padrão será copiada)

Método HTTP e URL: 

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

Corpo JSON da solicitação:


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

Para enviar a solicitação, expanda uma destas opções:

Você receberá uma resposta JSON semelhante a esta:

  {
    "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"
      }
    }
  }

Console


Com uma cópia entre regiões, é possível copiar um modelo como um novo modelo na região de destino ou como uma nova versão de um modelo atual nessa região.

Siga as instruções abaixo para copiar modelos.

  1. No console do Google Cloud, acesse a página do Vertex AI Model Registry. Acessar o Model Registry
  2. No Model Registry, selecione o menu Mais ações para o modelo que você quer copiar.
  3. Clique em Copiar modelo
  4. Escolha Para outro projeto ou Para outra região.

Copiar modelo para uma região diferente

  1. Escolha Para outra região.
  2. Escolha a versão do modelo que você 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 ou ID do modelo de destino. Se você copiar um modelo pela primeira vez, será atribuído o alias padrão na nova região.