Algunos productos y funciones están en proceso de cambiar de nombre. Las funciones de flujo y de la guía generativa también se migrarán a una sola consola consolidada. Consulta los detalles.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Compila un agente con playbooks

En esta guía, se muestra cómo crear y probar un agente simple de pedido de camisas con guías. Cuando interactúas con este agente, puedes solicitar la ubicación de la tienda, obtener el horario de atención o realizar un pedido de camisas.

Antes de comenzar

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

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

Información sobre las guías

Un agente se compone de una o más guías. Cada guía tiene un alcance claramente definido y limitado. Una guía tiene los siguientes datos:

X	Elemento
Nombre	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 el agente

Para crear el agente, haz lo siguiente:

Ve a la consola de Conversational Agents:

Consola de Conversational Agents
Si aún no lo hiciste, selecciona o crea un proyecto.
Haz clic en Create agent.
Haz clic en Build your own.
Proporciona "Shirt Ordering - Playbooks" para el nombre del agente.
Proporciona una ubicación.
Proporciona una zona horaria.
Proporciona un idioma predeterminado.
Selecciona Playbook para la opción Conversation start.
Haz clic en Crear.
La interfaz de usuario te lleva a la guía predeterminada llamada Default Generative Playbook.
Haz clic en el botón Atrás para ver la lista de guías.

Crea la guía de pedidos

La guía Order controla los pedidos de camisas. Para crear esta guía, haz lo siguiente:

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

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.

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.

Haz clic en Guardar.
Haz clic en el botón 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 esta guía, haz lo siguiente:

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

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.

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.

Haz clic en Guardar.
Haz clic en el botón Atrás para volver a la lista de guías.

Actualiza la guía predeterminada

Cuando creaste la aplicación por primera vez, se creó una guía predeterminada. Esta guía debe dirigir la conversación a las guías adecuadas con objetivos específicos. En las siguientes instrucciones, puedes ver cómo la guía predeterminada hace referencia a las otras guías. Para actualizar esta guía, haz lo siguiente:

Haz clic en la guía predeterminada. Esta guía tiene una estrella destacada.

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.

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 ${PLAYBOOK: Information}
- If the customer wants to purchase a shirt,
  route them to ${PLAYBOOK: Order}

Haz clic en Guardar.
Ten en cuenta que las referencias de la guía están destacadas porque aún no hay ejemplos. Se agregarán en la siguiente sección.
Haz clic en el botón Atrás para volver a la lista de guías.

Proporciona ejemplos

En este punto, tu guía es funcional. Sin embargo, debes proporcionar ejemplos para garantizar respuestas de calidad.

Puedes proporcionar ejemplos de forma manual desde la pestaña Examples cuando tienes una guía abierta. Sin embargo, suele ser más fácil tener una conversación con la guía en funcionamiento y guardar la conversación como ejemplo.

Una conversación de ejemplo con una guía predeterminada es breve. Esta guía solo necesita dirigirte a otra guía. Para mantener una conversación con la guía predeterminada, haz lo siguiente:

Cierra o cancela cualquier panel que pueda estar presente en el lado derecho de la pantalla.
Haz clic en el botón del simulador en la navegación de la fila superior.
En el recurso, selecciona la guía predeterminada.
Usa el modelo predeterminado o selecciona una alternativa.
En el cuadro de texto que dice Enter user input, escribe Hello y, luego, presiona Intro.
La guía responde con un saludo.

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

Selecciona la guía predeterminada en el menú desplegable Invocations.
Haz clic en el botón Save as example cerca de la parte superior derecha de la interfaz.
Se abrirá el panel del editor de ejemplos. Puedes usar este editor para agregar, editar, borrar o reordenar acciones.
Proporciona el nombre del ejemplo: Greeting.
Actualiza las respuestas de la guía según sea necesario.
Desplázate hacia abajo hasta End example with output information y, luego, ingresa The user is greeted. en la sección Summary.
Haz clic en el ícono Guardar.

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

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 reset restart_alt botón.
Selecciona la guía de información en el menú desplegable Start Resource del simulador.
Ingresa el mensaje: Where are you located?.
La guía responde con una ubicación.
Selecciona la guía de información en el menú desplegable Invocations.
Haz clic en el botón Save as example.
Proporciona el nombre del ejemplo: Location.
Antes de guardar esta conversación como ejemplo, debes borrar la acción que contiene "Where are you located". Solo los ejemplos de guías predeterminadas pueden comenzar con una acción del usuario.
Para proporcionar el ejemplo con el contexto que inició la conversación, expande la sección Summary of the preceding conversation... y, luego, ingresa lo siguiente en el campo Starts example with input information: The customer asked "Where are you located?".
Para proporcionar el ejemplo con el contexto que completa la conversación, expande la sección Summary of the playbook execution... y, luego, ingresa lo siguiente en el campo End example with output information : The store is located at 1007 Mountain Drive, Gotham City, NJ..
Haz clic en el ícono Guardar.

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

De forma similar a los pasos anteriores, ingresa el mensaje: What are your hours? y asigna el nombre Hours al ejemplo.

Agrega un ejemplo de selección para la guía de pedidos:

De forma similar a los pasos anteriores, asigna el nombre Selection al ejemplo, selecciona la guía de pedidos y envía los siguientes mensajes:
- I want to buy a shirt
- Large
- Green
- Yes

Prueba el agente

Tu agente ya está listo para la prueba. Abre el panel del simulador y mantén una conversación con el agente. No es necesario que tengas las mismas conversaciones que antes. Por ejemplo, puedes preguntarle a este agente qué colores están disponibles para las camisas. Si no obtienes el comportamiento deseado, refinar tus ejemplos y crear otros nuevos mejorará las respuestas.