大网数据广告活动
Azure 网站与应用

创建与 Azure 逻辑应用集成的函数

· 52CE 我爱测

创建一个与 Azure 逻辑应用和 Azure 认知服务集成的函数,对推文情绪进行分类,并在情绪较差时发送通知。

Azure Functions 在逻辑应用设计器中与 Azure 逻辑应用集成。 借助这种集成,可以利用 Functions 的计算能力来与其他 Azure 服务和第三方服务进行协调。

本教程介绍如何将 Azure Functions 与 Azure 上的逻辑应用和认知服务结合使用,以便对 Twitter 文章运行情绪分析。 HTTP 触发器函数根据情绪评分将推文分类为绿色、黄色或红色。 检测到较差的情感时,会发送一封电子邮件。

逻辑应用设计器中应用的前两个步骤的示意图

在本教程中,你将了解如何执行以下操作:

  • 创建认知服务 API 资源。
  • 创建一个用来对推文情感进行分类的函数。
  • 创建连接到 Twitter 的逻辑应用。
  • 将情感检测功能添加到逻辑应用。
  • 将逻辑应用连接到函数。
  • 根据函数的响应发送电子邮件。

先决条件

Note: 如果要使用 Gmail 连接器,则只有 G-Suite 商业帐户可以在逻辑应用中不受限制地使用此连接器。 如果有 Gmail 用户帐户,则只能将 Gmail 连接器与 Google 批准的特定应用和服务一起使用,也可以创建用于通过 Gmail 连接器进行身份验证的 Google 客户端应用。 有关详细信息,请参阅 Azure 逻辑应用中 Google 连接器的数据安全和隐私策略。

创建认知服务资源

Azure 中以单个资源的形式提供了认知服务 API。 使用文本分析 API 可检测受监视的推文观点。

  1. 登录 Azure 门户。

  2. 在 Azure 门户的左上角单击“创建资源”。

  3. 单击“AI + 机器学习” > “文本分析”。 然后,使用表中指定的设置来创建资源。

    创建认知资源页

    设置 建议的值 说明
    名称 MyCognitiveServicesAccnt 选择唯一的帐户名称。
    位置 美国西部 使用最靠近的位置。
    定价层 F0 从最低的层着手。 如果已用完调用配额,请扩展到更高的层。
    资源组 myResourceGroup 请本教程中的所有服务使用同一个资源组。
  4. 单击“创建”以创建资源。

  5. 单击“概览”,将“终结点”的值复制到文本编辑器。 创建到认知服务 API 的连接时使用此值。

    认知服务设置

  6. 在左侧导航栏中单击“密钥”,复制“密钥 1”的值并将其留存在文本编辑器中。 使用此密钥将逻辑应用连接到认知服务 API。

    认知服务密钥

创建函数应用

Azure Functions 可让你方便地卸载逻辑应用工作流中的处理任务。 本教程使用 HTTP 触发器函数处理认知服务提供的推文情绪评分,并返回一个类别值。

  1. 在 Azure 门户菜单或“主页”页中,选择“创建资源” 。

  2. 在 “新建” 页面,选择 “计算” > “函数应用” 。

  3. 在“基本信息”页上,使用下表中指定的函数应用设置。

    设置 建议的值 说明
    订阅 你的订阅 要在其下创建此新函数应用的订阅。
    资源组 myResourceGroup 要在其中创建 Function App 的新资源组的名称。
    函数应用名称 全局唯一名称 用于标识新 Function App 的名称。 有效字符为 a-z(不区分大小写)、0-9 和 -。
    <bpt id="p1"></bpt>Publish<ept id="p1"></ept> 代码 用于发布代码文件或 Docker 容器的选项。
    运行时堆栈 首选语言 选择支持你喜欢的函数编程语言的运行时。 门户中编辑仅适用于 JavaScript、PowerShell、TypeScript 和 C# 脚本。 C# 类库、Java 和 Python 函数必须在本地开发。
    版本 版本号 选择已安装的运行时的版本。
    区域 首选区域 选择离你近或离函数访问的其他服务近的区域。
  4. 选择“下一步: 托管”。 在“托管”页上,输入以下设置。

    设置 建议的值 说明
    存储帐户 全局唯一名称 创建函数应用使用的存储帐户。 存储帐户名称必须为 3 到 24 个字符,并且只能包含数字和小写字母。 也可使用现有帐户,但该帐户必须符合存储帐户要求。
    操作系统 Windows 系统会根据你的运行时堆栈选择为你预先选择一个操作系统,但你可以根据需要更改该设置。 仅在 Windows 上支持门户内编辑。
    计划 消耗(无服务器) 定义如何将资源分配给 Function App 的托管计划。 在默认的 消耗 计划中,根据函数需求动态添加资源。 在此无服务器托管中,只需为函数运行时间付费。 按应用服务计划运行时,必须管理函数应用的缩放。
  5. 选择“下一步: 监视”。 在“监视”页上,输入以下设置。

    设置 建议的值 说明
    Application Insights 默认 在最近的受支持的区域中,创建一个具有相同应用名称的 Application Insights 资源。 通过展开此设置或选择“新建”,可以更改 Application Insights 名称或在 Azure 地理位置中选择要存储数据的其他区域。
  6. 选择“查看 + 创建”,以便查看应用配置选择。

  7. 在“查看 + 创建”页上查看设置,然后选择“创建”来预配并部署函数应用 。

  8. 选择门户右上角的“通知”图标,留意是否显示了“部署成功”消息。

  9. 选择“转到资源”,查看新的函数应用。 还可选择“固定到仪表板”。 固定可以更轻松地从仪表板返回此函数应用资源。

    部署通知

创建 HTTP 触发器函数

  1. 从“Functions”窗口的左侧菜单中选择“Functions”,然后从顶部菜单中选择“添加”。

  2. 在“新建函数”窗口中,选择“HTTP 触发器”。

    选择 HTTP 触发器函数

  3. 在“新建函数”页中,选择“创建函数”。

  4. 在新的 HTTP 触发器函数中,从左侧菜单中选择“代码 + 测试”,将 run.csx 文件的内容替换为以下代码,然后选择“保存”:

    #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 category = "GREEN";
    
        string requestBody = await new StreamReader(req.Body).ReadToEndAsync();
        log.LogInformation(string.Format("The sentiment score received is '{0}'.", requestBody));
    
        double score = Convert.ToDouble(requestBody);
    
        if(score < .3)
        {
            category = "RED";
        }
        else if (score < .6) 
        {
            category = "YELLOW";
        }
    
        return requestBody != null
            ? (ActionResult)new OkObjectResult(category)
            : new BadRequestObjectResult("Please pass a value on the query string or in the request body");
    }
    

    此函数代码基于请求中收到的情感评分返回颜色类别。

  5. 若要测试函数,请从顶部菜单中选择“测试”。 在“输入”选项卡上,在“正文”中输入值 0.2,然后选择“运行”。 “输出”选项卡上的“HTTP 响应内容”中会返回值“RED”。

    定义代理设置

现已创建一个可对情感评分分类的函数。 接下来,请创建用于将函数与 Twitter 和认知服务 API 集成的逻辑应用。

创建逻辑应用

  1. 在 Azure 门户中,单击位于 Azure 门户左上角的“创建资源”按钮。

  2. 单击“Web” > “逻辑应用”。

  3. 然后,键入一个值(例如 TweetSentiment)作为 名称,并使用表中指定的设置。

    在 Azure 门户创建逻辑应用

    设置 建议的值 说明
    名称 TweetSentiment 选择适当的应用名称。
    资源组 myResourceGroup 选择与前面相同的现有资源组。
    位置 美国东部 选择靠近你的位置。
  4. 输入适当的设置值以后,请单击“创建”以创建逻辑应用。

  5. 创建应用后,请单击已固定到仪表板的新逻辑应用。 然后,在逻辑应用设计器中向下滚动并单击“空白逻辑应用”模板。

    “空白逻辑应用”模板

现在,可以使用逻辑应用设计器将服务和触发器添加到应用。

连接到 Twitter

首先,请与 Twitter 帐户建立连接。 逻辑应用将轮询推文,这会触发应用运行。

  1. 在设计器中单击“Twitter”服务,并单击“发布新推文时”触发器。 登录到 Twitter 帐户,并授权逻辑应用使用你的帐户。

  2. 使用表中指定的 Twitter 触发器设置。

    Twitter 连接器设置

    设置 建议的值 说明
    搜索文本 #Azure 使用足够热门的井号标签按所选的间隔生成新的推文。 如果使用免费层并且井号标签过于热门,可能很快就会用完认知服务 API 中的事务配额。
    间隔 15 每两次处理 Twitter 请求所用的时间,采用频率单位。
    频率 Minute 用于轮询 Twitter 的频率单位。
  3. 单击“保存”连接到 Twitter 帐户。

应用现已连接到 Twitter。 接下来,请连接到文本分析以检测收集到的推文的情感。

添加情感检测

  1. 单击“新建步骤”,并单击“添加操作”。

  2. 在“选择操作”中键入“文本分析”,然后单击“检测情感”操作。

    显示“选择操作”部分的屏幕截图,在搜索框中包含“文本分析”并已选择“检测情绪”操作。

  3. 键入连接名称(例如 MyCognitiveServicesConnection),粘贴在文本编辑器中留存的认知服务 API 和认知服务终结点的密钥,然后单击“创建”。

    选择“新建步骤”,并选择“添加操作”

  4. 接下来,在文本框中输入“推文文本”,然后单击“新建步骤”。

    定义要分析的文本

配置情感检测后,可将一个连接添加到使用情感评分输出的函数。

将情感输出连接到函数

  1. 在逻辑应用设计器中单击“新建步骤” > “添加操作”,在 Azure Functions 上进行筛选,然后单击“选择一个 Azure 函数”。

    检测情感

  2. 选择前面创建的函数应用。

    屏幕截图,显示选择了函数应用的“选择操作”部分。

  3. 选择为本教程创建的函数。

    选择函数

  4. 在“请求正文”中单击“评分”,并单击“保存”。

    Score

现在,在从逻辑应用发送情感评分时,将触发该函数。 该函数会将一个带有颜色编码的类别返回到逻辑应用。 接下来,请添加当函数返回 RED 情感值时要发送的电子邮件通知。

添加电子邮件通知

工作流的最后一部分是当情感评分为 RED 时触发电子邮件。 本文使用 Outlook.com 连接器。 可以执行类似的步骤来使用 Gmail 或 Office 365 Outlook 连接器。

  1. 在逻辑应用设计器中,单击“新建步骤” > “添加条件”。

    将条件添加到逻辑应用。

  2. 单击“选择值”,并单击“正文”。 选择“等于”,单击“选择值”并键入 RED,然后单击“保存”。

    为条件选择操作。

  3. 在“如果是”中单击“添加操作”,搜索 outlook.com,单击“发送电子邮件”,并登录到 Outlook.com 帐户。

    显示“IF TRUE”部分的屏幕截图,其中在搜索框中输入了“outlook.com”,并且已选择“发送电子邮件”操作。

    NOTE 如果没有 Outlook.com 帐户,可以选择另一个连接器,例如 Gmail 或 Office 365 Outlook

  4. 在“发送电子邮件”操作中,请使用表中指定的电子邮件设置。

    为“发送电子邮件”操作配置电子邮件。

设置 建议的值 说明
收件人 键入电子邮件地址 接收通知的电子邮件地址。
主题 检测到消极的推文情感 电子邮件通知的主题行。
正文 推文文本、位置 单击“推文文本”和“位置”参数。
  1. 单击“ 保存”。

完成工作流后,可以启用逻辑应用并查看函数的工作状态。

测试工作流

  1. 在逻辑应用设计器中,单击“运行”启动应用。

  2. 在左列中,单击“概述”查看逻辑应用的状态。

    逻辑应用执行状态

  3. (可选)单击某个运行查看执行详细信息。

  4. 转到函数,查看日志,并验证是否已收到并处理情绪值。

    查看函数日志

  5. 检测到潜在的消极情感时,将收到一封电子邮件。 如果未收到电子邮件,可以更改函数代码,以便每次都返回 RED:

    return (ActionResult)new OkObjectResult("RED");
    

    验证电子邮件通知后,请改回原始代码:

    return requestBody != null
        ? (ActionResult)new OkObjectResult(category)
        : new BadRequestObjectResult("Please pass a value on the query string or in the request body");
    

    IMPORTANT 完成本教程后,应禁用该逻辑应用。 禁用该应用可以避免产生执行费用,以及用完认知服务 API 中的事务配额。

现在,你已了解将 Functions 集成到逻辑应用工作流中是多么简单。

禁用逻辑应用

要禁用逻辑应用,请单击“概述”,并单击屏幕顶部的“禁用”。 禁用应用会停止应用的运行并避免产生费用,同时又不必删除该应用。

函数日志

后续步骤

在本教程中,你了解了如何执行以下操作:

  • 创建认知服务 API 资源。
  • 创建一个用来对推文情感进行分类的函数。
  • 创建连接到 Twitter 的逻辑应用。
  • 将情感检测功能添加到逻辑应用。
  • 将逻辑应用连接到函数。
  • 根据函数的响应发送电子邮件。

请继续学习下一教程,了解如何为函数创建无服务器 API。

使用 Azure Functions 创建无服务器 API

若要详细了解逻辑应用,请参阅 Azure 逻辑应用。

历史资料。此文对应 2022-08-12 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者(原始作者元数据 craigshoemaker)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体、发布器占位标签和导航标记。

资料来源与适用范围

资料来源
Microsoft / Azure 中文运维文档历史快照
适用范围
历史中文快照 2022-08-12;详见原文产品版本;文档日期 04/27/2020
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。