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

Мақала
06/01/2023

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

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

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

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

Необходимые компоненты

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

Примечание.

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

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

Создание ресурса «Анализ текстов»

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

Войдите на портал Azure.
Щелкните Создать ресурс в верхнем левом углу окна портала Azure.
В разделе Категории выберите Средства ИИ и машинного обучения
В разделе Анализ текста выберите Создать.

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

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

Выберите Review + create (Просмотреть и создать).
Нажмите кнопку создания.
После завершения работы развернутой службы выберите Перейти к ресурсу.

Получение параметров ресурса «Анализ текста»

После создания ресурса «Анализ текста» вы сможете скопировать несколько параметров и настроить их для последующего использования.

Выберите Ключи и конечная точка.
Скопируйте ключ 1, щелкнув иконку значка в конце поля ввода.
Вставьте значение в текстовый редактор.
Скопируйте конечную точку, щелкнув значок в конце поля ввода.
Вставьте значение в текстовый редактор.

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

В верхнем поле поиска найдите и выберите Приложение-функция.
Нажмите кнопку создания.

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

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

Выберите Review + create (Просмотреть и создать).
Нажмите кнопку создания.
После завершения работы развернутой службы выберите Перейти к ресурсу.

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

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

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

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

Нажмите кнопку Добавить.
Нажмите кнопку Код + тест.

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

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

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

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

Примечание.

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

Затем создайте приложение логики, которое интегрируется с Функции Azure, Twitter и API служб искусственного интеллекта Azure.

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

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

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

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

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

Выберите Review + create (Просмотреть и создать).
Нажмите кнопку создания.
После завершения работы развернутой службы выберите Перейти к ресурсу.
Нажмите кнопку Пустое приложение логики.
Нажмите кнопку Сохранить на панели инструментов, чтобы сохранить прогресс.

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

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

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

Найдите Twitter в верхнем поле поиска.
Выберите иконку Twitter.
Выберите триггер Время публикации нового твита.

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

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

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

Затем введите следующие значения в поле Когда публикуется новый твит.

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

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

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

Добавление Анализ текста обнаружения тональности

Выберите Создать шаг.
В поле поиска введите Анализ текста.
Выберите иконку Анализ текста.

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

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

Нажмите кнопку создания.
Щелкните внутри поля Добавить новый параметр и установите флажок рядом с документами, который появляется во всплывающем окне.
Щелкните текстовое поле Идентификаторы документа - 1, чтобы открыть всплывающее окно с динамическим содержимым.
В поле поиска динамического содержимого найдите идентификатори щелкните идентификатор твита.
Щелкните текстовое поле Идентификаторы документа - 1, чтобы открыть всплывающее окно с динамическим содержимым.
В поле поиска динамического содержимого найдите идентификатори щелкните идентификатор твита.
На странице выбора действия введите Текстовая аналитика и выберите действие Определить тональность.
Нажмите кнопку Сохранить на панели инструментов, чтобы сохранить прогресс.

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

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

Выберите Создать шаг.
В поле поиска введите Функции Azure.
Выберите иконку Функции Azure.
Найдите название своей функции в поле поиска. Если вы следовали приведенным выше инструкциям, имя вашей функции будет начинаться с TweetSentimentAPI.
Выберите значок функции.
Выберите элемент TweetSentimentFunction.
Щелкните внутри поля Текст запроса и выберите во всплывающем окне пункт Определить тональность для оценки тональности.
Нажмите кнопку Сохранить на панели инструментов, чтобы сохранить прогресс.

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

Нажмите кнопку Добавить действие.
Щелкните внутри поля Контроль, найдите и выберите Контроль во всплывающем окне.
Выберите Условие.
Щелкните внутри поля Выберите значение и выберите во всплывающем окне элемент TweetSentimentFunction Body.
Введите Положительное значение в поле Выбор значения.
Нажмите кнопку Сохранить на панели инструментов, чтобы сохранить прогресс.

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

В поле Верно нажмите кнопку Добавить действие.
Найдите и выберите Office 365 Outlook в текстовом поле.
Найдите Отправить и в текстовом поле выберите Отправить электронное письмо.
Нажмите кнопку Войти.
Следуйте инструкциям во всплывающем окне, чтобы завершить вход в Office 365 Outlook.
Введите свой адрес электронной почты в поле Кому.
Щелкните внутри поля Тема и выберите элемент Текст в разделе TweetSentimentFunction. Если элемент Текст не отображается в списке, нажмите ссылку Подробнее, чтобы развернуть список параметров.
После элемента Текст в поле Тема введите текст Твит от:.
После текста Твит от: снова щелкните поле и выберите Имя пользователя в списке параметров Когда публикуется новый твит.
Щелкните внутри поля Текст и выберите Текст твита под списком параметров Когда публикуется новый твит. Если элемент Текст твита не отображается в списке, нажмите ссылку Подробнее, чтобы развернуть список параметров.
Нажмите кнопку Сохранить на панели инструментов, чтобы сохранить прогресс.

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

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

В своем аккаунте Twitter напишите в Твиттере следующий текст: Мне нравится #my-twitter-tutorial.
Вернитесь в конструктор Logic Apps и нажмите кнопку Выполнить.
Проверьте свою электронную почту на наличие сообщения из рабочего процесса.

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

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

Найдите Группы ресурсов в верхнем поле поиска.
Выберите tweet-sentiment-tutorial.
Выберите Удалить группу ресурсов
Введите в текстовое поле tweet-sentiment-tutorial.
Нажмите кнопку Удалить.

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

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

Создание бессерверного API с помощью Функций Azure

Бөлісу құралы: