Compila un agente con playbooks

Crea y prueba un agente de pedidos de camisas con guías. Usa el agente para solicitar la ubicación de la tienda, obtener el horario de atención o realizar un pedido de camisas.

Antes de comenzar

Si aún no lo hiciste, sigue las instrucciones de configuración.

Información sobre las guías

Un agente consta de una o más guías. Cada guía tiene un alcance claramente definido y limitado. En la siguiente tabla, se describen los datos de una guía:

X	Elemento
Nombre	Es un nombre que se usa para identificar la guía.
Objetivo	Los objetivos son descripciones generales de lo que debería lograr la guía.
Instrucciones	Las instrucciones son pasos generales que se deben seguir para lograr el objetivo de la guía.
Ejemplos	Los ejemplos son conversaciones de muestra entre un usuario final y el agente. Estos son, en efecto, ejemplos de instrucciones con varios ejemplos para el LLM.

Crea un agente

Para crear un agente, haz lo siguiente:

1. Ve a https://conversational-agents.cloud.google.com/.
2. Si aún no lo hiciste, selecciona o crea un proyecto.
3. Haz clic en Create agent.
4. Haz clic en Build your own.
5. Ingresa "Shirt Ordering - Playbooks" como nombre del agente.
6. Ingresa una ubicación.
7. Ingresa una zona horaria.
8. Ingresa un idioma predeterminado.
9. Selecciona Playbook para la opción Conversation start.
10. Haz clic en Crear.
11. La interfaz de usuario te lleva a la guía predeterminada llamada Default Generative Playbook.
12. Haz clic en Atrás para volver a la lista de guías.

Crea la guía de pedidos

La guía Order controla los pedidos de camisas.

Para crear la guía, haz lo siguiente:

1. Haz clic en Crear.
2. Selecciona la opción Task playbook.
3. Ingresa el nombre de la guía: Order.

4. Ingresa el siguiente objetivo:

   You are a shirt store ordering assistant. 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.
   

5. 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.
   

6. Haz clic en Guardar.

7. Haz clic en Atrás para volver a la lista de guías.

Crea la guía de información

La guía Information controla las preguntas sobre la tienda.

Para crear la guía, haz lo siguiente:

1. Haz clic en Crear.
2. Selecciona la opción Task playbook.
3. Ingresa el nombre de la guía: Information.

4. 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.
   

5. 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.
   

6. Haz clic en Guardar.

7. Haz clic en Atrás para volver a la lista de guías.

Actualiza la guía predeterminada

Cuando creas el agente por primera vez, se crea una guía predeterminada. Esta guía dirige la conversación a las guías adecuadas con objetivos específicos. Puedes ver cómo la guía predeterminada hace referencia a las otras guías en las siguientes instrucciones.

Para actualizar la guía, haz lo siguiente:

1. Haz clic en la guía predeterminada, que está marcada con una estrella.

2. Ingresa el siguiente objetivo:

   You are an assistant for a shirt store.
   Your name is "Samantha".
   Your job is to direct customers to other playbooks 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 how you can help.
   - If the customer wants information about the store,
     route them to ${PLAYBOOK: Information}
   - If the customer wants to purchase a shirt,
     route them to ${PLAYBOOK: Order}
   

4. Haz clic en Guardar.

5. Observa que las referencias de la guía están destacadas porque aún no hay ejemplos. Los agregarás en la siguiente sección.

6. Haz clic en Atrás para volver a la lista de guías.

Proporciona ejemplos

La guía es funcional, pero proporcionar ejemplos garantiza respuestas de calidad.

Puedes proporcionar ejemplos desde la pestaña Examples cuando se abre una guía. Sin embargo, suele ser más fácil tener una conversación con el agente y guardar la conversación como ejemplo.

Una conversación de guía predeterminada es breve. Esta guía debe dirigir la conversación a otra guía.

Para tener una conversación con la guía predeterminada, haz lo siguiente:

1. Cierra o cancela cualquier panel que pueda estar presente en el lado derecho de la pantalla.
2. Presiona el botón del simulador en la navegación de la fila superior.
3. En el recurso, selecciona la guía predeterminada.
4. Usa el modelo predeterminado o selecciona una alternativa.
5. En el campo entrada del usuario , ingresa Hello y, luego, presiona Intro.
6. La guía responde con un saludo.

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

1. Selecciona la guía predeterminada en la lista Invocations.
2. Haz clic en Save as example.
3. En el panel del editor de ejemplos, agrega, edita, borra o reordena acciones.
4. Ingresa Greeting como nombre del ejemplo.
5. Actualiza las respuestas de la guía según sea necesario.
6. En la sección End example with output information, ingresa The user is greeted. en el campo Summary.
7. Haz clic en Guardar.

Agrega un ejemplo de ubicación para la guía de información:

1. Cierra o cancela cualquier panel en el lado derecho de la pantalla.
2. Si es necesario, restablece la conversación con el botón reset restart_alt.
3. Selecciona la guía de información en el menú Start Resource del simulador.
4. Escribe Where are you located? y presiona Intro.
5. Selecciona la guía de información en el menú Invocations.
6. Haz clic en Save as example.
7. Ingresa Location como nombre del ejemplo.
8. Borra la acción que contiene Where are you located? porque solo los ejemplos de guías predeterminadas pueden comenzar con una acción del usuario.
9. Expande la sección Summary of the preceding conversation y, luego, ingresa The customer asked "Where are you located?" en el campo Starts example with input information.
10. Expande la sección Summary of the playbook execution y, luego, ingresa The store is located at 1007 Mountain Drive, Gotham City, NJ. en el campo End example with output information.
11. Haz clic en Guardar.

Agrega un ejemplo de horario para la guía de información:

1. Selecciona la guía de información en el simulador.
2. Ingresa el mensaje What are your hours?.
3. Guarda la conversación como un ejemplo llamado Hours.

Para agregar un ejemplo de selección para la guía de pedidos, sigue estos pasos:

1. Nombra el ejemplo Selection.
2. Selecciona la guía de pedidos.
3. Envía los siguientes mensajes:
   • I want to buy a shirt
   • Large
   • Green
   • Yes

Prueba el agente

Tu agente ya está listo para probarse. Abre el panel del simulador y ten una conversación con el agente. Puedes tener conversaciones diferentes de las que se describieron anteriormente. Por ejemplo, puedes preguntarle a este agente qué colores están disponibles para las camisas. Si no obtienes los resultados necesarios, refinar o agregar ejemplos mejorará las respuestas.

Interactúa con el agente mediante la API

Para obtener más información sobre la interacción con la API, consulta Interacciones con la API.