1. Antes de comenzar
En este codelab a tu propio ritmo, aprenderás a crear agentes de IA con Vertex AI Agent Builder de Google Cloud. En cada paso, se destacará una función específica de Agent Builder y se explicará su propósito.
Requisitos previos
- Conocimientos básicos sobre la IA generativa en Google Cloud
- Conocimientos básicos sobre los conceptos de agentes de IA
Qué aprenderás
- Cómo crear un agente de IA simple con Vertex AI Agent Builder
- Cómo conectar un almacén de datos para ejecutar el agente creado
Requisitos
- Una mente curiosa
- Una computadora que funcione y una red Wi-Fi confiable
- Un proyecto de Google Cloud con facturación adjunta
2. Cómo diseñar tu primer agente de IA
Ya está todo listo para crear tu propio agente de IA. Pero antes de comenzar con el desarrollo, es fundamental establecer una visión clara para tu agente. Hazte estas preguntas clave:
- ¿Qué problema solucionará? ¿Automatizará tareas, proporcionará información, ofrecerá entretenimiento o facilitará la exploración creativa?
- ¿Cuáles son sus funciones principales? ¿Ejecutará tareas o delegará tareas? ¿Generará texto o una combinación de diferentes medios?
- ¿Cuáles son sus limitaciones? ¿Podrá hacer todo de forma autónoma?
- ¿Qué personalidad o arquetipo debe tener? ¿Será formal, informal, humorístico, útil o informativo?
- ¿Cuáles son las métricas de éxito? ¿Cómo medirás la eficacia del agente?
Con el fin de acelerar el proceso, aquí encontrarás las respuestas a esas preguntas para el agente de viajes que crearás hoy:
- ¿Qué problema resolverá?
- Planificar un viaje puede ser abrumador y llevar mucho tiempo. Este agente de viajes ayudará a los usuarios a descubrir destinos, planificar itinerarios, reservar vuelos y alojamientos.
- ¿Cuáles son sus funciones principales?
- El agente debería poder
- responder preguntas sobre destinos, como requisitos de visa
- planificar itinerarios que funcionen para los horarios y objetivos de los usuarios
- reservar vuelos y alojamientos
- ¿Cuáles son sus limitaciones?
- Es posible que el agente no pueda responder consultas complicadas de forma predeterminada.
- El agente no podrá generar imágenes visuales
- El conocimiento del agente estará limitado por el modelo subyacente.
- ¿Qué personalidad o arquetipo debe tener?
- Este agente debe ser informado, útil y entusiasta por los viajes. Debe poder comunicar la información de forma clara y concisa.
- ¿Cuáles son las métricas de éxito?
- El éxito de este agente se puede medir por el nivel de satisfacción de los usuarios con sus recomendaciones (exploración, planificación, reserva)
3. Compila un agente de IA con Vertex AI Agent Builder
Con Vertex AI Agent Builder, se pueden crear agentes de IA en unos pocos pasos.
Paso 1:
- Ve a Vertex AI Agent Builder.
- Deberías ver la página de bienvenida.
- Haz clic en el botón CONTINUE AND ACTIVATE THE API.
Paso 2:
- Se lo redireccionará a la página de creación de aplicaciones.
- Haz clic en el botón CREATE A NEW APP.
Paso 3:
- Selecciona Agent en la página siguiente.
Paso 4:
- Elige un nombre visible (p. ej., Travel Buddy).
- Selecciona global como Región.
- Haz clic en el botón ACEPTAR Y CREAR.
Paso 5:
- Elige un Nombre del agente (p. ej., Info Agent).
- Agrega un objetivo (p. ej., ayudar a los clientes a responder consultas relacionadas con viajes).
- Definir una instrucción (p.ej.: Saludar a los usuarios y, luego, preguntarles cómo pueden ayudarlos hoy)
- Presiona Save cuando todo esté listo.
Paso 6:
- Selecciona el agente que acabas de crear (p. ej., Info Agent).
- Elige el modelo de IA generativa subyacente para tu agente (p. ej., gemini-1.5-flash).
- Para probar tu agente, conversa con él (es decir, escribe algo en el cuadro de texto "Enter User Input").
¡Felicitaciones! Acabas de crear correctamente un agente de IA con Vertex AI Agent Builder.
4. Cómo adjuntar almacenes de datos al agente
Intenta preguntarle a tu agente cómo llegar a Wakanda (p. ej., "¿Cuál es la mejor manera de llegar a Wakanda?"). Recibirás una respuesta como la siguiente:
Si bien esto es objetivamente correcto, en lugar de simplemente decir “No puedo proporcionar información” y finalizar la conversación, sería más útil para el usuario que el agente sugiriera lugares similares. Este enfoque podría llevar a que los usuarios realmente reserven un viaje a través del agente.
Para que el agente recomiende lugares similares, puedes proporcionarle más información a través de los almacenes de datos. Actúa como una base de conocimiento adicional para que el agente la consulte si no puede responder a las preguntas de los usuarios según sus conocimientos integrados.
Crear un almacén de datos es sencillo. Haz clic en el botón + Almacén de datos en la parte inferior de la página Conceptos básicos del agente.
En la siguiente pantalla, completa la siguiente información:
- Nombre de la herramienta: Ubicación alternativa
- Tipo: Almacén de datos
- Descripción: Usa esta herramienta si la solicitud del usuario contiene una ubicación que no existe
y haz clic en Guardar cuando termines. Esto crea una herramienta de almacén de datos para que el agente se comunique con el almacén de datos, pero aún debes crear un almacén de datos real que contenga la información. Para ello, haz clic en Crear un almacén de datos.
Es posible que veas una ventana emergente en la que se te solicite que aceptes que tus almacenes de datos de búsqueda y conversaciones estén en la región de EE.UU. Si quieres continuar, haz clic en el botón AGREE.
Para continuar con la creación de almacenes de datos, completa el campo Nombre de la empresa (p.ej., Travel Wise) y haz clic en CONTINUAR.
Haz clic en CREATE DATA STORE y selecciona Cloud Storage.
Cuando termines el paso, haz lo siguiente:
- Selecciona Documentos no estructurados (PDF, HTML, TXT y más).
- Haz clic en ARCHIVO.
- Escribe ai-workshops/agents/data/wakanda.txt en la celda.
- Haz clic en el botón CONTINUAR.
Si te interesa, este es el contenido del archivo de texto proporcionado:
Lugares similares a Wakanda
- Oribi Gorge en Sudáfrica: Las formaciones rocosas recuerdan a las Cataratas de los Guerreros en Wakanda.
- Cataratas del Iguazú: Ubicadas en la frontera entre Argentina y Brasil, estas enormes cascadas fueron una gran inspiración para las Cataratas del Guerrero.
- Sumérgete en la cultura de Wakanda: Lee los cómics de Black Panther, mira las películas y explora recursos en línea para obtener más información sobre la cultura, el idioma y la tecnología de Wakanda.
- Visita un parque temático de Disney: Si bien todavía no hay un territorio dedicado a Wakanda, puedes conocer a Pantera Negra en Disneyland o en un crucero por Marvel Day en Sea Disney.
En la página siguiente, asigna un nombre a tu almacén de datos (p.ej., Wakanda Alternative) y haz clic en CREAR.
Como último paso, SELECCIONA la fuente de datos que acabas de crear y haz clic en CREAR.
Si todo salió bien, deberías ver el almacén de datos creado en la página Almacenes de datos disponibles.
Si haces clic en el almacén de datos (en este caso, Wakanda Alternative), verás más detalles al respecto, incluidos los documentos que se incluyen en el almacén de datos:
Regresa a la página Conceptos básicos del agente y haz clic en Administrar todas las herramientas 
Haz clic en el almacén de datos que creaste anteriormente.
Verás parámetros de configuración nuevos en la sección Almacenes de datos. Si no puedes ver esta configuración nueva de inmediato, significa que Datastore aún está transfiriendo los datos desde Google Cloud Storage. Debería completarse en menos de 5 minutos.
- Elige el almacén de datos que deseas vincular (p. ej., Wakanda Alternative).
- Para evitar que el agente tenga alucinaciones, establece el parámetro de configuración en Muy bajo, que aplica restricciones más estrictas para que el agente no invente cosas.
- Cuando termines de editar, haz clic en el botón Guardar en la parte superior de la página.
Vuelve a la página Conceptos básicos del agente, revisa el almacén de datos (p.ej., Ubicación alternativa) y haz clic en el botón Guardar en la parte superior de la página.
Ya casi terminas. El último paso es incluir la herramienta "Ubicación alternativa" en las instrucciones del agente. Agrega una línea, - Use ${TOOL: Alternative Location} si la solicitud del usuario contiene una ubicación que no existe, a las instrucciones del agente.
Es posible que el borde del cuadro de instrucciones se vuelva rojo, pero no te preocupes. Para guardar el agente, haz clic en el botón Guardar en la parte superior de la página.
Una vez que hayas guardado la configuración del agente, vuelve a preguntarle cómo llegar a Wakanda (p. ej., "¿Cuál es la mejor manera de llegar a Wakanda?"). Recibirás una respuesta diferente, como la siguiente:
¡Felicitaciones! Tu agente ahora recomienda lugares mediante la información proporcionada de un archivo de texto.