En esta guía, se muestra cómo compilar y probar un agente simple de pedido de camisas con libros de jugadas. 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 acerca de las guías
Un agente se compone de uno o más libros de jugadas. Cada guía tiene un alcance claramente definido y limitado. Una guía de instrucciones tiene los siguientes datos:
| X | Elemento |
|---|---|
| Nombre | Es un nombre que se usa para identificar el libro de jugadas. |
| Objetivo | Los objetivos son descripciones generales de lo que debe lograr la guía. |
| Instrucciones | Las instrucciones son pasos de alto nivel que se deben seguir para lograr el objetivo de la guía de referencia. |
| Ejemplos | Los ejemplos son conversaciones de muestra entre un usuario final y el agente. Estos ejemplos son, en efecto, ejemplos de instrucciones de varias imágenes para el LLM. |
Crea el agente
Para crear el agente, sigue estos pasos:
Ve a la consola de agentes conversacionales:
Si aún no lo hiciste, selecciona o crea un proyecto.
Haz clic en Create Agent.
Haz clic en Crea tu propio.
Proporciona "Shirt Ordering - Playbooks" para el nombre del agente.
Proporciona una ubicación.
Proporciona una zona horaria.
Proporciona un idioma predeterminado.
Selecciona Guía de respuestas para la opción Inicio de la conversación.
Haz clic en Crear.
La interfaz de usuario te dirige al plan de acción predeterminado, llamado 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 de pedidos controla los pedidos de camisas. Para crear esta guía, sigue estos pasos:
- Haz clic en Crear.
- Ingresa el nombre de la guía de instrucciones:
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 libros de jugadas.
Crea la guía de información
En la guía Información, se abordan las preguntas sobre la tienda. Para crear esta guía, sigue estos pasos:
- Haz clic en Crear.
- Ingresa el nombre de la guía de instrucciones:
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 libros de jugadas.
Actualiza el playbook predeterminado
Cuando creaste la aplicación por primera vez, se creó una guía de acción predeterminada. Esta guía debe dirigir la conversación hacia las guías adecuadas con objetivos específicos. En las instrucciones que aparecen a continuación, puedes ver cómo la guía predeterminada hace referencia a las otras guías. Para actualizar esta guía, sigue estos pasos:
- Haz clic en la guía de instrucciones 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 se destacan 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 libros de jugadas.
Proporciona ejemplos
En este punto, tu guía de trabajo está funcional. Sin embargo, debes proporcionar ejemplos para garantizar respuestas de calidad.
Puedes proporcionar ejemplos de forma manual desde la pestaña Ejemplos cuando tengas una guía de jugadas abierta. Sin embargo, a menudo es más fácil tener una conversación con la guía de trabajo en funcionamiento y guardarla como ejemplo.
Una conversación de ejemplo con un libro de jugadas predeterminado es breve. Esta guía solo debe dirigirte a otra. Para tener una conversación con la guía de respuestas predeterminada, sigue estos pasos:
- 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.
- Para el recurso, selecciona el playbook predeterminado.
- Usa el modelo predeterminado o selecciona una alternativa.
- En el cuadro de texto que dice Enter user input, escribe
Helloy, luego, presiona Intro. - La guía de respuestas responde con un saludo.
Para guardar esta conversación como ejemplo, sigue estos pasos:
- Selecciona el playbook predeterminado en el menú desplegable Invocations.
- Haz clic en el botón Guardar como ejemplo, 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 de ejemplo:
Greeting. - Actualiza las respuestas de la guía según sea necesario.
- Desplázate hacia abajo hasta el ejemplo final con información de salida
y, luego, ingresa
The user is greeted.en la sección Resumen. - Haz clic en el ícono de 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 botón de restablecimiento restart_alt.
- Selecciona la guía de información en la lista 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 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 borrar la acción que contiene "¿Dónde te encuentras?". Solo los ejemplos de libros de jugadas predeterminados pueden comenzar con una acción del usuario.
- Para proporcionarle al ejemplo el contexto que inició la conversación, expande la sección Resumen de la conversación anterior… y, luego, ingresa lo siguiente en el campo Empieza el ejemplo con información de entrada:
The customer asked "Where are you located?". - Para proporcionarle al ejemplo el contexto que completa la conversación, expande la sección Resumen de la ejecución de la guía… y, luego, ingresa lo siguiente en el campo Finalizar ejemplo con información de salida:
The store is located at 1007 Mountain Drive, Gotham City, NJ.. - Haz clic en el ícono de guardar.
Agrega un ejemplo de horas para la guía de información:
- De forma similar a los pasos anteriores, ingresa el mensaje
What are your hours?y asígnale el nombreHoursal ejemplo.
Agrega un ejemplo de selección para la guía de orden:
De forma similar a los pasos anteriores, pero asigna el nombre
Selectional ejemplo, selecciona la guía de orden y envía los siguientes mensajes:I want to buy a shirtLargeGreenYes
Prueba el agente
Tu agente ya está listo para probarse. Abre el panel del simulador y conversa con el agente. No es necesario que tengas las mismas conversaciones que se mencionaron anteriormente. Por ejemplo, puedes preguntarle a este agente qué colores están disponibles para las camisas. Si no obtienes el comportamiento deseado, mejorarás las respuestas si defines mejor tus ejemplos y creas otros nuevos.
Interactúa con el agente mediante la API
Consulta Interacciones con la API.