Crea una app de agente

Vista previa

Este producto o función está sujeto a las "Condiciones de las Ofertas de Fase Previa a la DG" de la sección Condiciones Generales del Servicio de las Condiciones específicas del Servicio. Los productos y las funciones que se encuentran en la fase previa a la DG están disponibles “tal cual” y podrían tener asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

En esta guía, se muestra cómo compilar y probar una app simple de agente de pedido de camisas. Cuando interactúes con esta app de agente, podrás solicitar la ubicación de la tienda, obtener el horario de atención o hacer un pedido de camisas.

Antes de comenzar

Debes hacer lo siguiente antes de leer esta guía:

1. Si aún no lo has hecho, sigue las instrucciones de setup de Dialogflow.

Acerca de las apps de agente

Una app de agente consta de uno o más agentes. Cada agente tiene un alcance claramente definido y limitado. Un agente tiene los siguientes datos:

X	Elemento
Nombre	Un nombre que se usa para identificar al agente.
Objetivo	Los objetivos son descripciones de alto nivel de lo que el agente debe lograr.
Instrucciones	Las instrucciones son pasos de alto nivel que deben seguirse para lograr el objetivo del agente.
Ejemplos	Los ejemplos son conversaciones de muestra entre un usuario final y el agente. Estos son ejemplos efectivos de instrucciones con ejemplos limitados para el LLM.

Crea la aplicación

Para crear la aplicación, sigue estos pasos:

1. Ve a la consola de Vertex AI Conversation:

   Consola de Vertex AI Conversation

2. Selecciona tu proyecto en el menú desplegable de la consola.

3. Si aún no activaste la API, lee y acepta las Condiciones del Servicio y, luego, haz clic en Continuar y activar la API.

4. Haz clic en Create a New App o New App.

5. Selecciona Agente.

6. Proporciona "asistente de pedidos de camisetas" como nombre de la app.

7. Selecciona una región.

8. Haz clic en Crear.

9. La interfaz de usuario te lleva al agente predeterminado llamado Agente predeterminado.

10. Haz clic en el botón Atrás para ver la lista de agentes.

Crea el agente de pedido

El agente Order controla los pedidos de camisetas. Para crear este agente, sigue estos pasos:

1. Haz clic en Crear.
2. Ingresa el nombre: Order.

3. Ingresa el siguiente objetivo:

   You are a shirt store ordering agent. Help customers purchase shirts.
   Help the customer choose a size and color.
   The shirts come in small, medium, and large.
   The shirts can be red, green, or blue.
   

4. Ingresa las siguientes instrucciones:

   - If the customer has not provided a size, ask them to choose a size.
   - If the customer has not provided a color, ask them to choose a color.
   - Once the customer has selected a size and color for the shirt,
     repeat the selection to the customer, and ask them to confirm the selection.
   - Once the customer has confirmed their selection,
     let them know that the shirt is now ordered.
   - Do not provide prices or collect payment.
   - Do not collect the customer's name or address.
   

5. Haz clic en Guardar.

   

6. Haz clic en el botón Atrás para volver a la lista de agentes.

Crea el agente de información

El agente de Información maneja las preguntas sobre la tienda. Para crear este agente, sigue estos pasos:

1. Haz clic en Crear.
2. Ingresa el nombre: Information.

3. Ingresa el siguiente objetivo:

   You provide information about a shirt store.
   The store is open between 8 AM and 6 PM every day.
   The store is located at 1007 Mountain Drive, Gotham City, NJ.
   

4. Ingresa las siguientes instrucciones:

   - If the customer asks for the store location, provide them with the address.
   - If the customer asks for the store hours, provide them with the hours.
   

5. Haz clic en Guardar.

6. Haz clic en el botón Atrás para volver a la lista de agentes.

Actualiza el agente predeterminado

Cuando creaste la aplicación por primera vez, se creó un agente predeterminado para ti. Este agente debe dirigir la conversación a los agentes adecuados con objetivos específicos. En las siguientes instrucciones, podrás ver cómo el agente predeterminado hace referencia a los otros agentes. Para actualizar este agente, sigue estos pasos:

1. Haz clic en el agente predeterminado. Este agente tiene una estrella destacada.

2. Ingresa el siguiente objetivo:

   You are an agent for a shirt store.
   Your name is "Samantha".
   Your job is to direct customers to other agents based on the customer's questions.
   

3. Ingresa las siguientes instrucciones:

   - If the customer hasn't been greeted yet, greet the customer,
     introduce yourself, and ask the user how you can help.
   - If the customer wants information about the store,
     route them to ${AGENT: Information}
   - If the customer wants to purchase a shirt,
     route them to ${AGENT: Order}
   

4. Haz clic en Guardar.

5. Haz clic en el botón Atrás para volver a la lista de agentes.

Proporciona ejemplos.

En este punto, ya puedes usar tu agente. Sin embargo, debes proporcionar ejemplos para garantizar respuestas de calidad.

Puedes proporcionar ejemplos de forma manual de la pestaña Ejemplos cuando tienes un agente abierto. Sin embargo, suele ser más fácil tener una conversación con el agente que funciona y guardar la conversación como ejemplo.

Una conversación de ejemplo con un agente predeterminado es breve. Este agente solo necesita dirigirte a otro agente. Para tener una conversación con el agente predeterminado, haz lo siguiente:

1. Cierra o cancela cualquier panel que pueda estar presente en el lado derecho de la pantalla. Deseas ver el panel del simulador, que contiene la opción Envía un mensaje para ver cómo responde tu agente.
2. Selecciona el agente predeterminado.
3. Selecciona el modelo: gemini-pro.
4. En el cuadro de texto que dice Enter user input, escribe Hello y presiona Intro.
5. El agente responde con un saludo.

Para guardar esta conversación como ejemplo, haz lo siguiente:

1. Haz clic en el botón Save as an example cerca de la parte superior derecha de la interfaz.
2. Se abrirá el panel de edición de ejemplo. Puedes usar este editor para agregar, editar, borrar o reordenar acciones.
3. Proporciona el nombre de ejemplo: Greeting.
4. Actualiza las respuestas del agente según sea necesario.

5. Haz clic en Guardar.

   

Agrega un ejemplo de ubicación para el agente de información:

1. Cierra o cancela cualquier panel que pueda estar presente en el lado derecho de la pantalla. Si es necesario, restablece la conversación con el botón restart_alt.
2. Selecciona el agente de información.
3. Selecciona el modelo: gemini-pro.
4. Ingresa el mensaje: Where are you located?.
5. El agente responde con una ubicación.
6. Guarda esta conversación como un ejemplo llamado Location. Solo los ejemplos de agentes predeterminados pueden comenzar con una acción del usuario, por lo que debes borrar la acción que contenga la pregunta “¿Dónde te encuentras?”.

Agrega un ejemplo de horario para el agente de información:

1. De manera similar a los pasos anteriores, pero ingresa el mensaje What are your hours? y nombra el ejemplo: Hours.

Agrega un ejemplo de selección para el agente de pedido:

1. De manera similar a los pasos anteriores, asigna el nombre Selection al ejemplo, selecciona el agente de pedidos y envía los siguientes mensajes:

   • I want to buy a shirt
   • Large
   • Green
   • Yes

   

Prueba la app del agente

Tu app de agente ya está lista para la prueba. Abre el panel del simulador y conversa con el agente. No es necesario que tengas las mismas conversaciones de arriba. Por ejemplo, puedes preguntarle a esta aplicación de agente qué colores están disponibles para las camisas. Si no obtienes el comportamiento deseado, perfeccionar los ejemplos y crear otros nuevos mejorará las respuestas.

Interactúa con la app del agente a través de la API

Consulta Interacciones con la API.