Руководство. Создание функции для интеграции с Azure Logic Apps

Azure Functions интегрируется с Azure Logic Apps в конструкторе Logic Apps. Эта интеграция позволяет использовать вычислительные мощности Azure Functions в оркестровке с другими службами Azure и службами сторонних разработчиков.

В этом руководстве показано, как создать рабочий процесс для анализа действий X. По мере того как оцениваются твиты, рабочий процесс отправляет уведомления при обнаружении положительных настроений.

Из этого руководства вы узнаете, как:

  • Создайте ресурс API средств Foundry.
  • Создание функции, классифицирующей мнения, выраженные в твитах.
  • Создайте приложение логики, которое подключается к X.
  • Добавление обнаружения мнений в приложение логики.
  • Подключите приложение логики к функции.
  • Отправка электронного сообщения на основе ответа из функции.

Предварительные условия

  • Активная учетная запись X .
  • Учетная запись Outlook.com (для отправки уведомлений).

Примечание.

Только учетные записи G-Suite для бизнеса могут использовать коннектор Gmail без ограничений в логических приложениях. Если у вас есть учетная запись потребителя Gmail, вы можете использовать соединитель Gmail только с определенными приложениями и службами, утвержденными Google, или вы можете создать клиентское приложение Google для проверки подлинности в соединителе Gmail.

Дополнительные сведения см. в разделе Политики безопасности данных и конфиденциальности для соединителей Google в Azure Logic Apps.

Создание ресурса Text Analytics

API-интерфейсы средств Foundry доступны в Azure в виде отдельных ресурсов. Используйте API Text Analytics для обнаружения тональности опубликованных твитов.

  1. Войдите на портал Azure.

  2. Выберите Create a resource в левом верхнем углу портала Azure.

  3. В разделе Категории выберите AI + Machine Learning

  4. В разделе Text Analytics выберите Create.

  5. Введите следующие значения на экране Create Text Analytics.

    Настройка Значение Замечания
    Подписка Название подписки Azure
    Группа ресурсов Создание группы ресурсов с именем tweet-sentiment-tutorial Позже вы удалите эту группу ресурсов, чтобы удалить все ресурсы, созданные в рамках данного руководства.
    Область/регион Выберите ближайший к вам регион
    Имя. TweetSentimentApp
    Ценовая категория Выберите "Бесплатный F0"

  6. Выберите Review + create.

  7. Нажмите кнопку "Создать".

  8. После завершения развертывания выберите "Перейти к ресурсу".

Получите параметры Text Analytics

С помощью созданного Text Analytics ресурса можно скопировать несколько параметров и отложить их для последующего использования.

  1. Выберите ключи и конечную точку.

  2. Скопируйте ключ 1 , щелкнув значок в конце поля ввода.

  3. Вставьте значение в текстовый редактор.

  4. Скопируйте конечную точку , щелкнув значок в конце поля ввода.

  5. Вставьте значение в текстовый редактор.

Создайте приложение-функцию

  1. В верхней строке поиска найдите и выберите функциональное приложение.

  2. Нажмите кнопку "Создать".

  3. Введите следующие значения.

    Настройка Рекомендуемое значение Замечания
    Подписка Имя подписки Azure
    Группа ресурсов твит-анализ-тональности-руководство В данном руководстве следует использовать одно и то же имя группы ресурсов.
    Имя функции в приложении TweetSentimentAPI + уникальный суффикс Имена приложений функций являются глобально уникальными. Допустимые символы: a-z (без учета регистра), 0-9 и -.
    Публикация Код
    Стек среды выполнения .NET Код функции, предоставленный для вас, находится на C#.
    Версия Выберите номер последней версии
    Область/регион Выберите ближайший к вам регион

  4. Выберите Review + create.

  5. Нажмите кнопку "Создать".

  6. После завершения развертывания выберите "Перейти к ресурсу".

Создание функции, активируемой по HTTP

  1. В левом меню окна "Функции" выберите "Функции".

  2. Выберите "Добавить" в верхнем меню и введите следующие значения.

    Настройка Значение Замечания
    Среда разработки Разработка на портале
    Шаблон Триггер HTTP
    Новая функция TweetSentimentFunction Это имя вашей функции.
    Уровень авторизации Функция

  3. Нажмите кнопку Добавить.

  4. Нажмите кнопку "Код + тест ".

  5. Вставьте нижеприведенный код в окно редактора кода.

    #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.");
}

    Оценка настроения передается в функцию, которая возвращает название категории на основе значения.

  6. Нажмите кнопку "Сохранить " на панели инструментов, чтобы сохранить изменения.

    Примечание.

    Чтобы проверить функцию, выберите "Тест и запуск " в верхнем меню. На вкладке "Входные данные" введите значение 0.9 в поле ввода текста и нажмите кнопку "Выполнить". Убедитесь, что значение "Положительный" возвращается в поле содержимого ответа HTTP в разделе "Выходные данные ".

Затем создайте приложение логики, которое интегрируется с Azure Functions, X и API средств Foundry.

Создание приложения логики

  1. В верхнем поле поиска найдите и выберите Logic Apps.

  2. Нажмите кнопку "Добавить".

  3. Выберите "Потребление" и введите следующие значения.

    Настройка Рекомендуемое значение
    Подписка Имя вашей подписки Azure
    Группа ресурсов twitter-тональность-учебник
    Имя приложения логики TweetSentimentApp
    Область/регион Выберите ближайший к вам регион, желательно тот же регион, который вы выбрали в рамках предыдущих этапов.

    Для остальных параметров оставьте значения по умолчанию.

  4. Выберите Review + create.

  5. Нажмите кнопку "Создать".

  6. После завершения развертывания выберите "Перейти к ресурсу".

  7. Нажмите кнопку «Пустое приложение логики»

    Кнопка

  8. Нажмите кнопку "Сохранить " на панели инструментов, чтобы сохранить ход выполнения.

Теперь вы можете использовать Logic Apps Designer для добавления служб и триггеров в свое приложение.

Подключение к X

Создайте подключение к X, чтобы ваше приложение могло опрашивать новые твиты.

  1. Найдите X в верхнем поле поиска.

  2. Выберите значок X .

  3. Выберите триггер Когда опубликован новый твит.

  4. Введите следующие значения для настройки соединения.

    Настройка Значение
    Имя подключения MyXConnection
    Тип проверки подлинности Использование общего приложения по умолчанию

  5. Выберите Вход.

  6. Следуйте инструкциям во всплывающем окне, чтобы завершить вход в X.

  7. Затем введите следующие значения в поле "При публикации нового твита ".

    Настройка Значение
    Текст поискового запроса руководство по #my-x
    Как часто вам нужно проверять наличие элементов? 1 в текстовом поле и
    Час в раскрывающемся списке. Вы можете ввести разные значения, но не забудьте проверить текущие ограничения соединителя X.

  8. Нажмите кнопку "Сохранить " на панели инструментов, чтобы сохранить ход выполнения.

Затем подключитесь к аналитике текста, чтобы определить тональность собранных твитов.

Добавление обнаружения тональности в «Text Analytics»

  1. Выберите Создать шаг.

  2. Найдите Text Analytics в поле поиска.

  3. Щелкните значок Text Analytics.

  4. Выберите "Определить тональность" и введите следующие значения.

    Настройка Значение
    Имя подключения TextAnalyticsConnection
    Ключ учетной записи Вставьте ключ учетной записи Text Analytics, который вы сохранили ранее.
    URL-адрес сайта Вставьте ранее отложенную конечную точку Text Analytics.

  5. Нажмите кнопку "Создать".

  6. Щелкните в поле "Добавить новый параметр " и установите флажок рядом с документами , которые отображаются во всплывающем окне.

  7. Щелкните внутри идентификатор документа — 1, чтобы открыть всплывающее окно динамического содержимого.

  8. В поле поиска динамического содержимого найдите идентификатор и щелкните идентификатор твита.

  9. Щелкните внутри документа текст — 1 , чтобы открыть всплывающее окно динамического содержимого.

  10. В поле динамического поиска контента найдите текст и щелкните текст твита.

  11. В Выберите действие введите Text Analytics, а затем щелкните действие Определить настроение.

  12. Нажмите кнопку "Сохранить " на панели инструментов, чтобы сохранить ход выполнения.

Поле «Обнаружение тональности» должно выглядеть как на следующем скриншоте.

Определение параметров тональности

Подключить выходные данные анализа настроений к конечной точке функции

  1. Выберите Создать шаг.

  2. Найдите Azure Functions в поле поиска.

  3. Щелкните значок Azure Functions.

  4. Найдите название своей функции в поле поиска. Если вы выполнили приведенные выше рекомендации, имя функции начинается с TweetSentimentAPI.

  5. Выберите значок функции.

  6. Выберите элемент TweetSentimentFunction.

  7. Щелкните внутри поля "Текст запроса" и выберите элемент Обнаружение тональностиоценка во всплывающем окне.

  8. Нажмите кнопку "Сохранить " на панели инструментов, чтобы сохранить ход выполнения.

Добавить условный шаг

  1. Нажмите кнопку "Добавить действие ".

  2. Щелкните в поле "Элемент управления" и найдите и выберите "Элемент управления" во всплывающем окне.

  3. Выберите условие.

  4. Щелкните внутри поля "Выбор значения" и выберите элемент bodyTweetSentimentFunction в всплывающем окне.

  5. Введите "Положительный результат " в поле "Выбор значения ".

  6. Нажмите кнопку "Сохранить " на панели инструментов, чтобы сохранить ход выполнения.

Добавление уведомлений по почте

  1. В поле True нажмите кнопку "Добавить действие ".

  2. Найдите и выберите Office 365 Outlook в текстовом поле.

  3. Найдите отправку и выберите "Отправить сообщение электронной почты " в текстовом поле.

  4. Нажмите кнопку Войти.

  5. Следуйте инструкциям во всплывающем окне, чтобы завершить вход в Office 365 Outlook.

  6. Введите адрес электронной почты в поле "To ".

  7. Щелкните внутри поля "Тема" и выберите элемент "Тело" в функции TweetSentimentFunction. Если элемент Тело не отображается в списке, щелкните ссылку Показать больше, чтобы раскрыть список параметров.

  8. После элемента Тело в теме введите текст твит из:.

  9. После текста «Твит от:» нажмите на поле ещё раз и выберите Имя пользователя из списка опций При публикации нового твита.

  10. Щелкните в поле "Текст" и выберите текст твита в списке параметров публикации нового твита . Если текстовый элемент твита не отображается в списке, щелкните ссылку "Дополнительные сведения", чтобы развернуть список параметров.

  11. Нажмите кнопку "Сохранить " на панели инструментов, чтобы сохранить ход выполнения.

Электронный почтовый ящик теперь должен выглядеть, как на этом снимке экрана.

Уведомление по электронной почте

Запуск рабочего процесса

  1. В учетной записи X опубликуйте следующий текст: Я наслаждаюсь #my-x-tutorial.

  2. Вернитесь в конструктор Logic Apps и нажмите кнопку "Выполнить ".

  3. Проверьте свою электронную почту на наличие сообщения из рабочего процесса.

Очистка ресурсов

Чтобы очистить все службы и учетные записи Azure, созданные в рамках этого руководства, удалите группу ресурсов.

  1. Найдите группы ресурсов в верхнем поле поиска.

  2. Выберите tweet-sentiment-tutorial.

  3. Выберите "Удалить группу ресурсов"

  4. Введите твит-тональность-руководство в текстовом поле.

  5. Нажмите кнопку Удалить.

По желанию вы можете вернуться к своей учетной записи X и удалить тестовые твиты из ленты.

Следующие шаги

Создайте бессерверный API с помощью Azure Functions

  • Last updated on