O SDK da Agent Platform para Python ajuda a automatizar a ingestão de dados, treinar modelos e receber previsões na Gemini Enterprise Agent Platform. O SDK da Vertex AI usa código Python para acessar a API Agent Platform. Assim, é possível realizar, de maneira programática, a maior parte do que é possível fazer no Google Cloud console.
Para saber como instalar ou atualizar o SDK da Agent Platform para Python, consulte Instalar o SDK da Agent Platform para Python. Saiba mais em a documentação de referência da API SDK da Agent Platform para API Python.
Por que usar o SDK da Vertex AI
O SDK da Agent Platform para Python é recomendado se você for um engenheiro de machine learning (ML) e inteligência artificial (IA) experiente ou um cientista de dados que queira automatizar automaticamente seu fluxo de trabalho. O SDK da Agent Platform para Python é semelhante à biblioteca de cliente Python da Gemini Enterprise Agent Platform, mas o SDK da Vertex AI é de nível superior e menos granular. Para ver mais informações, consulte Entenda as diferenças entre o SDK e a biblioteca de cliente.
Escrever código com o SDK da Agent Platform para Python
Para usar o SDK da Agent Platform para Python:
Instale o pacote
google-cloud-aiplatform, que inclui o SDK da Agent Platform para Python e a biblioteca de cliente Python da Gemini Enterprise Agent Platform, executando o seguinte comando no ambiente virtual:pip install --upgrade google-cloud-aiplatformUse o código a seguir para importar o namespace
google.cloud.aiplatform:from google.cloud import aiplatform-
Se você estiver usando um shell local, crie credenciais de autenticação local para sua conta de usuário:
gcloud auth application-default login
Não é necessário fazer isso se você estiver usando o Cloud Shell.
Se um erro de autenticação for retornado e você estiver usando um provedor de identidade (IdP) externo, confirme se você fez login na CLI gcloud com sua identidade federada.
Saiba mais sobre o SDK da Agent Platform para Python
Consulte a seguinte documentação:
Visão geral da classe do SDK da Vertex AI: apresenta as principais classes e funcionalidades no SDK da Vertex AI.
Referência do Python para a plataforma de agentes do Gemini Enterprise: contém a documentação de referência de todos os namespaces, classes, métodos e propriedades no pacote
google-cloud-aiplatform, que inclui o SDK e a visualização dele, e as bibliotecas de cliente da plataforma de agentes do Gemini Enterprise.
Teste as amostras de código e os tutoriais
Os tutoriais do notebook mostram como usar o SDK da Agent Platform para Python como parte de um fluxo de trabalho maior. Para mais informações, consulte Tutoriais do notebook da plataforma de agentes do Gemini Enterprise.
As amostras de código no repositório GitHub do SDK da Agent Platform para Python mostram como realizar tarefas individuais. Para mais informações, consulte o repositório do SDK da Agent Platform para Python no GitHub.
Entender as diferenças do SDK da Vertex AI e da biblioteca de cliente
Quando você instala o SDK da Agent Platform para Python, a biblioteca de cliente Python da Gemini Enterprise Agent Platform também é instalada. O SDK da Vertex AI e a biblioteca de cliente Python da plataforma de agentes do Gemini Enterprise fornecem funcionalidades semelhantes com diferentes níveis de granularidade. O SDK da Vertex AI opera em um nível de abstração mais alto que o da biblioteca de cliente e é adequado para os fluxos de trabalho de ciência de dados mais comuns. Se você precisar de uma funcionalidade de nível inferior, use a biblioteca de cliente Python da Gemini Enterprise Agent Platform.
O SDK da Vertex AI está disponível para Python e uma biblioteca de cliente do Gemini Enterprise Agent Platform está disponível para Python, Java e Node.js. Para saber como instalar a biblioteca de cliente Java ou Node.js, consulte Instalar as bibliotecas de cliente da plataforma de agentes do Gemini Enterprise. Se não houver uma biblioteca de cliente disponível na sua linguagem de programação preferida, é possível usar a API REST da Gemini Enterprise Agent Platform. Para mais informações, consulte a referência REST da plataforma de agentes do Gemini Enterprise.
Use a biblioteca de cliente Python da Gemini Enterprise Agent Platform e o SDK juntos
Se você usar o SDK da Agent Platform para Python e descobrir que precisa de mais flexibilidade ou controle ou se precisar de um método não incluído no SDK da Vertex AI, poderá usar a biblioteca de cliente Python do Gemini Enterprise Agent Platform no mesmo fluxo de trabalho. A biblioteca de cliente Python da Gemini Enterprise Agent Platform usa um namespace diferente para acessar a API Agent Platform. A biblioteca de cliente e os namespaces do SDK da Agent Platform para Python podem ser usados no mesmo script em Python, adicionando uma linha import para cada um no seu script Python.
Importar o namespace da biblioteca de cliente Python da plataforma de agentes do Gemini Enterprise
O namespace da biblioteca de cliente Python da plataforma de agentes do Gemini Enterprise é google.cloud.aiplatform.gapic. Esse namespace é mapeado para o namespace google.cloud.aiplatform_v1. Esses dois namespaces podem ser usados
de forma intercambiável. Para importar a biblioteca de cliente do Python, inclua uma das
seguintes opções no seu script em Python:
from google.cloud import aiplatform_v1
from google.cloud.aiplatform import gapic
A seguir
Saiba como escolher um método de treinamento.