El SDK de Agent Platform para Python te ayuda a automatizar la transferencia de datos, entrenar modelos y obtener predicciones en Agent Platform de Gemini Enterprise. El SDK de Vertex AI usa código de Python para acceder a la API de Agent Platform, de modo que puedas lograr la mayoría de lo que puedes hacer en la Google Cloud consola de manera programática.
Si deseas obtener información para instalar o actualizar el SDK de Agent Platform para Python, consulta Instala el SDK de Agent Platform para Python. Si deseas obtener más información, consulta la documentación de referencia de la API de Python del SDK de Agent Platform.
Por qué usar el SDK de Vertex AI
Se recomienda el SDK de Agent Platform para Python si eres un ingeniero con experiencia en aprendizaje automático (AA) e inteligencia artificial (IA), o si eres un científico de datos y deseas automatizar tu flujo de trabajo de manera programática. El SDK de Agent Platform para Python es similar a la biblioteca cliente de Python de Agent Platform de Gemini Enterprise, excepto que el SDK de Vertex AI es de mayor nivel y menos detallado. Para obtener más información, consulta Diferencias entre el SDK y la biblioteca cliente.
Escribe código con el SDK de Agent Platform para Python
Para usar el SDK de Agent Platform para Python, haz lo siguiente:
Instala el paquete
google-cloud-aiplatform, que incluye el SDK de Agent Platform para Python y la biblioteca cliente de Agent Platform de Gemini Enterprise para Python. Para ello, ejecuta el siguiente comando en tu entorno virtual:pip install --upgrade google-cloud-aiplatformUsa el siguiente código para importar el espacio de nombres
google.cloud.aiplatform:from google.cloud import aiplatform-
Si usas una shell local, crea credenciales de autenticación locales para tu cuenta de usuario:
gcloud auth application-default login
No es necesario que lo hagas si usas Cloud Shell.
Si se devuelve un error de autenticación y usas un proveedor de identidad (IdP) externo, confirma que accediste a la gcloud CLI con tu identidad federada.
Obtén información sobre el SDK de Agent Platform para Python
Consulta la siguiente documentación:
Descripción general de la clase del SDK de Vertex AI: presenta las clases y la funcionalidad clave en el SDK de Vertex AI.
Referencia de Python para Gemini Enterprise Agent Platform: Contiene documentación de referencia para todos los espacios de nombres, clases, métodos y propiedades en el paquete
google-cloud-aiplatform, que incluye el SDK de Vertex AI, la vista previa del SDK de Vertex AI y las bibliotecas cliente de Gemini Enterprise Agent Platform.
Prueba los instructivos y las muestras de código
En los instructivos de notebooks, se muestra cómo usar el SDK de Agent Platform para Python como parte de un flujo de trabajo más grande. Para obtener más información, consulta los instructivos de notebooks de Gemini Enterprise Agent Platform.
En las muestras de código del repositorio de GitHub del SDK de Agent Platform para Python, se muestra cómo completar tareas individuales. Para obtener más información, consulta el repositorio de GitHub del SDK de Agent Platform para Python.
Comprende las diferencias del SDK de Vertex AI y la biblioteca cliente
Cuando instalas el SDK de Agent Platform para Python, también se instala la biblioteca cliente de Python de Gemini Enterprise Agent Platform. El SDK de Vertex AI y la biblioteca cliente de Python de la plataforma de agentes de Gemini Enterprise proporcionan una funcionalidad similar con diferentes niveles de detalle. El SDK de Vertex AI opera en un nivel de abstracción mayor que la biblioteca cliente y es adecuado para los flujos de trabajo de ciencia de datos más comunes. Si necesitas una funcionalidad de menor nivel, usa la biblioteca cliente de Python de la plataforma de agentes de Gemini Enterprise.
El SDK de Vertex AI está disponible para Python y hay una biblioteca cliente de la plataforma de agentes de Gemini Enterprise disponible para Python, Java y Node.js. Para obtener información sobre cómo instalar la biblioteca cliente de Java o Node.js, consulta Instala las bibliotecas cliente de la plataforma de agentes de Gemini Enterprise. Si una biblioteca cliente no está disponible en tu lenguaje de programación preferido, puedes usar la API de REST de Gemini Enterprise Agent Platform. Para obtener más información, consulta la referencia de REST de la plataforma de agentes de Gemini Enterprise.
Usa la biblioteca cliente de Python y el SDK de Agent Platform de Gemini Enterprise juntos
Si usas el SDK de Agent Platform para Python y descubres que necesitas mayor flexibilidad o control, o si necesitas un método que no está incluido en el SDK de Vertex AI, puedes usar la biblioteca cliente de Python de Agent Platform de Gemini Enterprise en el mismo flujo de trabajo. La biblioteca cliente de Python de la Agent Platform de Gemini Enterprise usa un espacio de nombres diferente para acceder a la API de Agent Platform. La biblioteca cliente y los espacios de nombres del SDK de Agent Platform para Python se pueden usar en la misma secuencia de comandos de Python; para ello, agrega una línea import para cada uno en la secuencia de comandos de Python.
Importa el espacio de nombres de la biblioteca cliente de Python de la Agent Platform de Gemini Enterprise
El espacio de nombres de la biblioteca cliente de Python de Agent Platform de Gemini Enterprise es google.cloud.aiplatform.gapic. Este espacio de nombres se asigna al espacio de nombres google.cloud.aiplatform_v1. Estos dos espacios de nombres se pueden usar de forma indistinta. Para importar la biblioteca cliente de Python, incluye una de las siguientes opciones en la secuencia de comandos de Python:
from google.cloud import aiplatform_v1
from google.cloud.aiplatform import gapic
¿Qué sigue?
Obtén más información sobre cómo elegir un método de entrenamiento.