Introdução ao SDK Vertex AI para Python

O SDK do Vertex AI para Python ajuda a automatizar a obtenção de dados, preparar modelos e receber previsões no Vertex AI. O SDK do Vertex AI usa código Python para aceder à API Vertex AI, para que possa realizar programaticamente a maioria das ações que pode fazer na Google Cloud consola.

Para saber como instalar ou atualizar o SDK Vertex AI para Python, consulte o artigo Instale o SDK Vertex AI para Python. Para mais informações, consulte a documentação de referência da API do SDK Vertex AI para Python.

Porquê usar o SDK Vertex AI

O SDK do Vertex AI para Python é recomendado se for um engenheiro de aprendizagem automática (AA) e inteligência artificial (IA) com experiência ou um cientista de dados que queira automatizar o seu fluxo de trabalho através de programação. O SDK Vertex AI para Python é semelhante à biblioteca cliente Python do Vertex AI, exceto que o SDK Vertex AI é de nível superior e menos detalhado. Para mais informações, consulte o artigo Compreenda as diferenças entre o SDK e a biblioteca de cliente.

Escreva código com o SDK Vertex AI para Python

Para usar o SDK Vertex AI para Python:

  1. Instale o pacote google-cloud-aiplatform, que inclui o SDK Vertex AI para Python e a biblioteca cliente Python Vertex AI, executando o seguinte comando no seu ambiente virtual:

    pip install --upgrade google-cloud-aiplatform

  2. Use o código seguinte para importar o espaço de nomes google.cloud.aiplatform:

    from google.cloud import aiplatform

  3. If you're using a local shell, then create local authentication credentials for your user account: 

    gcloud auth application-default login

    You don't need to do this if you're using Cloud Shell.

    If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.

Saiba mais sobre o SDK Vertex AI para Python

Consulte a seguinte documentação:

  • Vista geral da classe do SDK Vertex AI: apresenta as principais classes e funcionalidades no SDK Vertex AI.

  • Referência do Python para o Vertex AI: contém documentação de referência para todos os espaços de nomes, classes, métodos e propriedades no pacote google-cloud-aiplatform, que inclui o SDK do Vertex AI, a pré-visualização do SDK do Vertex AI e as bibliotecas de cliente do Vertex AI.

Experimente exemplos de código e tutoriais

Os tutoriais de blocos de notas mostram como usar o SDK Vertex AI para Python como parte de um fluxo de trabalho maior. Para mais informações, consulte os tutoriais do bloco de notas do Vertex AI.

Os exemplos de código no repositório do GitHub do SDK do Vertex AI para Python mostram como concluir tarefas individuais. Para mais informações, consulte o repositório do GitHub do SDK do Vertex AI para Python.

Compreenda as diferenças entre o SDK Vertex AI e a biblioteca cliente

Quando instala o SDK Vertex AI para Python, a biblioteca do cliente Python da Vertex AI também é instalada. O SDK do Vertex AI e a biblioteca cliente Python do Vertex AI oferecem uma funcionalidade semelhante com diferentes níveis de detalhe. O SDK do Vertex AI opera a um nível de abstração superior ao da biblioteca de cliente e é adequado para a maioria dos fluxos de trabalho de ciência de dados comuns. Se precisar de funcionalidades de nível inferior, use a biblioteca cliente Python do Vertex AI.

O SDK Vertex AI está disponível para Python e uma biblioteca cliente do Vertex AI está disponível para Python, Java e Node.js. Para saber como instalar a biblioteca cliente Java ou Node.js, consulte o artigo Instale as bibliotecas cliente da Vertex AI. Se não estiver disponível uma biblioteca cliente na sua linguagem de programação preferida, pode usar a API REST do Vertex AI. Para mais informações, consulte a referência da API REST do Vertex AI.

Use a biblioteca cliente Python e o SDK da Vertex AI em conjunto

Se usar o SDK Vertex AI para Python e descobrir que precisa de maior flexibilidade ou controlo, ou se precisar de um método não incluído no SDK Vertex AI, pode usar a biblioteca cliente Python do Vertex AI no mesmo fluxo de trabalho. A biblioteca cliente Python da Vertex AI usa um espaço de nomes diferente para aceder à API Vertex AI. Os espaços de nomes da biblioteca cliente e do SDK Vertex AI para Python podem ser usados no mesmo script Python adicionando uma linha import para cada um no script Python.

Importe o espaço de nomes da biblioteca cliente Python do Vertex AI

O espaço de nomes da biblioteca cliente Python da Vertex AI é google.cloud.aiplatform.gapic. Este espaço de nomes é mapeado para o espaço de nomes google.cloud.aiplatform_v1. Estes dois espaços de nomes podem ser usados de forma intercambiável. Para importar a biblioteca cliente Python, inclua um dos seguintes elementos no seu script Python:

from google.cloud import aiplatform_v1
 
from google.cloud.aiplatform import gapic

O que se segue?