GSP1209

Descripción general

El SDK de IA generativa de Google ofrece una interfaz unificada para los servicios de la API de IA generativa de Google. Este SDK simplifica el proceso de integración de las funciones de IA generativa en aplicaciones y servicios para que los desarrolladores utilicen los modelos de IA avanzados de Google para varias tareas. En este lab, explorarás el SDK de IA generativa de Google y aprenderás a conectarte a los servicios de IA, enviar instrucciones diversas y ajustar las respuestas de Gemini. También obtendrás experiencia práctica con técnicas más avanzadas para prepararte y aprovechar el poder de la IA generativa en tus propios proyectos.

Objetivos

En este lab, aprenderás a usar el SDK de IA generativa de Google para Python y a interactuar con los servicios y modelos de IA generativa de Google, incluido Gemini. Explorarás los siguientes temas:

• Instalar el SDK de IA generativa
• Conectarte a un servicio de API
• Enviar instrucciones multimodales y de texto
• Establecer instrucciones del sistema
• Configurar los parámetros del modelo y los filtros de seguridad
• Administrar las interacciones del modelo (chat de varios turnos, transmisión de contenido, solicitudes asíncronas)
• Usar funciones avanzadas (recuento de tokens, almacenamiento de contexto en caché, llamadas a funciones, embeddings de texto)

Requisitos previos

Antes de comenzar este lab, debes tener los siguientes conocimientos:

• Programación de Python básica
• Conceptos generales sobre APIs
• Ejecución de código de Python en un notebook de Jupyter en Agent Platform Workbench

Configuración y requisitos

Antes de hacer clic en el botón Comenzar lab

Lee estas instrucciones. Los labs cuentan con un temporizador que no se puede pausar. El temporizador, que comienza a funcionar cuando haces clic en Comenzar lab, indica por cuánto tiempo tendrás a tu disposición los recursos de Google Cloud.

Este lab práctico te permitirá realizar las actividades correspondientes en un entorno de nube real, no en uno de simulación o demostración. Para ello, se te proporcionan credenciales temporales nuevas que utilizarás para acceder a Google Cloud durante todo el lab.

Para completar este lab, necesitarás lo siguiente:

• Acceso a un navegador de Internet estándar. Se recomienda el navegador Chrome.

• Tiempo para completar el lab (recuerda que, una vez que comienzas un lab, no puedes pausarlo).

Cómo iniciar tu lab y acceder a la consola de Google Cloud

1. Haz clic en el botón Comenzar lab. Si debes pagar por el lab, se abrirá un diálogo para que selecciones la forma de pago. A la derecha, se encuentra el panel Configuración del lab y acceso, que tiene los siguientes elementos:

   • El botón Abrir la consola de Google Cloud
   • Las credenciales temporales (nombre de usuario y contraseña) que debes usar para este lab
   • Otra información para completar el lab (si es necesaria)

   Ten en cuenta que el cronómetro del lab se encuentra cerca de la parte superior de la página y muestra el tiempo restante.

2. Haz clic en Abrir la consola de Google Cloud (o haz clic con el botón derecho y selecciona Abrir el vínculo en una ventana de incógnito si ejecutas el navegador Chrome).

   El lab inicia los recursos y abre otra pestaña, en la que se muestra la página de acceso.

   Sugerencia: Ordena las pestañas en ventanas separadas, una junto a la otra.

   Nota: Si ves el diálogo Elegir una cuenta, haz clic en Usa otra cuenta.

3. De ser necesario, copia el nombre de usuario a continuación y pégalo en el diálogo Acceder.

   {{{user_0.username | "Username"}}}

   También puedes encontrar el nombre de usuario en el panel Configuración del lab y acceso.

4. Haz clic en Siguiente.

5. Copia la contraseña que aparece a continuación y pégala en el diálogo Te damos la bienvenida.

   {{{user_0.password | "Password"}}}

   También puedes encontrar la contraseña en el panel Configuración del lab y acceso.

6. Haz clic en Siguiente.

   Importante: Debes usar las credenciales que te proporciona el lab. No uses las credenciales de tu cuenta de Google Cloud. Nota: Usar tu propia cuenta de Google Cloud para este lab podría generar cargos adicionales.

7. Haz clic para avanzar por las páginas siguientes:

   • Acepta los Términos y Condiciones.
   • No agregues opciones de recuperación ni autenticación de dos factores, ya que esta cuenta es temporal.
   • No te registres para obtener pruebas gratuitas.

Después de un momento, se abrirá la consola de Google Cloud en esta pestaña.

Nota: Para acceder a los productos y servicios de Google Cloud, haz clic en el menú de navegación o escribe el nombre del servicio o producto en el campo Buscar.

Tarea 1: Abre el notebook en Agent Platform Workbench

1. En el menú de navegación () de la consola de Google Cloud, haz clic en Agent Platform > Notebooks > Workbench.

2. Busca la instancia y haz clic en el botón Abrir JupyterLab.

La interfaz de JupyterLab para tu instancia de Workbench se abrirá en una pestaña nueva del navegador.

Tarea 2: Configura el notebook

1. Abre el archivo .

2. En el diálogo Select Kernel, elige Python 3 (Local) en la lista de kernels disponibles.

3. Ejecuta la sección Getting Started del notebook. El ID y la ubicación del proyecto ya están configurados.

Haz clic en Revisar mi progreso para verificar el objetivo. Importar bibliotecas y configurar el notebook

Tarea 3: Interactúa con el modelo

Para obtener más información sobre todos los modelos y las APIs de IA en Agent Platform, consulta Modelos de Google y Model Garden.

Elige un modelo

• Ejecuta la sección Elige un modelo del notebook.

Envía instrucciones de texto

Usa el método generate_content para generar respuestas a tus instrucciones. Puedes pasar texto a generate_content y usar la propiedad .text para obtener el contenido de texto de la respuesta.

• Ejecuta la sección Envía instrucciones de texto del notebook.

Envía instrucciones multimodales

Puedes incluir texto, documentos PDF, imágenes, audio y video en las solicitudes de instrucciones y obtener respuestas de texto o código.

También puedes pasar la URL del archivo en Part.from_uri en la solicitud al modelo directamente.

• Ejecuta la sección Envía instrucciones multimodales del notebook.

Establece las instrucciones del sistema

Las instrucciones del sistema te permiten controlar el comportamiento del modelo. Configura la instrucción del sistema para darle contexto adicional al modelo para comprender la tarea, proporcionar respuestas más personalizadas y cumplir con lineamientos sobre la interacción del usuario.

• Ejecuta la sección Establece instrucciones del sistema del notebook.

Haz clic en Revisar mi progreso para verificar el objetivo. Interactuar con el modelo

Tarea 4: Configura y controla el modelo

Configura los parámetros del modelo

Puedes incluir valores de parámetros en cada llamada que envíes a un modelo para controlar cómo este genera una respuesta. Para obtener más información, consulta Experimenta con los valores de los parámetros.

• Ejecuta la sección Configura los parámetros del modelo del notebook.

Configura filtros de seguridad

La API de Gemini ofrece filtros de seguridad que puedes ajustar en varias categorías de filtros para restringir o permitir ciertos tipos de contenido. Puedes usar estos filtros para ajustar lo que sea apropiado para tu caso de uso. Consulta la página Configura filtros de seguridad para obtener más detalles.

Cuando haces una solicitud al modelo, el contenido se analiza y se le asigna una calificación de seguridad. Puedes imprimir las respuestas del modelo para inspeccionar las calificaciones de seguridad del contenido generado, como en este ejemplo:

• Ejecuta la sección Configura filtros de seguridad del notebook.

Inicia un chat de varios turnos

La API de Gemini te permite tener conversaciones de formato libre en varios turnos.

• Ejecuta la sección Inicia un chat de varios turnos del notebook.

Controla el resultado generado

La capacidad de generación controlada de la API de Gemini te permite limitar el resultado del modelo a un formato estructurado. Puedes proporcionar los esquemas como modelos de Pydantic o una cadena de JSON.

También puedes definir un esquema de respuesta en un diccionario de Python. Usa solo los campos que se indican a continuación. Se ignorará el resto de los campos.

• enum
• items
• maxItems
• nullable
• properties
• required

En este ejemplo, le indicas al modelo que analice los datos de las opiniones sobre productos, extraiga las entidades clave, realice la clasificación de opiniones (varias opciones), proporcione una explicación adicional y genere los resultados en formato JSON.

• Ejecuta la sección Controla el resultado generado del notebook.

Haz clic en Revisar mi progreso para verificar el objetivo. Configurar y controlar el modelo

Tarea 5: Administra la interacción del modelo

Genera transmisión de contenido

De forma predeterminada, el modelo devuelve una respuesta después de completar todo el proceso de generación. También puedes usar el método generate_content_stream para transmitir la respuesta a medida que se genera. El modelo devuelve fragmentos de la respuesta a medida que se generan.

• Ejecuta la sección Genera transmisión de contenido del notebook.

Envía solicitudes asíncronas

Puedes enviar solicitudes asíncronas con el módulo client.aio. Este módulo expone todos los métodos asíncronos análogos que están disponibles en client.

Por ejemplo, client.aio.models.generate_content es la versión asíncrona de client.models.generate_content.

• Ejecuta la sección Envía solicitudes asíncronas del notebook.

Cuenta y procesa tokens

Puedes usar el método count_tokens para calcular la cantidad de tokens de entrada antes de enviar una solicitud a la API de Gemini. Consulta la página Enumera y cuenta tokens para obtener más detalles.

Cuenta tokens

• Ejecuta la sección Cuenta tokens del notebook.

Procesa tokens

• Ejecuta la sección Procesa tokens del notebook.

Haz clic en Revisar mi progreso para verificar el objetivo. Administrar la interacción del modelo

Tarea 6: Funciones avanzadas

Llamadas a funciones

Las llamadas a funciones te permiten proporcionar un conjunto de herramientas que se pueden usar para responder a la instrucción del usuario. Crearás la descripción de una función en tu código y, luego, pasarás esa descripción a un modelo de lenguaje en una solicitud. La respuesta del modelo incluye el nombre de una función que coincide con la descripción y los argumentos con los que se la llama.

Para ver más ejemplos de llamadas a funciones, consulta este lab.

• Ejecuta la sección Llamadas a funciones del notebook.

Haz clic en Revisar mi progreso para verificar el objetivo. Llamar funciones

Usa el almacenamiento de contexto en caché

El almacenamiento de contexto en caché te permite almacenar los tokens de entrada que se usan con frecuencia en una caché dedicada y hacer referencia a ellos para las solicitudes posteriores. Esto elimina la necesidad de pasar repetidamente el mismo conjunto de tokens a un modelo.

Crea una caché

• Ejecuta la sección Crea una caché del notebook.

Usa una caché

• Ejecuta la sección Usa una caché del notebook.

Borra una caché

• Ejecuta la sección Borra una caché del notebook.

Haz clic en Revisar mi progreso para verificar el objetivo. Usar el almacenamiento de contexto en caché

Obtén embeddings de texto

Puedes obtener embeddings de texto para un fragmento de texto con el método embed_content. Todos los modelos producen un resultado con 768 dimensiones de forma predeterminada. Sin embargo, algunos modelos les dan a los usuarios la opción de elegir una dimensionalidad de resultado de entre 1 y 768. Consulta la API de embeddings de texto de Agent Platform para obtener más detalles.

• Ejecuta la sección Obtén embeddings de texto del notebook.

Haz clic en Revisar mi progreso para verificar el objetivo. Obtener embeddings de texto

¡Felicitaciones!

¡Felicitaciones! Exploraste con éxito el SDK de IA generativa de Google, aprendiste a conectarte a los servicios de IA, enviar instrucciones diversas y ajustar mejor las respuestas del modelo de Gemini. También obtuviste experiencia práctica con técnicas más avanzadas, como administrar interacciones, usar el almacenamiento de contexto en caché o, incluso, trabajar con embeddings. Ahora tienes la preparación necesaria para aprovechar el poder de la IA generativa en tus propios proyectos.

Próximos pasos y más información

Consulta los siguientes recursos para obtener más información sobre la IA generativa y Gemini Enterprise Agent Platform:

• Lee la descripción general de los modelos de Gemini de Google DeepMind para obtener información sobre las capacidades principales de los modelos.
• Explora la documentación oficial de Agent Platform para conocer los lineamientos de diseño, implementación y escalamiento.
• Revisa la descripción general de los agentes en Agent Platform para comprender cómo crear y administrar agentes personalizados.
• Mira las playlists sobre IA generativa en YouTube para ver videotutoriales y demostraciones de productos.
• Explora otros notebooks y ejemplos en el repositorio de IA generativa de Google Cloud.
• Explora el repositorio de muestras del Kit de desarrollo de agentes (ADK) de Google para obtener plantillas de agentes personalizadas.

Capacitación y certificación de Google Cloud

Recibe la formación que necesitas para aprovechar al máximo las tecnologías de Google Cloud. Nuestras clases incluyen habilidades técnicas y recomendaciones para ayudarte a avanzar rápidamente y a seguir aprendiendo. Para que puedas realizar nuestros cursos cuando más te convenga, ofrecemos distintos tipos de capacitación de nivel básico a avanzado: a pedido, presenciales y virtuales. Las certificaciones te ayudan a validar y demostrar tus habilidades y tu conocimiento técnico respecto a las tecnologías de Google Cloud.

Última actualización del manual: 18 de mayo de 2026

Prueba más reciente del lab: 4 de mayo de 2026

Copyright 2026 Google LLC. All rights reserved. Google y el logotipo de Google son marcas de Google LLC. Los demás nombres de productos y empresas pueden ser marcas de las respectivas empresas a las que estén asociados.