Se você tiver recursos criados com a API AutoML, será possível atualizá-los para gerenciá-los usando a versão Advanced da API Cloud Translation sem interrupções no serviço ou custos adicionais. Durante o upgrade, o Cloud Translation copia seus recursos do AutoML (legados), como conjuntos de dados e modelos, e cria novos recursos do Cloud Translation (nativos) por meio da API Cloud Translation.
Recomendamos o uso do Cloud Translation porque melhorias futuras em conjuntos de dados e modelos personalizados serão aplicadas apenas ao Cloud Translation. Os recursos atualizados podem aproveitar essas melhorias futuras, como suporte adicional ao par de idiomas.
Não é necessário fazer upgrade dos recursos. Ainda é possível usar a API AutoML, que continuará disponível.
Considerações sobre upgrades
Após o upgrade, seus recursos nativos e legados existem juntos, mas são gerenciados por APIs diferentes. Para acessar e gerenciar os recursos atualizados, use a API Cloud Translation, não a API AutoML.
Os recursos nativos são idênticos aos recursos legados, exceto pelos IDs deles. O Cloud Translation não altera os recursos legados. Você pode continuar trabalhando com os recursos legados como antes.
É possível fazer upgrade de alguns ou de todos os seus recursos. Quando você faz upgrade de um conjunto de dados, todos os modelos associados a ele também são atualizados automaticamente. Somente os modelos sem um conjunto de dados subjacente, como nos casos em que o conjunto de dados associado foi excluído, podem ser atualizados manualmente por conta própria.
Diferenças entre recursos legados e nativos
A tabela a seguir descreve as diferenças entre recursos legados e nativos.
| Recurso | Legado | Nativo |
|---|---|---|
| Importar dados para conjuntos de dados ao usar a API | Use o arquivo CSV para especificar locais de arquivos de origem no Cloud Storage | Especificar locais de arquivos TMX e TSV no Cloud Storage |
| Exportar dados | Permite exportar pares de segmentos de um conjunto de dados ou de dados da avaliação do modelo, o que inclui o conjunto de testes e previsões do modelo | Aceita a exportação de pares de segmentos somente de um conjunto de dados. |
| Ver divisões de dados por arquivo de origem | O console do Google Cloud mostra uma lista de arquivos de origem que foram usados para preencher um conjunto de dados e como os dados foram divididos para cada arquivo. Também é possível excluir os dados importados por arquivo de origem. |
Não aplicável, os conjuntos de dados nativos não rastreiam informações do arquivo de origem. |
| Avaliação de modelos | Oferece suporte a avaliações de execução em um novo conjunto de teste ou em um conjunto de dados existente | Suporta avaliações em execução somente em um novo conjunto de teste |
| Cancelar operações | Suporta operações de criação de modelos e importação de conjuntos de dados | Não é possível cancelar operações de longa duração |
Comportamento do console do Google Cloud após o upgrade
Se você fizer upgrade de pelo menos um recurso, o console do Google Cloud passará a usar a API Cloud Translation em vez da API AutoML. Portanto, ao criar novos conjuntos de dados no console do Google Cloud, você cria conjuntos de dados nativos por padrão. Essa mudança acontece no nível do projeto. Portanto, outros usuários do projeto também a veem. Para criar um conjunto de dados legado, selecione a opção de criar um conjunto de dados legado ou use a API AutoML.
Ao treinar novos modelos personalizados, o console do Google Cloud usa a API AutoML ou a API Cloud Translation, dependendo do conjunto de dados. Para conjuntos de dados legados, o console usa a API AutoML para criar modelos legados. Para conjuntos de dados nativos, o console do Google Cloud usa a API Cloud Translation para criar modelos nativos.
API Cloud Translation
Para gerenciar recursos nativos com a API Cloud Translation, é necessário atualizar seu código para chamar as APIs corretas com os IDs de recurso corretos. Por exemplo, se você tiver comandos que chamam a API AutoML e fizerem referência a IDs de recursos legados, será necessário atualizá-los para chamar a API Cloud Translation e referenciar os IDs de recursos nativos.
Para mais informações sobre a API Cloud Translation, consulte os recursos projects.locations.datasets e projects.locations.models.
Recursos do upgrade
Use o console do Google Cloud para fazer upgrade dos recursos atuais do AutoML para os recursos do Cloud Translation.
Acesse o console do AutoML Translation.
Clique em Conjuntos de dados para ver os conjuntos de dados atuais.
Clique em Fazer upgrade para abrir o painel Fazer upgrade do conjunto de dados, que lista os conjuntos de dados que podem ser atualizados.
Quando você faz upgrade de um conjunto de dados, qualquer modelo associado a ele também recebe o upgrade automático.
Selecione os conjuntos de dados que você quer atualizar e clique em Iniciar upgrade.
Na página Conjuntos de dados, o console do Google Cloud lista os conjuntos de dados atualizados e legados em tabelas separadas.
Para fazer o upgrade manual de modelos, no painel de navegação, clique em Modelos para visualizar seus modelos atuais.
Só é possível fazer upgrade manual de modelos sem um conjunto de dados, por exemplo, se o conjunto de dados associado ao modelo foi excluído.
Clique em Fazer upgrade para abrir o painel Fazer upgrade do modelo.
Selecione os modelos que você quer atualizar e clique em Iniciar upgrade.
Na página Modelos, o console do Google Cloud lista os modelos atualizados e legados em tabelas separadas.
Depois de fazer upgrade dos recursos, faça as seguintes mudanças:
- Atualizar o código atual para usar a API Cloud Translation e os recursos recém-criados. Para mais informações, consulte Criar e gerenciar conjuntos de dados e Criar e gerenciar modelos.
- Para previsões de tradução, use a API Cloud Translation em vez da API AutoML. Para mais informações, consulte Como traduzir textos com um modelo personalizado.
Excluir recursos legados
Depois de migrar totalmente para os novos recursos e a API Cloud Translation, é possível remover os recursos legados para ter apenas um conjunto único de recursos.
Acesse o console do AutoML Translation.
No painel de navegação, clique em Conjuntos de dados para visualizar os conjuntos de dados legados.
Para cada conjunto de dados na tabela Conjuntos de dados legados, selecione Mais > Excluir e clique em Confirmar.
No painel de navegação, clique em Modelos para visualizar os modelos legados.
Para cada modelo na tabela Modelos legados, selecione Mais > Excluir e clique em Confirmar.