Tutorial: Creación de una función para la integración con Azure Logic Apps

Azure Functions se integra con Azure Logic Apps en el Diseñador de Aplicaciones lógicas. Esta integración permite usar la potencia informática de Functions en orquestaciones con otros servicios de Azure y de terceros.

En este tutorial se muestra cómo crear un flujo de trabajo para analizar la actividad X. A medida que se evalúan los tweets, el flujo de trabajo envía notificaciones cuando se detectan opiniones positivas.

En este tutorial, aprenderá a:

Requisitos previos

• Una cuenta de X activa.
• Una cuenta Outlook.com (para enviar notificaciones).

Creación de un recurso de Text Analytics

Las API de Foundry Tools están disponibles en Azure como recursos individuales. Use la API de Text Analytics para detectar la opinión de los tweets publicados.

1. Inicie sesión en el portal Azure.

2. Seleccione Crear un recurso en la esquina superior izquierda del portal de Azure.

3. En Categories, seleccione AI + Machine Learning

4. En Text Analytics, seleccione Crear.

5. Escriba los valores siguientes en la pantalla Crear Text Analytics.

   Configuración	Valor	Observaciones
   Suscripción	Nombre de la suscripción de Azure
   Grupo de recursos	Cree un grupo de recursos denominado tweet-sentiment-tutorial	Más adelante, eliminará este grupo de recursos para quitar todos los recursos creados en este tutorial.
   Región	Seleccione la región más cercana a la suya
   Nombre	TweetSentimentApp
   Nivel de precios	Seleccione Free F0 (F0 gratis)

6. Seleccione Revisar + crear.

7. Seleccione Crear.

8. Una vez finalizada la implementación, seleccione Ir al recurso.

Obtención de la configuración de Text Analytics

Con el recurso de Text Analytics creado, copiará algunas opciones de configuración y las reservará para su uso posterior.

1. Seleccione Keys and Endpoint (Claves y punto de conexión).

2. Copie la clave 1, para lo que debe hacer clic en el icono al final del cuadro de entrada.

3. Pegue el valor en un editor de texto.

4. Copie el punto de conexión, para lo que debe hacer clic en el icono al final del cuadro de entrada.

5. Pegue el valor en un editor de texto.

Crear la aplicación de funciones

1. En el cuadro de búsqueda superior, busque y seleccione Aplicación de funciones.

2. Seleccione Crear.

3. Escriba los siguientes valores:

   Configuración	Valor sugerido	Observaciones
   Suscripción	Nombre de la suscripción de Azure
   Grupo de recursos	tutorial-de-sentimiento-de-tweets	Use el mismo nombre de grupo de recursos en todo este tutorial.
   Nombre de la aplicación de funciones	TweetSentimentAPI + un sufijo único	Los nombres de las aplicaciones de funciones son únicos globalmente. Los caracteres válidos son (no distingue mayúsculas de minúsculas), y .
   Publicar	Código
   Pila en tiempo de ejecución	.NET	El código de función proporcionado está en C#.
   Versión	Seleccione el número de versión más reciente
   Región	Seleccione la región más cercana a la suya

4. Seleccione Revisar + crear.

5. Seleccione Crear.

6. Una vez finalizada la implementación, seleccione Ir al recurso.

Creación de una función desencadenada con HTTP

1. En el menú de la izquierda de la ventana Funciones, seleccione Functions.

2. Seleccione Agregar en el menú superior y escriba los valores siguientes.

   Configuración	Valor	Observaciones
   Entorno de desarrollo	Desarrollo en el portal
   Plantilla	Desencadenador HTTP
   Nueva función	TweetSentimentFunction	Este es el nombre de la función.
   Nivel de autorización	Función

3. Seleccione el botón Agregar.

4. Seleccione el botón Code + Test (Código y prueba).

5. Pegue el siguiente código en la ventana del editor de código.

   #r "Newtonsoft.Json"
   
   using System;
   using System.Net;
   using Microsoft.AspNetCore.Mvc;
   using Microsoft.Extensions.Logging;
   using Microsoft.Extensions.Primitives;
   using Newtonsoft.Json;
   
   public static async Task<IActionResult> Run(HttpRequest req, ILogger log)
   {
   
       string requestBody = String.Empty;
       using (StreamReader streamReader =  new  StreamReader(req.Body))
       {
           requestBody = await streamReader.ReadToEndAsync();
       }
   
       dynamic score = JsonConvert.DeserializeObject(requestBody);
       string value = "Positive";
   
       if(score < .3)
       {
           value = "Negative";
       }
       else if (score < .6) 
       {
           value = "Neutral";
       }
   
       return requestBody != null
           ? (ActionResult)new OkObjectResult(value)
          : new BadRequestObjectResult("Pass a sentiment score in the request body.");
   }
   

   Se pasa una puntuación de opinión a la función, que devuelve un nombre de categoría para el valor.

6. Seleccione el botón Guardar en la barra de herramientas para guardar los cambios.

   Nota

   Para probar la función, seleccione Test/Run (Probar o ejecutar) en el menú superior. En la pestaña Entrada, escriba el valor en el cuadro de entrada Cuerpo y, después, seleccione Ejecutar. Compruebe que se devuelve el valor Positivo en el cuadro Contenido de respuesta HTTP de la sección Salida.

A continuación, cree una aplicación lógica que se integre con Azure Functions, X y foundry Tools API.

Creación de una aplicación lógica

1. En el cuadro de búsqueda superior, busque y seleccione Aplicaciones lógicas.

2. Seleccione Agregar.

3. Seleccione Consumo y escriba los valores siguientes.

   Configuración	Valor sugerido
   Suscripción	Nombre de la suscripción de Azure
   Grupo de recursos	tutorial-de-sentimiento-de-tweets
   Nombre de la aplicación lógica	TweetSentimentApp
   Región	Seleccione la región más cercana, preferiblemente la misma que seleccionó en los pasos anteriores.

   Acepte los valores predeterminados para todas las demás configuraciones.

4. Seleccione Revisar + crear.

5. Seleccione Crear.

6. Una vez finalizada la implementación, seleccione Ir al recurso.

7. Seleccione el botón Aplicación lógica en blanco.

   Botón de Logic App en blanco

8. Seleccione el botón Guardar en la barra de herramientas para guardar el progreso.

Ahora puede usar el diseñador de aplicaciones lógicas para agregar servicios y desencadenadores a la aplicación.

Conexión a X

Cree una conexión a X para que la aplicación pueda sondear nuevos tweets.

1. Busque X en el cuadro de búsqueda superior.

2. Seleccione el icono X.

3. Seleccione el desencadenador Cuando se publica un tweet nuevo.

4. Escriba los siguientes valores para configurar la conexión.

   Configuración	Valor
   Nombre de conexión	MyXConnection
   Tipo de autenticación	Usar aplicación compartida predeterminada

5. Seleccione Iniciar sesión.

6. Siga las indicaciones de la ventana emergente para completar el inicio de sesión en X.

7. A continuación, escriba los siguientes valores en el cuadro Cuando se publica un tweet nuevo.

   Configuración	Valor
   Buscar texto	#my-x-tutorial
   ¿Con qué frecuencia quiere comprobar elementos?	1 en el cuadro de texto y Hora en el menú desplegable. Puede especificar valores diferentes, pero asegúrese de revisar las limitacionesactuales del conector X.

8. Seleccione el botón Guardar en la barra de herramientas para guardar el progreso.

A continuación, conéctese a Text Analytics para detectar la opinión de los tweets recopilados.

Incorporar la detección de sentimiento mediante Text Analytics

1. Seleccione Nuevo paso.

2. Busque Text Analytics en el cuadro de búsqueda.

3. Seleccione el icono Text Analytics.

4. Seleccione Detectar sentimiento y escriba los siguientes valores.

   Configuración	Valor
   Nombre de conexión	TextAnalyticsConnection
   Clave de cuenta	Pegue la clave de cuenta de Text Analytics que ha reservado anteriormente.
   Dirección URL del sitio	Pegue el punto de conexión de Text Analytics que ha reservado anteriormente.

5. Seleccione Crear.

6. Haga clic dentro del cuadro Agregar nuevo parámetro y active la casilla situada junto a documentos, que aparece en el menú emergente.

7. Haga clic en el cuadro de texto 'documentos Id - 1' para abrir la ventana emergente de contenido dinámico.

8. En el cuadro de búsqueda de contenido dinámico, busque por identificador y haga clic en ID de Tweet.

9. Haga clic dentro del cuadro de texto Text-1 de los documentos para abrir la ventana emergente de contenido dinámico.

10. En el cuadro de búsqueda contenido dinámico, busque el texto y haga clic en Texto del tweet.

11. En Elegir una acción, escriba Text Analytics y haga clic en la acción Detectar sentimiento.

12. Seleccione el botón Guardar en la barra de herramientas para guardar el progreso.

El cuadro Detectar sentimiento debe ser similar al de la captura de pantalla siguiente.

Configuración de detección de sentimiento

Conectar el resultado de sentimiento al endpoint de la función

1. Seleccione Nuevo paso.

2. Busque Azure Functions en el cuadro de búsqueda.

3. Seleccione el icono Azure Functions.

4. Busque el nombre de la función en el cuadro de búsqueda. Si ha seguido las instrucciones anteriores, el nombre de la función comenzará por TweetSentimentAPI.

5. Seleccione el icono de la función.

6. Seleccione el elemento TweetSentimentFunction.

7. Haga clic en el cuadro Cuerpo de la petición y seleccione el elemento Detectar sentimiento en la ventana emergente.

8. Seleccione el botón Guardar en la barra de herramientas para guardar el progreso.

Adición de un paso condicional

1. Seleccione el botón Agregar una acción.

2. Haga clic en el cuadro Control y busque y seleccione Control en la ventana emergente.

3. Seleccione Condición.

4. Haga clic en el cuadro Elegir un valor, y seleccione el elemento TweetSentimentFunctionBody en la ventana emergente.

5. Escriba Positivo en el cuadro Elegir un valor.

6. Seleccione el botón Guardar en la barra de herramientas para guardar el progreso.

Agregar notificaciones por correo electrónico

1. En el cuadro True, seleccione el botón Agregar una acción.

2. Busque y seleccione Office 365 Outlook en el cuadro de texto.

3. Busque send (enviar) y seleccione Send an email (Enviar un correo electrónico) en el cuadro de texto.

4. Haga clic en el botón Sign in (Iniciar sesión).

5. Siga las indicaciones de la ventana emergente para completar el inicio de sesión en Office 365 Outlook.

6. Escriba su dirección de correo electrónico en el campo Para.

7. Haga clic en el cuadro Asunto y, después, en el elemento Cuerpo de TweetSentimentFunction. Si el elemento Cuerpo no se muestra en la lista, haga clic en el vínculo Ver más para expandir la lista de opciones.

8. Después del elemento Cuerpo en el Asunto, introduzca el texto "Tweet de:"

9. Después del texto Tweet from: (Tweet de: ), haga clic nuevamente en el cuadro y seleccione User name (Nombre de usuario) de la lista de opciones de Cuando se publica un Tweet nuevo.

10. Haga clic en el cuadro Cuerpo y seleccione Texto del tweet en la lista de opciones de Cuando se publica un tweet nuevo. Si el elemento Texto del tweet no se muestra en la lista, haga clic en el vínculo Ver más para expandir la lista de opciones.

11. Seleccione el botón Guardar en la barra de herramientas para guardar el progreso.

El cuadro de correo electrónico debería ser como el de esta captura de pantalla.

Notificación de correo electrónico

Ejecución del flujo de trabajo

1. Desde tu cuenta X, tuitea el siguiente texto: Estoy disfrutando #mi-x-tutorial.

2. Vuelva al diseñador de aplicaciones lógicas y seleccione el botón Ejecutar.

3. Busque en el correo electrónico un mensaje del flujo de trabajo.

Limpieza de recursos

Para limpiar todos los servicios y cuentas de Azure creados durante este tutorial, elimine el grupo de recursos.

1. Busque Grupos de recursos en el cuadro de búsqueda superior.

2. Seleccione tweet-sentiment-tutorial.

3. Seleccione Eliminar grupo de recursos.

4. Escriba tweet-sentiment-tutorial en el cuadro de texto.

5. Seleccione el botón Eliminar.

Opcionalmente, puede que quiera volver a su cuenta X y eliminar los tweets de prueba de la fuente.

Pasos siguientes