Introdução ao SDK da plataforma de agentes para Python

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 plataforma de agentes usa código Python para acessar a API da plataforma de agentes. 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 em a documentação de referência da API Python do SDK da plataforma de agentes.

Por que usar o SDK da plataforma de agentes

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 é 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-aiplatform
```
Use o código a seguir para importar o namespace google.cloud.aiplatform:
```
from google.cloud import aiplatform
```
Pré-lançamento: para usar recursos do SDK da plataforma de agentes para Python que ainda estão em pré-lançamento, importe vertexai.preview:
```
import vertexai.preview
```
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 plataforma de agentes: apresenta as principais classes e funcionalidades no SDK da plataforma de agentes.
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 plataforma de agentes, 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 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 plataforma de agentes

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 plataforma de agentes 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 plataforma de agentes 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 agentes do Gemini Enterprise.

O SDK da plataforma de agentes 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 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 plataforma de agentes 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 da plataforma de agentes do Gemini Enterprise e o SDK 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 plataforma de agentes, 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 agentes do Gemini Enterprise usa um namespace diferente para acessar a API da plataforma de agentes. A biblioteca de cliente e os namespaces do SDK da plataforma de agentes 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.