google-cloud-aiplatform overview (3.71.0)

Descrição do Vertex AI: é um conjunto integrado de ferramentas e serviços de aprendizagem automática para criar e usar modelos de ML com o AutoML ou código personalizado. Oferece aos principiantes e aos especialistas a melhor plataforma de trabalho para todo o ciclo de vida de desenvolvimento da aprendizagem automática.

Referência do produto Vertex AI Repositório do GitHub Artefacto Maven

Começar a usar

Para usar esta biblioteca, primeiro tem de seguir os seguintes passos:

Use o Vertex AI para Java

Para garantir que o seu projeto usa versões compatíveis das bibliotecas e os respetivos artefactos de componentes, importe com.google.cloud:libraries-bom e use a BOM para especificar as versões das dependências. Certifique-se de que remove todas as versões que definiu anteriormente. Para mais informações sobre as BOMs, consulte a BOM das bibliotecas da Google Cloud Platform.

Maven

Importe a BOM na secção dependencyManagement do ficheiro pom.xml. Inclua artefactos específicos dos quais depende na secção dependencies, mas não especifique as versões dos artefactos na secção dependencies.

O exemplo abaixo demonstra como importar a BOM e incluir o artefacto google-cloud-aiplatform.

<dependencyManagement>
 <dependencies>
   <dependency>
      <groupId>com.google.cloud</groupId>
      <artifactId>libraries-bom</artifactId>
      <version>26.65.0</version>
      <type>pom</type>
      <scope>import</scope>
   </dependency>
 </dependencies>
</dependencyManagement>

<dependencies>
 <dependency>
   <groupId>com.google.cloud</groupId>
   <artifactId>google-cloud-aiplatform</artifactId>
 </dependency>
</dependencies>

Gradle

As BOMs são suportadas por predefinição no Gradle 5.x ou posterior. Adicione uma platform dependência em com.google.cloud:libraries-bom e remova a versão das declarações de dependência no ficheiro build.gradle do artefacto.

O exemplo abaixo demonstra como importar a BOM e incluir o artefacto google-cloud-aiplatform.

implementation(platform("com.google.cloud:libraries-bom:26.65.0"))
implementation("com.google.cloud:google-cloud-aiplatform")

As palavras-chave platform e enforcedPlatform fornecem versões de dependência declaradas numa BOM. A palavra-chave enforcedPlatform aplica as versões de dependência declaradas na BOM e, por isso, substitui o que especificou.

Para mais detalhes sobre as palavras-chave platform e enforcedPlatform do Gradle 5.x ou superior, consulte o artigo Gradle: importar BOMs do Maven.

Se estiver a usar o Gradle 4.6 ou posterior, adicione enableFeaturePreview('IMPROVED_POM_SUPPORT') ao ficheiro settings.gradle. Para obter detalhes, consulte as notas de lançamento do Gradle 4.6: importação de BOM. As versões do Gradle anteriores à 4.6 não suportam BOMs.

SBT

O SBT não suporta BOMs. Pode encontrar versões recomendadas de bibliotecas a partir de uma versão específica da BOM no painel de controlo e definir as versões manualmente. Para usar a versão mais recente desta biblioteca, adicione o seguinte às suas dependências:

libraryDependencies += "com.google.cloud" % "google-cloud-aiplatform" % "3.71.0"

Com que ID da versão devo começar?

Para esta biblioteca, recomendamos que use com.google.cloud.aiplatform.v1 para novas aplicações.

Compreender o ID da versão e as versões da biblioteca

Quando usa uma biblioteca de cliente da nuvem, é importante distinguir entre dois tipos de versões:

  • Versão da biblioteca: a versão do pacote de software (a biblioteca cliente) que ajuda a interagir com o serviço na nuvem. Estas bibliotecas são lançadas e atualizadas frequentemente com correções de erros, melhorias e suporte para novas funcionalidades e versões de serviços. O seletor de versões na parte superior desta página representa a versão da biblioteca de cliente.
  • ID da versão: a versão do próprio serviço na nuvem (por exemplo, Vertex AI). Os novos IDs de versão são introduzidos com pouca frequência e envolvem, muitas vezes, alterações à funcionalidade e estrutura principais do próprio serviço na nuvem. Os pacotes na navegação do lado esquerdo representam pacotes associados a um ID da versão específico do serviço na nuvem.

Gerir versões da biblioteca

Recomendamos que use o método de instalação com.google.cloud:libraries-bom detalhado acima para simplificar a gestão de dependências em várias bibliotecas cliente Java do Google Cloud. Isto garante a compatibilidade e simplifica as atualizações.

Escolher o ID da versão certo

Cada biblioteca cliente Java do Google Cloud pode conter pacotes associados a IDs de versão específicos (por exemplo, v1, v2alpha). Para novas aplicações de produção, use o ID da versão estável mais recente. Isto é identificado pelo número de versão mais elevado sem um sufixo (como "alfa" ou "beta"). Pode ler mais acerca da estratégia de controlo de versões da API Cloud aqui.

Importante: as versões instáveis do ID da versão (as que têm sufixos) estão sujeitas a alterações significativas quando são atualizadas. Use-os apenas para testes ou se precisar especificamente das respetivas funcionalidades experimentais.