Compila un agente con guías

Nota: La consola de Agent Builder todavía hace referencia a las guías como agentes. Esto se actualizará pronto a la guía en la consola.

En esta guía, se muestra cómo crear y probar un pedido de camisas sencillo de seguridad usando 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:

1. Si aún no lo has hecho, sigue el configuración instrucciones.

Información acerca de las guías

Un agente se compone de una o más guías. Cada guía tiene un alcance limitado y claramente definido. 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 de alto nivel 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 planificación.
Ejemplos	Los ejemplos son conversaciones de muestra entre un usuario final y el agente. Estos ejemplos son, en efecto, ejemplos de instrucciones de pocas imágenes para el LLM.

Crea el agente

Para crear el agente, sigue estos pasos:

1. Ve a la consola de Agent Builder:

   Consola de Agent Builder

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

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

4. Haz clic en Crear una aplicación nueva o App nueva.

5. Selecciona Agente.

6. Proporcionar "Asistente de pedido de camisas" para el nombre de la app.

7. Selecciona una región.

8. Haz clic en Crear.

9. La interfaz de usuario te lleva a la guía predeterminada llamado Default Agent.

10. 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 camisetas. Para crear esta guía, haz lo siguiente:

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

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

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 guías.

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, haz lo siguiente:

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 libros de jugadas.

Actualiza la guía predeterminada

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:

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

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 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 libros de jugadas.

Proporciona ejemplos

En este punto, tu guía de trabajo está funcional. Sin embargo, se debe proporcionar ejemplos para garantizar respuestas de calidad.

Puedes proporcionar ejemplos manualmente en la sección Ejemplos. cuando tengas una guía abierta. Sin embargo, suele ser más fácil mantener una conversación con el manual funcional y guarda la conversación como ejemplo.

Un ejemplo de conversación con una guía predeterminada es corta. Esta guía solo debe dirigirte a otra. Para mantener 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. Debes ver el panel del simulador que contiene Enviar un mensaje para ver cómo responde tu agente.
2. Selecciona la estrategia predeterminada.
3. Selecciona el modelo: gemini-pro.
4. En el cuadro de texto que dice Enter user input, escribe Hello y, luego, presiona Intro.
5. La guía de respuestas responde con un saludo.

Para guardar esta conversación como ejemplo, sigue estos pasos:

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

5. Haz clic en Guardar.

   

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

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 para restablecer restart_alt.
2. Selecciona la guía de información.
3. Selecciona el modelo: gemini-pro.
4. Ingresa el mensaje: Where are you located?.
5. La guía responde con una ubicación.
6. Guarda esta conversación como un ejemplo llamado Location. Solo los ejemplos de guías predeterminadas pueden empezar con una acción del usuario, por lo que debes borrar la acción que contiene la frase "¿Dónde te encuentras?".

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

1. De forma similar a los pasos anteriores, ingresa el mensaje What are your hours? y asígnale el nombre Hours al ejemplo.

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

1. De forma similar a los pasos anteriores, pero asigna el nombre Selection al ejemplo, selecciona la guía de orden 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 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 a través de la API

Consulta Interacciones con la API.