{"id":801,"date":"2020-10-15T12:57:26","date_gmt":"2020-10-15T12:57:26","guid":{"rendered":"https:\/\/ingenieriadesoftware.es\/?p=801"},"modified":"2020-10-15T12:57:26","modified_gmt":"2020-10-15T12:57:26","slug":"bot-meteorologo-ciudad-openweather","status":"publish","type":"post","link":"https:\/\/ingenieriadesoftware.es\/bot-meteorologo-ciudad-openweather\/","title":{"rendered":"Crea un bot que da el tiempo de cualquier ciudad en menos de 100 l\u00edneas de c\u00f3digo"},"content":{"rendered":"

Los chatbots son una de las mejores maneras para ofrecer una manera f\u00e1cil de acceder al gran n\u00famero de datos abiertos que los gobiernos e instituciones publican en internet. Es lo que llamamos “open data chatbots<\/a>“.<\/p>\n

Hoy os ense\u00f1amos como de f\u00e1cil puede llegar a ser alguno de estos bots cuando los datos abiertos se ofrecen v\u00eda una API REST<\/a>. M\u00e1s concretamente, veremos como crear un chatbot (hecho con Xatkit<\/a>) que consulta OpenWeather<\/a> para darte el tiempo de cualquier ciudad del mundo. <\/p>\n

Todo en menos de 100 l\u00edneas de c\u00f3digo Java.\u00a0El c\u00f3digo completo lo ten\u00e9is en nuestro repositorio de ejemplos<\/a> pero os explicamos aqu\u00ed todos los detalles importantes.<\/p>\n

Defininiedo la intenci\u00f3n Dame el tiemo en<\/em><\/h2>\n

El primer paso es definir el intent<\/em> que permite al usuario pedir la previsi\u00f3n del tiempo para una ciudad dada. En Xatkit lo hacemos as\u00ed:<\/p>\n

\r\n        val howIsTheWeather = intent(\"HowIsTheWeather\")\r\n                .trainingSentence(\"How is the weather today in CITY?\")\r\n                .trainingSentence(\"What is the forecast for today in CITY?\")\r\n                .parameter(\"cityName\").fromFragment(\"CITY\").entity(city());\r\n<\/pre>\n
F\u00edjate como recogemos informaci\u00f3n de la ciudad sobre la que se pide la previsi\u00f3n como parte del an\u00e1lisis de la intenci\u00f3n. Adem\u00e1s, el valor del par\u00e1metro ciudad no puede ser cualquier cadena de car\u00e1cteres sin\u00f3 que esta restringido a uno de los valores de la entity<\/em> city<\/code>. La mayor\u00eda de los motores de NLP (natural language processing) con los que trabaja Xatkit ofrecen tipos de datos predeterminados m\u00e1s all\u00e1 de los primitivos (entero, string, real,…) como por ejemplo ciudad, pa\u00eds, tel\u00e9fono,… Esto permite mejorar la calidad del matching<\/em> del texto que entra el usuario. Aseguraros de configurar el bot para usar DialogFlow<\/a> o Nlp.js<\/a> (y recordad que cambiar de motor de NLP no implica ning\u00fan cambio en el c\u00f3digo del bot, s\u00f3lo de su fichero de configuraci\u00f3n<\/a>). <\/p>\n
Respondiendo a la petici\u00f3n del tiempo<\/h2>\n
Una vez el chatbot reconoce que el usuario le pide la meteorolog\u00eda de una ciudad X<\/em>, el bot tiene que llamar a la REST API de OpenWeather pasando X<\/em> como par\u00e1metro. <\/p>\n
Empezamos con un estado inicial donde esperamos a que el usuario nos pida el tiempo,<\/p>\n
\r\n      awaitingInput\r\n                .next()\r\n                .when(intentIs(howIsTheWeather)).moveTo(printWeather);\r\n<\/pre>\n
Una vez hacemos match, nos movemos al estado  printWeather<\/code> donde se llama a la API y se procesa la respuesta para imprimir el mensaje de la previsi\u00f3n de vuelta al usuario.<\/p>\n
Recuerda que Xatkit viene con una plataforma REST <\/a> que simplifica la interacci\u00f3n con APIs REST. En el c\u00f3digo, getJsonRequest<\/code> te ayuda a construir la URL exacta para realizar tu petici\u00f3n y recoge la respuesta en un objeto response<\/code> que puedes usar para chequear el \u00e9xito de la petici\u00f3n y extraer f\u00e1cilmente la informaci\u00f3n que te haga falta para construir la respuesta. <\/p>\n
Una vez impresa la respuesta, el bot vuelve al estado inicial esperando la nueva petici\u00f3n.<\/p>\n
\r\n     printWeather\r\n                .body(context -> {\r\n                    String cityName = (String) context.getIntent().getValue(\"cityName\");\r\n                    Map queryParameters = new HashMap<>();\r\n                    queryParameters.put(\"q\", cityName);\r\n                    ApiResponse response = restPlatform.getJsonRequest(context, \"http:\/\/api\" +\r\n                                    \".openweathermap.org\/data\/2.5\/weather\", queryParameters, Collections.emptyMap(),\r\n                            Collections.emptyMap());\r\n                    if (response.getStatus() == 200) {\r\n                        long temp = Math.round(response.getBody().getAsJsonObject().get(\"main\").getAsJsonObject().get(\r\n                                \"temp\").getAsDouble());\r\n                        long tempMin =\r\n                                Math.round(response.getBody().getAsJsonObject().get(\"main\").getAsJsonObject().get(\r\n                                        \"temp_min\").getAsDouble());\r\n                        long tempMax =\r\n                                Math.round(response.getBody().getAsJsonObject().get(\"main\").getAsJsonObject().get(\r\n                                        \"temp_max\").getAsDouble());\r\n                        String weather =\r\n                                response.getBody().getAsJsonObject().get(\"weather\").getAsJsonArray().get(0).getAsJsonObject().get(\"description\").getAsString();\r\n                        String weatherIcon =\r\n                                \"http:\/\/openweathermap.org\/img\/wn\/\" + response.getBody().getAsJsonObject().get(\r\n                                        \"weather\").getAsJsonArray().get(0).getAsJsonObject().get(\"icon\").getAsString() + \".png\";\r\n                        reactPlatform.reply(context, MessageFormat.format(\"The current weather is {0} °C with \" +\r\n                                        \"{1} ![{1}]({2}) with a high of {3} °C and a low of {4} °C\", temp,\r\n                                weather,\r\n                                weatherIcon, tempMax, tempMin));\r\n                    } else if (response.getStatus() == 400) {\r\n                        reactPlatform.reply(context, \"Oops, I couldn't find this city\");\r\n                    } else {\r\n                        reactPlatform.reply(context, \"Sorry, an error \" +  response.getStatus() + \" \" + response.getStatusText() + \" occurred when accessing the openweathermap service\");\r\n                    }\r\n\r\n                })\r\n                .next()\r\n                .moveTo(awaitingInput);\r\n\r\n<\/pre>\n
El chatbot meteor\u00f3logo<\/h2>\n
Puedes ver el bot en acci\u00f3n aqu\u00ed. <\/p>\n
\"weather<\/p>\n
F\u00edjate que el bot es capaz de entender la pregunta aunque no sea exactamente igual que las frases de entrenamiento (\u00a1la magia de las redes neuronales!). Evidentemente, \u00e9ste es un ejemplo minimalista, tienes todo el poder de nuestra Fluent API<\/a> para ampliarlo como quieras.<\/p>\n
Imagen de cabecera por Wim van ‘t Einde<\/a> en Unsplash<\/a><\/em><\/p>\n<\/span>","protected":false},"excerpt":{"rendered":"
Descubre como de f\u00e1cil es crear bots que den informaci\u00f3n \u00fatil, como por ejemplo, la previsi\u00f3n del tiempo gracias a OpenWeather<\/p>\n","protected":false},"author":2,"featured_media":803,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_et_pb_use_builder":"","_et_pb_old_content":"","_et_gb_content_width":"","footnotes":""},"categories":[5,154],"tags":[165,276,48,343,67],"hashtags":[],"_links":{"self":[{"href":"https:\/\/ingenieriadesoftware.es\/wp-json\/wp\/v2\/posts\/801"}],"collection":[{"href":"https:\/\/ingenieriadesoftware.es\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/ingenieriadesoftware.es\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/ingenieriadesoftware.es\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/ingenieriadesoftware.es\/wp-json\/wp\/v2\/comments?post=801"}],"version-history":[{"count":0,"href":"https:\/\/ingenieriadesoftware.es\/wp-json\/wp\/v2\/posts\/801\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/ingenieriadesoftware.es\/wp-json\/wp\/v2\/media\/803"}],"wp:attachment":[{"href":"https:\/\/ingenieriadesoftware.es\/wp-json\/wp\/v2\/media?parent=801"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/ingenieriadesoftware.es\/wp-json\/wp\/v2\/categories?post=801"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/ingenieriadesoftware.es\/wp-json\/wp\/v2\/tags?post=801"},{"taxonomy":"hashtags","embeddable":true,"href":"https:\/\/ingenieriadesoftware.es\/wp-json\/wp\/v2\/hashtags?post=801"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}