Taller de bots con Bot Framework

1. Introducción

En este taller, veremos cómo construir un bot paso a paso, empezando desde el bot más simple (un bot que repite todo lo que decimos, hasta un pequeño bot para pedir pizzas a un restaurante fictício.

El objetivo de este taller es que podáis aprender los fundamentos de un bot, y de manera práctica, entendáis cómo Bot Framework nos provee de todo lo necesario para crearlo.

2. Requisitos

En estas instrucciones vamos a ofrecer dos alternativas: utilizar Visual Studio Code o directamente la consola para compilar y ejecutar la aplicación. Utilizad la que consideréis más cómoda. Si por cualquier razón Visual Studio Code no os funciona, podréis utilizar la consola sin problema.

• instalad el SDK de .Net Core 3.1 para vuestro sistema operativo. Recordad, elegid "build apps, SDK", ya que "Run apps - Runtime" solo os permitirá ejecutar, pero necesitamos compilar.
• OPcional (pero os puede facilitar el desarrollo). Descargad Visual Studio Code para vuestro sistema operativo. Si váis a descargar VS Code para Windows, podéis elegir la instalación de sistema o la de usuario, es indiferente.
• La última versión de la herramienta Bot Framework Emulator V4:

• Bot Framework Emulator para Windows
• Bot Framework Emulator para Mac
• Bot framework emulator para Linux

• Una cuenta de estudiante de Azure (la dirección de correo de la UB os debería valer para el registro): Register in azure for students.
• Git:

• Git for Windows
• Git for Mac
• Node (la última versión disponible):
• Node.JS para Windows
• Node.JS para MAC

2.1. Instalando Visual Studio Code (opcional)

Visual Studio Code es una herramienta multiplataforma y multilenguaje, que os puede facilitar mucho el desarrollo de vuestro código. Dado que no existe Visual Studio para Linux, esta herramienta nos servirá para seguir todos los pasos de este taller. Si preferís usar directamente la consola, no hay problema ;)

1. Ejecutad el archivo de instalación para vuestro sistema operativo. Como hay tres sistemas distintos, no entraremos aquí en el detalle de la instalación. Basta decir que el instalador no tiene nada de particular. Solo os recomiedno que marquéis las opciones que os aparecen, para permitir abrir archivos soportados por el editor y añadir code a la variable path para poder ejecutarlo desde cualquier parte usando la terminal.
2. Una vez finalice la instalación, abrid el programa.
3. Si tenéis windows y el subsistema de Linux funcionando con alguna distribución, os pedirá si queréis instalar la extensión WSL para ejecutar code desde Linux directamente. Aceptad e instalar la extensión.
4. íos al marketplace de extensiones (Control o CMD + shift + x). Cuando escribo control o cmd, es porque en Mac deberéis utilizar CMD en lugar de Control. Por tanto, en Windows y Linux será Control + Shift + X, y en MAC Cmd + Shift + X. Así con todos los comandos que utilicen la tecla Control.
5. En el cuadro de búsqueda, escribid "c#".
6. Os aparecerá la extensión c#, y en el detalle, veréis que es para ejecutar aplicaciones .Net Core. Instaladla.
7. Una vez instalada, ya estaréis listos para ejecutar el proyecto desde Visual Studio Code. ¡Importante! ¡Recordad que instalar el SDK de .Net Core 3.1 es obligatorio! Si no, no podr'eis compilar ni depurar desde Visual Studio Code.

2.2. Descargando el repositorio

Desde la consola cmd (o terminal de Mac), ejecutad:

C:\> git clone https://github.com/kastwey/order-pizza-bot

Esto os descargará la última versión del repositorio. Aseguraos de que estamos en la rama master:

c:\>git checkout master
Already on 'master'                                                                                                     
Your branch is up to date with 'origin/master'.                                                                        

Si ya tenéis el repositorio y queréis actualizarlo:

C:\> git pull

3. Estructura del repositorio

Dentro del repositorio, podréis encontrar la carpeta src, con todo el código fuente. Dentro de esta carpeta, veréis distintas subcarpetas:

• 00-TheMuteBot
• 01-BasicTemplate
• 02-LuisIntents
• 03-FirstWaterfallDialog
• 04-AddingInterruptions
• 05-ImprovingConfirmationDialogs
• 06-PredefinedPizzas
• 07-CustomPizzas
• 08-OrderStatus
• FullSolution

Cada una de estas carpetas contiene un paso en la construcción de nuestro bot: desde la primera en la que tenemos un simple bot que repite lo que decimos, hasta el paso 8, en el que tenemos un bot que nos permitirá pedir pizzas predefinidas y personalizadas.

En la carpeta "FullSolution" está todo el código, incluyendo la característica de desbloquear un paso de un diálogo cuando se han producido demasiados reintentos.

4. Empezando a trabajar

En este taller, recorreremos todos los pasos mencionados anteriormente, en los que observaremos cómo se van añadiendo funcionalidades a nuestro BOT.

4.1. Primer paso: 00-TheMuteBot

Este es el bot mudo. NO hace nada (por ahora)

• Si usáis Visual Studio Code, pulsad en File / Open Folder (control + k, control + o), y abrid la carpeta del paso 1: /src/00-TheMuteBot/OrderPizzaBot.
• Si de lo contrario vais a usar la consola, abrid la carpeta en vuestro explorador de archivos, y también en vuestra línea de comandos: cd /src/00-TheMuteBot/OrderPizzaBot.
• navegad hasta Bots/OrderPizzaBot.cs y abridlo, o bien con Visual Studio code (se os abrirá el editor de código), o bien con cualquier editor de texto instalado en vuestro sistema.
• Bajad hasta el método

protected override async Task OnMessageActivityAsync(ITurnContext<IMessageActivity> turnContext, CancellationToken cancellationToken)

Este evento se ejecuta cuando llega una actividad de mensaje. Ahora mismo no contiene nada, por lo que basicamente espera a que el usuario le escriba otra cosa (es un bot mudo). Incluid el siguiente código en el método:

var replyText = $"¡Eco eco! {turnContext.Activity.Text}";
   		await turnContext.SendActivityAsync(MessageFactory.Text(replyText, replyText), cancellationToken);

• Desde VS Code:
• pulsad f5. Esto debería ejecutar directamente la aplicación si no habéis cometido errores ;) y se debería mostrar la página web con la intro del bot. Si hay errores, en la lista de problemas (control / cmd + shift + m), veréis los errores que ha devuelto el compilador.
• Si váis a usar la consola:
• una vez en la carpeta mencionada más arriba, ejecutad:

dotnet build
dotnet run

• Ahora, se os debería mostrar en la consola algo como esto:

Now listening on: http://localhost:3978                                                                           

• Abrid esa web en vuestro explorador favorito.

Una vez en la web, veréis un texto diciendo que os podéis conectar al bot. Copiad esa dirección.

• Abrid el "Bot Framework Emulator", pulsad en File > Open bot, y pegad la dirección que habéis copiado en el paso anterior.
• Pulsad en conectar, y veréis que tenéis un cuadro para escribir. Cuando le escribáis algo al BOT, este os contestará con Eco eco, y lo que le digáis. Podéis parar el proyecto (Shift o Cmd + f5 desde VS Code, o control + c desde consola), cambiar algo en la cadena de respuesta, compilar, volver a ejecutar, y ver cómo el bot contesta ahora de forma diferente.

4.2. Trabajando con Luis.

Luis es un sistema de inteligencia artificial que intenta comprender el lenguaje natural. En este paso, vamos a añadir Luis a nuestro bot.

• Id al portal de azure: https://portal.azure.com.
• Iniciad sesión con la cuenta que creásteis en los requisitos.
• Si el portal os sale en español, id a configuración, pestaña "Idioma y región", y ahí elegid Inglés. Aplicad los cambios
• En el portal, haced click sobre el cuadro de búsqueda, escribid: luis, y elegir language understanding
• En la pantalla de creación, elegid el botón de radio "authoring". Marcad la suscripción en la que se va a crear el recurso (la única que os aparecerá).
• En grupo de recursos, Cread un nuevo grupo de recursos. escribid order-pizza-bot
• Como nombre de la aplicación, poned un nombre único: ub-order-pizza-bot-tunombre
• Como authoring location: us: west US.
• En Authoring pricing tier, elegid la capa gratuita F0.
• Pulsad en Review & create, y a continuación, en Create.
• Tardará un poco, esperad a que el portal de Azure os notifique que ya se ha creado el recurso de creación (authoring resource).
• Cuando os aparezca la pantalla indicándoos que se ha creado, pulsad en "Go To Resource".
• En la pantalla que aparece, copiad la clave del recurso (key 1) y guardadla a buen recaudo. Copiad también el endpoint.
• Id al portal de luis: https://preview.luis.ai. Este es la versión preliminar del portal, pero nos servirá mejor para lo que vamos a hcer, ya que es más completa.
• Pulsad en "Sign In". Os debería aparecer directamente la página de Microsoft, pidiéndoos que aceptéis a la aplicación de Luis como aplicación autorizada.
• Pulsad en Aceptar.
• Aceptad los términos de uso y pulsad en Aceptar.
• En el menú del portal, pulsad "My apps" y, a continuación, pulsar en "New app for conversation".
• Rellenar los campos:
• Name: ub-order-pizza-bot-vuestronombre. Yo puse: ub-order-pizza-bot-jmontiel.
• Culture: spanish.
• Description: Un bot para pedir pizza.
• Pulsad en Done.
• Nos aparecerá la pantalla de Intents. Los intents son las intenciones de nuestra aplicación, aquello que queremos que nuestro bot pueda entender. Vamos a crear varios, que utilizaremos más adelante en nuestro bot.

4.2.1. Intent Greet

Lo primer oque haremos será pulsar en el botón "Create" para crear nuestro intent.

• Intent name: Greet.
• Pulsad en Done.

Ahora, se nos abrirá la pantalla de utterances (declaraciones). Aquí se trata de que nuestro sistema de inteligencia artificial entienda qué frases van a desencadenar esta intención. Mientras más frases pongamos, mejor podrá detectar nuestra intención. Unas quince frases estarían bien para empezar. Para cada intent, tendremos que poner más o menos el mismo número de frases, y tenemos que intentar que las frases de distintos intents no sean muy similares, pues el bot puede confundirse.

• hola
• hola caracola
• Buenas
• buenas tío
• buenas, tío
• qué pasa
• que pasa
• buenos días
• buenos dias
• buenas tardes
• buenas noches
• qué tal
• que tal
• Cómo estás
• como estas
• cómo va eso
• como va eso
• saludos, terrícola
• saludos

Como ves, es importante usar también faltas de ortografía, distinta gramática y distintos signos de puntuación. ¡No todos escriben igual!

4.2.2. OrderPizza

Vamos a añadir un nuevo intent. Pulsad en el menú el ítem "Intents" y repetid el proceso del punto anterior. Ahora, nuestro intent se llamará OrderPizza.

Las declaraciones podrían ser algo como:

• quiero pizza
• quiero una pizza
• quiero dos pizzas
• Quiero pedir una pizza
• quiero pedir siete pizzas
• quiero pizza a domicilio
• quiero una pizza a domicilio
• quiero ocho pizzas a domicilio
• quiero pedir una pizza a domicilio
• quiero pedir siete pizzas a domicilio
• quiero una pizza para casa
• Tráeme una pizza
• Tráeme dos pizzas
• Traeme una pizza
• traeme dos pizzas
• quiero pizza a recoger
• quiero una pizza a recoger
• Quiero ocho pizzas a recoger
• quiero pizza para recoger
• quiero una pizza para recoger
• quiero cuatro pizzas para recoger
• pedir una pizza
• pedir pizza
• pedir siete pizzas
• pedir una pizza a domicilio
• pedir tres pizzas a recoger

De estos intents sacaremos entidades. Para ello, vamos a crearlas.

• pulsad en el ítem "Entities" y, a continuación, en el botón "Add prebuilt entity"
• Vamos a crear una entidad de tipo numérico. Marcamos la fila y pulsamos en Done.
• A continuación, pulsaremos en "Create" (vamos a crear una nueva entidad).
• Name: OrderType.
• Type: List.
• Pulsad en Next.
• En sublists, cread dos ítems:
• Pickup
• Delivery
• En la tabla de ítems de lista, para los sinónimos, escribid:
• En PickUp: recoger, voy, recojo
• En delivery: domicilio, tráeme, traeme, tráemela, traemela, trae, casa
• Pulsamos en Create.
• Ahora, si volvemos a Intents, y elegimos "OrderPizza", veremos que todas las declaraciones que tienen entidades las está cogiendo correctamente.

4.2.3. OrderStatus

Este intent nos servirá para pedirle al sistema que nos lea el estado de nuestro pedido.

• Nombre: OrderStatus.
• Declaraciones:
• cómo va mi pedido
• como va mi pedido
• dime como va mi pedido
• le falta mucho a mi pedido
• estado de mi pedido
• estado del pedido
• tengo hambre
• cómo lleváis mi pedido?
• ... (lo que se os ocurra) ;)

4.2.4. Reject

Este intent servirá para buscar negaciones, cuando rechazamos una acción.

Como declaraciones, escribid todo aquello que consideréis que puede ser una negación: no, ni de broma, qué va...

4.2.5. Accept

Al contrario que Reject, esta intención servirá para aceptar una acción. Podríamos escribir como declaraciones: sí, si, claro, por supuesto, de acuerdo, ETC.

4.2.6. GetMenu

Este intent servirá para que los usuarios pidan la carta a la pizzería.

• Quiero el menú
• quiero el menu
• menú
• menu
• dame el menú
• dame el menu
• dame la carta
• léeme la carta
• leeme la carta
• carta
• la carta
• ...

4.2.7 Testeando nuestra aplicación.

Para testear nuestras intenciones, lo primero es entrenar nuestra aplicación con las intenciones que hemos añadido.

Pulsad en el botón "Train". Os aparecerá una pantalla de progreso. Cuando finalice, pulsad en el botón "Test".

Esta pantalla nos permite testear frases. Luis nos dirá qué cree que es, y así, podremos realizar las correcciones oportunas.

Jugad con el cuadro de test, y si la intención que queréis da una intención incorrecta, editad la intención y añadid vuestra frase y frases similares para corregirlo. Tras añadir cualquier frase, tendréis que guardar y volver a entrenar.

4.2.8. Publicando nuestra aplicación

Ha llegado el momento de publicar nuestra aplicación.

• Pulsad el botón "Publish"
• En la pantalla que os aparece, marcad la franja de producción (production slot).
• Pulsad en "Done". Cuando se haya publicado, os avisará mediante una notificación.
• Ahora, pulsad en Manage > Application settings.
• En "App ID", copiad el valor y guardadlo a buen recaudo junto con la clave que copiásteis anteriormente en el "authoring resource" de Azure.
• Ahora, id a manage > Versions.
• Seleccionad la versión publicada, y pulsad en export > json file.
• Descargad el fichero json, que contendrá toda vuestra aplicación: intenciones, declaraciones, entidades, ETC y guardadlo, que luego lo usaremos.

4.3. Incluyendo luis en nuestro bot

Ha llegado el momento de incluir luis en nuestro bot. Para ello, utilizaremos la plantilla de nuestro bot mudo y la iremos mejorando en los siguientes pasos.

Los ficheros con el código los tenéis en la carpeta workshop-files, con una subcarpeta por cada caso.

• Cread una nueva carpeta dentro del proyecto llamada "Dialogs":

• Dentro de la carpeta, cread una nueva clase llamada "MainDialog":

• Desde VS Code: botón derecho sobre la carpeta recién creada, new file. Como nombre: MainDialog.cs

• Desde vuestro explorador de archivos, cread un nuevo fichero de texto, y llamadlo MainDialog.cs

• Copiad el contenido del fichero workshop-files\02-LuisIntents\MainDialog.txt en esa clase.

• Añadid una segunda clase en la raíz del proyecto llamada OrderPizzaRecognizer, y pegad el contenido del archivo OrderPizzaRecognizer.txt.

• Abrid el fichero startup.cs, y sustituidlo por el contenido del archivo startup.txt

• Abrid el fichero bots > OrderPizzaBot.cs y sustituid el contenido de ese fichero por el del fichero OrderPizzaBot.txt

• Cread un nuevo fichero en la raíz del proyecto llamado appsettings.json y Copiad el contenido del fichero appsettings.txt.

• Ahora, tendremos que instalar la herramienta luisgen (por lo que en los requisitos os pedí que instaláseis node.js). En la consola, ejecutad:

npm install luisgen -g
Tool 'luisgen' (version '2.2.0') was successfully installed.                                                            
+ luisgen@2.2.0                                                                                                         
added 1 package in 4.62s                                                                                                

• Cread una carpeta en el proyecto llamada CognitiveModels.
• Copiad el fichero 0.1.json descargado desde la versión de la aplicación a esa carpeta, con el nombre OrderPizza.json
• En la consola, situaos en el directorio donde está este fichero, por ejemplo:

C:\>cd proyectos\order-pizza-bot\src\02-LuisIntents\OrderPizzaBot\CognitiveModels

• Ahora, ejecutamos, dentro de esa carpeta:

C:\proyectos\order-pizza-bot\src\02-LuisIntents\OrderPizzaBot\CognitiveModels>luisgen OrderPizza.json -cs OrderPizzaBot.OrderPizza                                                                                                              
Generating file OrderPizza.cs that contains class OrderPizzaBot.OrderPizza.

Por último, tendremos que modificar el fichero appsettings.json (esto tendremos que hacerlo en todos los siguientes pasos, ya que las claves de la aplicación de Luis no están en el repositorio, pues cada uno de vosotros tendrá claves diferentes asociadas a vuestra aplicación.

• Abrid el fichero appsettings.json.
• Como veis, es un json normal y corriente. Buscad las claves LuisAPIKey y LuisAppId, y rellenar los valores con los que guardásteis anteriormente desde el portal de Azure y desde el portal de Luis.
• Guardad el fichero.

¡Ya tendremos todo lo necesario para ejecutar nuestra aplicación! Ejecutad el proyecto (igual que hicimos en el paso anterior dependiendo de si usáis VS Code o consola):

• VS Code:
• f5.
• Consola:
• Ejecutad

dotnet build
dotnet run

• La URL de inicio siempre es la misma, así que en realidad no tenéis que abrir la web cada vez que ejecutéis el bot al haber cambiado algo. Ya sabéis que la URL del bot (la que acaba por message) es la misma, así que solo tenéis que recargar el bot en vuestro emulador para que la conversación se inicie de nuevo con los cambios que hayáis hecho.

Conectaos con Bot Framework y ejecutad las intenciones que queráis. El bot os responderá con la intención que cree haber interpretado, y la confianza en esa decisión.

4.4. Nuestro primer diálogo en cascada

Ahora, vamos a crear nuestro primer diálogo en cascada.

Este tipo de diálogo consta de varios pasos, que se van sucediendo de manera secuencial. En esta evolución del bot, vamos a crear un diálogo de pasos para gestionar el menú principal, y otro para gestionar el número de pizzas y el tipo de pedido.

Partiendo del bot mudo que hemos modificado para añadir luis, sigamos adelante:

• Abrid el fichero Bots > OrderPizzaBot.cs y sustituid su contenido por el fichero que se encuentra en los archivos del workshop (workshop-files), en la carpeta "03-FirstWaterfallDialog", con el nombre OrderPizzaBot.txt
• Dentro de la carpeta Dialogs, cread una nueva clase llamada OrderPizzaDialog. Recordad, el fichero se debe poner siempre con la extensión .cs (CSharp).
• Abrid el fichero OrderPizzaDialog.cs recién creado, y sustituid su contenido por el del archivo OrderPizzaDialog.txt.
• Ahora, abrid el fichero MainDialog.cs, y sustituid su contenido por el del archivo del workshop MainDialog.txt
• Cread una nueva carpeta llamada Entities, y cread dos clases: Enums.cs y OrderInfo.cs, sustituyendo su contenido por su contrapartida txt dentro de los ficheros del workshop.
• Cread una carpeta llamada Extensions, y dentro, una clase llamada EnumExtensions, sustituyendo su contenido por el fichero EnumExtensions.txt.
• Abrid el fichero Startup.cs, y sustituid el contenido por el del fichero Startup.txt.

Ahora, veréis que, si le pedimos una pizza con números, lo detectará y nos pedirá confirmación. Si le falta alguna entidad, nos la pedirá antes de confirmar. También podremos preguntarle por alguna de las otras opciones que le pedimos en el intent.

4.5. Añadiendo interrupciones a nuestro bot

Hay bots llamados "bots tercos". Estos son aquellos que siempre te llevan por el mismo camino, le digas lo que le digas, hagas lo que hagas. Si le has dicho que quieres información sobre un contacto, luego no hay manera de sacarlo de ahí. Para esto se diseñaron las interrupciones en el flujo de un diálogo.

En este paso vamos a añadir un par de interrupciones a nuestro diálogo: una cuando digamos ayuda o pongamos un signo de interrogación, y otro cuando le digamos cancelar. En este ejemplo vamos a utilizar palabras literales y comparaciones con lo recibido en el mensaje del bot (ayuda y cancelar), pero podríamos basarnos también en intents. De hecho, os animo a que lo probéis por vuestra cuenta, creando intents para ayuda y para cancelar, y haciendo que la intención de la interrupción también se extraiga de Luis, no de comparaciones literales.

• Dentro de la carpeta Dialogs, cread un fichero llamado DialogBase.cs, que contendrá nuestra nueva clase llamada DialogBase. Esta clase será, a partir de ahora, la base de todos nuestros diálogos.
• Pegad el contenido del fichero DialogBase.txt de la carpeta del paso 4, dentro de "workshop-files".
• Abrid, dentro de Dialogs, el fichero MainDialog.cs, y cambiad la línea 14:
• Pasa de ser:

	public sealed class MainDialog : ComponentDialog

• a:

	public sealed class MainDialog : DialogBase

• Haced lo mismo en el fichero OrderPizzaDialog.cs. Cambiad la línea 16:
• Pasa de ser:

	public class OrderPizzaDialog : ComponentDialog

• a:

	public class OrderPizzaDialog : DialogBase

• Cambiad, en la línea 108, el mensaje que daremos cuando elijamos el tipo de pizza y el tipo de pedido. Ahora dirá:

			var endMsg = "¡Estupendo! ¡Por ahora esto es todo! ¡Vamos al siguiente paso del taller! ¡Pero eh! ¡Ya tenemos el número de pizzas y el tipo de pedido! ¡Y además, ya sabemos cómo salir del diálogo o pedir ayuda en cualquier momento!";

¡Y ya hemos completado otro paso! Como podéis comprobar si ejecutáis el proyecto (ya no os pongo los pasos en función del entorno, que ya os lo sabéis ;) ), veréis cómo en cualquier momento, aunque os esté preguntando por el número de pizzas o si queréis recogerlas o que os las traigan a casa, podéis pedir ayuda (en cuyo caso se os dará un mensaje de ayuda y se os volverá a preguntar por el diálogo anterior), o si escribís "Cancelar", el bot se iniciará desde cero, olvidándose de lo dicho hasta el momento.

4.6. Mejorando las confirmaciones

Hasta ahora, para que nuestro bot contestara a preguntas cerradas de sí o no, utilizábamos un diálogo predefinido de confirmación... pero... ¿Y si usamos intents? Ahora ya entendéis para qué creamos en el paso 4.2.5 el intent para aceptar, y en el paso 4.2.6, el intent para rechazar una acción. Ahora utilizaremos esos intents para cambiar ese diálogo, de modo que cuando queramos aceptar algo, no solo valga el "sí", sino también cosas como: "claro", "por supuesto", "de acuerdo".

• Abrid el fichero "Dialogs/DialogBase.cs".
• Antes del constructor (línea 20), añadid una variable que va a almacenar nuestro objeto reconocedor de Luis:

		private readonly OrderPizzaRecognizer _recognizer;

• Reemplazad el constructor "protected" de la clase:
• Pasa de:

		protected DialogBase(string id)
			: base(id)
		{
		}

• a:

		protected DialogBase(string id, OrderPizzaRecognizer recognizer)
 			: base(id)
 		{
			_recognizer = recognizer;
		}

• Después del cierre del método "InterruptAsync", alrededor de la línea 64, añadid un nuevo método, que se llamará "ValidateConfirmation", y tendrá el siguiente código:

		protected async Task<bool> ValidateConfirmation(PromptValidatorContext<bool> validatorContext, CancellationToken cancellationToken)
		{
			var result = await _recognizer.RecognizeAsync<OrderPizza>(validatorContext.Context, cancellationToken);
			var intent = result.TopIntent();
			if (intent.intent == OrderPizza.Intent.Accept || intent.intent == OrderPizza.Intent.Reject)
			{
				validatorContext.Recognized.Succeeded = true;
				validatorContext.Recognized.Value = intent.intent == OrderPizza.Intent.Accept;
			}
			return validatorContext.Recognized.Succeeded;
		}

• Abrid el fichero "Dialogs/OrderPizzaDialog.cs".
• En la línea 23, cambiad el constructor y la llamada a la base, para que reciba y envíe a dicha clase base el nuevo parámetro "recognizer" que la base necesita:
• Pasa de:

		public OrderPizzaDialog(UserState userState)
			: base(nameof(OrderPizzaDialog))

• a:

		public OrderPizzaDialog(UserState userState, OrderPizzaRecognizer recognizer)
			: base(nameof(OrderPizzaDialog), recognizer)

• En la línea 31, cambiad el diálogo de confirmación, para pasarle una función de validación (que será la nueva que añadimos en el diálogo base):
• Pasa de:

			AddDialog(new ConfirmPrompt(nameof(ConfirmPrompt), null, "es"));

• a:

			AddDialog(new ConfirmPrompt(nameof(ConfirmPrompt), ValidateConfirmation, "es"));

• Abrid el fichero "Dialogs/MainDialog.cs".
• En la línea 23, cambiad la llamada al constructor de la clase base:
• pasa de ser:

			: base(nameof(MainDialog))

• a:

			: base(nameof(MainDialog), recognizer)

• En la línea 30, cambiad la adición del diálogo "OrderPizzaBot", que ahora también recibirá el parámetro recognizer para que se lo pueda pasar a su clase base (DialogBase), que lo necesita.
• Pasa de:

			AddDialog(new OrderPizzaDialog(userState));

• a:

			AddDialog(new OrderPizzaDialog(userState, _recognizer));

¡Y ya lo tenemos! Probad ahora, cuando os pregunte si el número de pizzas y el tipo de pedido es el correcto, a decirle "claro" en lugar de sí. Os lo debería aceptar igualmente.

4.7. Añadiendo pizzas predefinidas

En este paso vamos a añadir bastante código. Vamos a introducir toda la lógica de negocio para el diálogo de elección de pizzas predefinidas. ASí, una vez elegidos el número de pizzas y el tamaño, nuestro bot será capaz de ir pizza a pizza según ese número, preguntándonos qué tipo de pizza queremos:

• Cread un nuevo fichero llamado IPizzaRepository.cs en una nueva ruta dentro de nuestro proyecto: Contracts/Repositories/IPizzaRepository.cs. Por tanto, deberéis crear la carpeta "Contracts", dentro la carpeta "Repositories", y dentro, el fichero IPizzaRepository.cs.
• Rellenad esa interfaz con el contenido del fichero IPizzaRepository.txt de los ficheros del taller correspondientes a este paso: "06-PredefinedPizzas".
• Dentro de la carpeta "Dialogs", añadid un nuevo fichero: "PizzaSelectionDialog.cs", y rellenadlo con el contenido del fichero "PizzaSelectionDialog.txt" de los ficheros del taller.
• En la raíz del proyecto, cread tres carpetas: "Files", "Helpers" y "Repositories".
• Dentro de la carpeta "Entities", cread el fichero "Ingredient.cs", y rellenadlo con el fichero "Ingredient.txt" de los archivos del taller.
• Dentro de la carpeta "Entities", cread otro fichero llamado "Pizza.cs", y rellenadlo con el contenido de "Pizza.txt".
• Dentro de la carpeta Extensions, cread otro fichero llamado "ListExtensions.cs", y rellenadlo con el contenido del fichero "ListExtensions.txt".
• Dentro de la carpeta "Extensions", cread otro fichero llamado "PizzaExtensions.cs", y rellenadlo con el fichero "PizzaExtensions.txt".
• Dentro de la carpeta "Files", copiad el fichero llamado "pizzas.json".
• Dentro de la carpeta "Helpers", cread un nuevo fichero llamado "MenuHelper.cs", y rellenadlo con el contenido del fichero "MenuHelper.txt".
• Dentro de la carpeta "Repositories", cread un nuevo fichero llamado "PizzaRepository.cs", y rellenadlo con el contenido del archivo "PizzaRepository.txt".
• Sustituid el contenido del fichero "Bots/OrderPizzaBot.cs" por el contenido de OrderPizzaBot.txt".
• Sustituid el contenido del fichero "Dialogs/DialogBase.cs" por el contenido de DialogBase.txt.
• Sustituid el contenido del fichero "Dialogs/MainDialog.cs" por el contenido de MainDialog.txt.
• Sustituid el contenido del fichero "Dialogs/OrderPizzaDialog.cs" por el contenido de OrderPizzaDialog.txt.
• Sustituid el contenido del fichero "Entities/Enums.cs" por el contenido de Enums.txt.
• Sustituid el contenido del fichero "Entities/OrderInfo.cs" por el contenido de OrderInfo.txt.
• Sustituid el contenido del fichero "Extensions/EnumExtensions.cs" por el contenido de EnumExtensions.txt.
• Sustituid el contenido del fichero "Startup.cs" por el contenido de Startup.txt.

Como veis, en este paso hemos introducido muchísima lógica de negocio y multitud de ficheros nuevos: un repositorio para obtener las pizzas predefinidas, un archivo json del que sacar dichas pizzas, un diálogo nuevo para introducir toda la lógida de negocio con los distintos pasos... y todos los ficheros que hemos modificado para que este nuevo diálogo funcione. Ahora, probad a ejecutar el bot, e intentad pedir un par de pizzas. Si todo ha funcionado bien, el sistema os debería dejar pedir pizzas predefinidas, pidiéndonos, al final de cada una, confirmación para continuar con la siguiente.

4.7. Pizzas personalizadas

NO nos conformamos con pedir una carbonara y una barbacoa. ¡Queremos nuestras proopias pizzasa personalizadas! Así que vamos a añadir un nuevo diálogo para este menester, además de un repositorio de ingredientes y un fichero json con los ingredientes aceptados. También tendremos que cambiar algunas cosas en nuestras clases existentes para añadir este nuevo diálogo:

• Dentro de la carpeta "Dialogs", cread un nuevo fillero llamado "CustomPizzaDialog.cs", y rellenadlo con el contenido del fichero "CustomPizzaDialog.txt" del paso 07 de los archivos del taller.
• En la carpeta "Contracts/Repositories", cread un fichero llamado "IIngredientRepository.cs", y rellenadlo con el contenido del fichero "IIngredientRepository.txt".
• Dentro de la carpeta "Repositories", cread un fichero llamado "IngredientRepository.cs", y rellenadlo con el contenido del archivo "IngredientRepository.txt".
• Dentro de la carpeta "Files", copiad el fichero "ingredients.json" de los archivos de este paso del taller.
• Dentro de la carpeta "Bots", sustituid el contenido del fichero "OrderPizzaBot.cs" por el del fichero "OrderPizzaBot.txt".
• Dentro de la carpeta "Dialogs", sustituid el contenido del fichero "MainDialog.cs" por el del fichero "MainDialog.txt".
• Dentro de la carpeta "Dialogs", sustituid el contenido del fichero "OrderPizzaDialog.cs" por el del fichero "OrderPizzaDialog.txt".
• Dentro de la carpeta "Dialogs", sustituid el contenido del fichero "PizzaSelectionDialog.cs" por el del fichero "PizzaSelectionDialog.txt".
• Sustituid el contenido de "Startup.cs" por el contenido del fichero "Startup.txt".

Y ahora, ejecutad el bot. Veréis que cuando os pregunte por el tipo de pizza, también podréis decirle ahora que queréis una pizza personalizada, elegir los ingredientes junto al tipo de masa y al tamaño, y tendréis vuestra maravillosa pizza personalizada!