Como gerenciar modelos
Um modelo é treinado com um conjunto de dados preparado que você fornece. O rastreamento de objetos do AutoML Video Intelligence usa os itens do conjunto de dados para treinar, testar e evaluate o desempenho do modelo. Em seguida, analise os resultados, ajusta o conjunto de dados de treinamento conforme necessário e treina um novo modelo usando o conjunto de dados aprimorado.
Esse processo pode levar várias horas para ser concluído. A API AutoML permite verificar o status do treinamento.
Como o rastreamento de objetos do AutoML Video Intelligence cria um novo modelo sempre que você começa o treinamento, o projeto pode incluir vários modelos. É possível conseguir uma lista dos modelos no projeto e excluir modelos que não forem mais necessários.
A vida útil máxima de um modelo é de dois anos. É necessário criar e treinar um novo modelo para continuar rastreando objetos após esse período.
Como usar curl ou PowerShell
Para facilitar a execução das amostras de curl
(ou do PowerShell) neste tópico, defina a seguinte variável de ambiente. Substitua project-id pelo nome do projeto do Google Cloud.
export PROJECT_ID="project-id"
Como treinar modelos
Quando você tem um conjunto de dados com um conjunto sólido de itens de treinamento rotulados, é possível criar e treinar o modelo.
IU da Web
-
Abra a interface de usuário do rastreamento de objetos de vídeo do AutoML e navegue até a página Conjuntos de dados.
-
Selecione o conjunto de dados que você quer usar para treinar o modelo.
O nome de exibição do conjunto de dados selecionado é mostrado na barra de título, e a página relaciona os itens individuais no conjunto de dados com os respectivos rótulos.
-
Quando terminar de revisar o conjunto de dados, clique na guia Treinar logo abaixo da barra de título.
A página de treinamento oferece uma análise básica do seu conjunto de dados e o orienta sobre a adequação do treinamento. Se o rastreamento de objetos do AutoML Video sugerir alterações, pense em retornar à página Vídeos e adicionar itens ou rótulos.
- Quando o conjunto de dados estiver pronto, clique em Iniciar treinamento para criar um novo modelo ou Treinar novo modelo se quiser criar outro.
REST
Antes de usar os dados da solicitação, faça as substituições a seguir:
- dataset-id: o nome do conjunto de dados de destino.
Por exemplo, o nome de exibição
my_dataset_01
. - model-name: substitua por um nome escolhido para o modelo.
- Observação:
- project-number: o número do seu projeto
- location-id: a região do Cloud em que a anotação deve ocorrer. As regiões de nuvem compatíveis são:
us-east1
,us-west1
,europe-west1
easia-east1
. Se nenhuma região for especificada, uma região será determinada com base na localização do arquivo de vídeo.
Método HTTP e URL:
POST https://automl.googleapis.com/v1beta1/projects/project-number/locations/location-id/models
Corpo JSON da solicitação:
{ "datasetId": "dataset-id", "displayName": "model-name", "videoObjectTrackingModelMetadata": {}, }
Para enviar a solicitação, escolha uma destas opções:
curl
Salve o corpo da solicitação em um arquivo com o nome request.json
e execute o comando a seguir:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "x-goog-user-project: project-number" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://automl.googleapis.com/v1beta1/projects/project-number/locations/location-id/models"
PowerShell
Salve o corpo da solicitação em um arquivo com o nome request.json
e execute o comando a seguir:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "project-number" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://automl.googleapis.com/v1beta1/projects/project-number/locations/location-id/models" | Select-Object -Expand Content
VOT1741767155885539328
.
Java
Para autenticar o rastreamento de objetos de vídeo do AutoML, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Node.js
Para autenticar o rastreamento de objetos de vídeo do AutoML, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Python
Para autenticar o rastreamento de objetos de vídeo do AutoML, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Como saber o status de uma operação
Para verificar o status de uma tarefa de longa execução, como importar itens para um conjunto de dados ou treinar um modelo, use o ID da operação que está na resposta fornecida no início da tarefa.
REST
Antes de usar os dados da solicitação, faça as substituições a seguir:
- operation-id: o ID da operação de longa duração criada para a solicitação e fornecida na resposta quando você iniciou a operação. Por exemplo,
VOT12345....
- Observação:
- project-number: o número do seu projeto
- location-id: a região do Cloud em que a anotação deve ocorrer. As regiões de nuvem compatíveis são:
us-east1
,us-west1
,europe-west1
easia-east1
. Se nenhuma região for especificada, uma região será determinada com base na localização do arquivo de vídeo.
Método HTTP e URL:
GET https://automl.googleapis.com/v1beta1/projects/project-number/locations/location-id/operations/operation-id
Para enviar a solicitação, escolha uma destas opções:
curl
execute o seguinte comando:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "x-goog-user-project: project-number" \
"https://automl.googleapis.com/v1beta1/projects/project-number/locations/location-id/operations/operation-id"
PowerShell
execute o seguinte comando:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "project-number" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://automl.googleapis.com/v1beta1/projects/project-number/locations/location-id/operations/operation-id" | Select-Object -Expand Content
done: true
sem erros listados, como mostrado no exemplo acima.
- operation-name: o nome da operação conforme retornado pela API de rastreamento de objetos do AutoML Video Intelligence. O nome da operação tem o formato
projects/project-number/locations/location-id/operations/operation-id
.
Java
Para autenticar o rastreamento de objetos de vídeo do AutoML, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Node.js
Para autenticar o rastreamento de objetos de vídeo do AutoML, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Python
Para autenticar o rastreamento de objetos de vídeo do AutoML, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Cancelar uma operação
É possível cancelar uma tarefa de importação, treinamento ou previsão em lote usando o ID da operação.
REST
Antes de usar os dados da solicitação, faça as substituições a seguir:
- operation id: fornecido na resposta quando você iniciou a operação, por exemplo, VOT123....
- Observação:
- project-id: código do projeto do GCP.
- location-id: a região do Cloud em que a anotação deve ocorrer. As regiões de nuvem compatíveis são:
us-east1
,us-west1
,europe-west1
easia-east1
. Se nenhuma região for especificada, uma região será determinada com base na localização do arquivo de vídeo.
Método HTTP e URL:
POST https://automl.googleapis.com/v1beta1/projects/project-id/locations/location-id/operations/operation-id:cancel
Para enviar a solicitação, expanda uma destas opções:
Você receberá um código de status de êxito (2xx) e uma resposta vazia.
Java
Para autenticar o rastreamento de objetos de vídeo do AutoML, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Como conseguir informações sobre um modelo
Quando o treinamento estiver concluído, você poderá conseguir informações sobre o modelo recém-criado.
Nesta seção, os exemplos retornam os metadados básicos sobre um modelo. Para ver detalhes sobre a precisão e a prontidão de um modelo, consulte Como avaliar modelos.
IU da Web
-
Navegue até a página Modelos na interface do usuário de rastreamento de objetos de vídeo do AutoML.
- Clique no nome do modelo que você quer ver.
REST
Antes de usar os dados da solicitação, faça as substituições a seguir:
- model-id: ID do seu modelo, com base na resposta de quando você o criou.
Ele é o último elemento no nome do modelo. Por exemplo:
- nome do modelo: projects/project-number/locations/location-id/models/model-id
- ID do modelo: model-id
- dataset-id: substitua pelo identificador do conjunto de dados do seu conjunto de dados (e não pelo nome de exibição). Por exemplo:
VOT3940649673949184000
- project-number: o número do seu projeto
Método HTTP e URL:
GET https://automl.googleapis.com/v1beta1/projects/project-id/locations/location-id/models/model-id
Corpo JSON da solicitação:
{ "displayName": "display-name", "dataset_id": "dataset-id", "videoClassificationModelMetadata": {} }
Para enviar a solicitação, expanda uma destas opções:
Você receberá uma resposta JSON semelhante a esta:
Java
Para autenticar o rastreamento de objetos de vídeo do AutoML, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Node.js
Para autenticar o rastreamento de objetos de vídeo do AutoML, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Python
Para autenticar o rastreamento de objetos de vídeo do AutoML, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Como listar modelos
Um projeto pode incluir vários modelos. Nesta seção, descrevemos como recuperar uma lista dos modelos disponíveis para um projeto.
IU da Web
Navegue até a página Modelos na interface do usuário de rastreamento de objetos de vídeo do AutoML para ver os modelos no seu projeto.
Para ver os modelos de outro projeto, selecione o projeto na lista suspensa, na parte superior direita da barra de título.
REST
Antes de usar os dados da solicitação, faça as substituições a seguir:
- project-number: o número do seu projeto
- location-id: a região do Cloud em que a anotação deve ocorrer. As regiões de nuvem compatíveis são:
us-east1
,us-west1
,europe-west1
easia-east1
. Se nenhuma região for especificada, uma região será determinada com base na localização do arquivo de vídeo.
Método HTTP e URL:
GET https://automl.googleapis.com/v1beta1/projects/project-number/locations/location-id/models
Para enviar a solicitação, expanda uma destas opções:
Você receberá uma resposta JSON semelhante a esta:
Java
Para autenticar o rastreamento de objetos de vídeo do AutoML, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Node.js
Para autenticar o rastreamento de objetos de vídeo do AutoML, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Python
Para autenticar o rastreamento de objetos de vídeo do AutoML, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
exclusão de um modelo
No exemplo a seguir, excluímos um modelo.
IU da Web
-
Navegue até a página Modelos na interface do usuário de rastreamento de objetos de vídeo do AutoML.
- Clique no menu de três pontos à extrema direita da linha que você quer excluir e selecione Excluir.
- Clique em Confirmar na caixa de diálogo de confirmação.
REST
Antes de usar os dados da solicitação, faça as substituições a seguir:
- project-number: o número do seu projeto
- location-id: a região do Cloud em que a anotação deve ocorrer. As regiões de nuvem compatíveis são:
us-east1
,us-west1
,europe-west1
easia-east1
. Se nenhuma região for especificada, uma região será determinada com base na localização do arquivo de vídeo. - model-id: substitua pelo identificador do modelo.
Método HTTP e URL:
DELETE https://automl.googleapis.com/v1beta1/projects/project-number/locations/location-id/models/model-id
Para enviar a solicitação, expanda uma destas opções:
Você receberá um código de status de êxito (2xx) e uma resposta vazia.
Java
Para autenticar o rastreamento de objetos de vídeo do AutoML, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Node.js
Para autenticar o rastreamento de objetos de vídeo do AutoML, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Python
Para autenticar o rastreamento de objetos de vídeo do AutoML, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.