En esta guía se explica cómo crear y probar un agente sencillo para pedir camisetas con cuadernos de jugadas. Cuando interactúes con este agente, podrás preguntarle por la ubicación de la tienda, el horario de apertura o hacer un pedido de una camisa.
Antes de empezar
Antes de leer esta guía, debes hacer lo siguiente:
- Si aún no lo has hecho, sigue las instrucciones de configuración.
Acerca de las guías
Un agente se compone de una o varias guías. Cada guía tiene un ámbito claramente definido y limitado. Una guía incluye los siguientes datos:
| X | Elemento |
|---|---|
| Nombre | Nombre que se usa para identificar el cuaderno de estrategias. |
| Objetivo | Los objetivos son descripciones generales de lo que debe conseguir la guía. |
| Instrucciones | Las instrucciones son pasos generales que se deben seguir para alcanzar el objetivo del manual de procedimientos. |
| Ejemplos | Los ejemplos son conversaciones de muestra entre un usuario final y el agente. Estos ejemplos son ejemplos de peticiones de pocos disparos para el LLM. |
Crear el agente
Para crear el agente, sigue estos pasos:
Ve a la consola Conversational Agents:
Si aún no lo has hecho, selecciona o crea un proyecto.
Haz clic en Crear agente.
Haz clic en Crea tu propio.
Asigna el nombre "Shirt Ordering - Playbooks" al agente.
Proporciona una ubicación.
Indica una zona horaria.
Proporciona un idioma predeterminado.
Selecciona Guía en la opción Inicio de conversación.
Haz clic en Crear.
La interfaz de usuario te lleva al manual de respuestas predefinido, llamado Manual de respuestas predefinido.
Haz clic en el botón para volver y ver la lista de guías.
Crear la guía de pedidos
El manual de respuestas Pedido gestiona los pedidos de camisetas. Para crear esta guía, sigue estos pasos:
- Haz clic en Crear.
- Selecciona la opción Playbook de tareas.
- Introduce el nombre de la guía:
Order. Introduce 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.Introduce 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 para volver a la lista de carteras.
Crear la guía de información
El manual de respuestas Información responde a las preguntas sobre la tienda. Para crear esta guía, sigue estos pasos:
- Haz clic en Crear.
- Selecciona la opción Playbook de tareas.
- Introduce el nombre de la guía:
Information. Introduce 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.Introduce 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 para volver a la lista de carteras.
Actualizar el manual de respuestas predeterminado
Cuando creaste la aplicación por primera vez, se creó un manual de estrategias predeterminado. Esta guía debe dirigir la conversación a las guías adecuadas con objetivos específicos. En las instrucciones que se indican a continuación, puedes ver cómo la guía predeterminada hace referencia a las demás guías. Para actualizar esta guía, sigue estos pasos:
- Haz clic en el manual de estrategias predeterminado. Esta guía tiene una estrella destacada.
Introduce 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.Introduce 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 se han destacado porque aún no hay ejemplos. Se añadirán en la siguiente sección.
Haz clic en el botón para volver a la lista de carteras.
Proporciona ejemplos
En este punto, tu plan de acción ya funciona. Sin embargo, debes proporcionar ejemplos para asegurarte de que las respuestas sean de calidad.
Puedes proporcionar ejemplos manualmente desde la pestaña Ejemplos cuando tengas una guía abierta. Sin embargo, a menudo es más fácil mantener una conversación con el manual de respuestas que funciona y guardar la conversación como ejemplo.
Una conversación de ejemplo con un libro de jugadas predeterminado es breve. Esta guía solo tiene que dirigirte a otra. Para mantener una conversación con el manual de respuestas predeterminado, sigue estos pasos:
- Cierra o cancela cualquier panel que pueda aparecer en la parte derecha de la pantalla.
- En la fila superior de navegación, haz clic en el botón del simulador .
- En Recurso, selecciona el manual predeterminado.
- Usa el modelo predeterminado o selecciona una alternativa.
- En el cuadro de texto Introduce la entrada del usuario,
escribe
Helloy pulsa Intro. - El manual responde con un saludo.
Para guardar esta conversación como ejemplo, sigue estos pasos:
- Selecciona el manual de respuestas predeterminado en el menú desplegable Invocaciones.
- Haz clic en el botón Guardar como ejemplo, situado cerca de la parte superior derecha de la interfaz.
- Se abrirá el panel del editor de ejemplos. Puedes usar este editor para añadir, editar, eliminar o reordenar acciones.
- Proporciona el nombre de ejemplo:
Greeting. - Actualiza las respuestas de la guía según sea necesario.
- Desplázate hacia abajo hasta Finalizar ejemplo con información de salida
e introduce
The user is greeted.en la sección Resumen. - Haz clic en el icono de guardar.
Añade un ejemplo de ubicación para el manual de información:
- Cierra o cancela cualquier panel que pueda aparecer en la parte derecha de la pantalla.
- Si es necesario, reinicia la conversación con el botón de restablecer restart_alt.
- Selecciona el manual de instrucciones de información en el menú desplegable Iniciar recurso del simulador.
- Introduce el mensaje:
Where are you located?. - El manual responde con una ubicación.
- Seleccione el manual de respuestas de información en el menú desplegable Invocaciones.
- Haz clic en el botón Guardar como ejemplo.
- Proporciona el nombre de ejemplo:
Location. - Antes de guardar esta conversación como ejemplo, debes eliminar la acción que contiene "¿Dónde te encuentras?". Solo los ejemplos de cuadernos de estrategias predeterminados pueden empezar con una acción del usuario.
- Para proporcionar el ejemplo con el contexto que inició la conversación, amplía la sección Resumen de la conversación anterior... y escribe lo siguiente en el campo Empieza el ejemplo con información de entrada:
The customer asked "Where are you located?". - Para proporcionar el ejemplo con el contexto que completa la conversación, amplía la sección Resumen de la ejecución del manual...
e introduce lo siguiente
en el campo Termina el ejemplo con información de salida:
The store is located at 1007 Mountain Drive, Gotham City, NJ.. - Haz clic en el icono de guardar.
Añade un ejemplo de horario a la guía de información:
- Al igual que en los pasos anteriores, escribe el mensaje
What are your hours?y asigna el nombreHoursal ejemplo.
Añade un ejemplo de selección para el playbook de pedidos:
De forma similar a los pasos anteriores, pero asigna el nombre
Selectional ejemplo, selecciona el manual de respuestas, y envía los siguientes mensajes:I want to buy a shirtLargeGreenYes
Probar el agente
Tu agente ya está listo para probarse. Abre el panel del simulador y mantén una conversación con el agente. No es necesario que tengas las mismas conversaciones que arriba. Por ejemplo, puedes preguntarle a este agente qué colores hay disponibles para las camisas. Si no obtienes el resultado que quieres, puedes mejorar las respuestas perfeccionando los ejemplos y creando otros nuevos.
Interactuar con el agente mediante la API
Consulta Interacciones con la API.