O SDK da plataforma de agentes para Python ajuda a automatizar a ingestão de dados, treinar modelos e receber previsões na plataforma de agentes do Gemini Enterprise. 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 plataforma de agentes para Python, consulte Instalar o SDK da plataforma de agentes para Python. Saiba mais na documentação de referência da API Python do SDK da plataforma de agente.
Por que usar o SDK Vertex AI
O SDK da plataforma de agentes 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 plataforma de agentes para Python é semelhante à biblioteca de cliente Python da plataforma de agentes do Gemini Enterprise, 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 plataforma de agentes para Python
Para usar o SDK da plataforma de agentes para Python:
Instale o pacote
google-cloud-aiplatform, que inclui o SDK da plataforma de agentes para Python e a biblioteca de cliente Python da plataforma de agentes do Gemini Enterprise, 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 plataforma de agentes 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 da Vertex AI, a visualização do SDK da Vertex AI 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 plataforma de agentes 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 plataforma de agentes para Python mostram como realizar tarefas individuais. Para mais informações, consulte o repositório do SDK da plataforma de agentes para Python no GitHub.
Entender as diferenças do SDK e da biblioteca de cliente da Vertex AI
Quando você instala o SDK da plataforma de agentes para Python, a biblioteca de cliente Python da plataforma de agentes do Gemini Enterprise também é instalada. O SDK da Vertex AI e a biblioteca de cliente Python da plataforma de agente do Gemini Enterprise oferecem funcionalidades semelhantes com diferentes níveis de granularidade. O SDK 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 plataforma de agente do Gemini Enterprise.
O SDK da Vertex AI está disponível para Python, e uma biblioteca de cliente da plataforma de agentes do Gemini Enterprise 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 agente 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 plataforma de agente do Gemini Enterprise. Para mais informações, consulte a referência REST da plataforma de agentes do Gemini Enterprise.
Usar a biblioteca de cliente Python e o SDK da plataforma de agentes do Gemini Enterprise juntos
Se você usar o SDK da plataforma de agentes 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 da plataforma de agentes do Gemini Enterprise no mesmo fluxo de trabalho. A
biblioteca de cliente Python da plataforma de agente do Gemini Enterprise usa um namespace diferente para acessar a
API da plataforma de agente. A biblioteca de cliente e os namespaces do SDK da plataforma de agentes para Python
podem ser usados no mesmo script 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.