Azure Functions 在逻辑应用设计器中与 Azure 逻辑应用集成。 借助这种集成,可以利用 Functions 的计算能力来与其他 Azure 服务和第三方服务进行协调。
本教程介绍如何将 Azure Functions 与 Azure 上的逻辑应用和认知服务结合使用,以便对 Twitter 文章运行情绪分析。 HTTP 触发器函数根据情绪评分将推文分类为绿色、黄色或红色。 检测到较差的情感时,会发送一封电子邮件。
逻辑应用设计器中应用的前两个步骤的示意图
在本教程中,你将了解如何执行以下操作:
- 创建认知服务 API 资源。
- 创建一个用来对推文情感进行分类的函数。
- 创建连接到 Twitter 的逻辑应用。
- 将情感检测功能添加到逻辑应用。
- 将逻辑应用连接到函数。
- 根据函数的响应发送电子邮件。
先决条件
- 有效的 Twitter 帐户。
- Outlook.com 帐户(用于发送通知)。
Note: 如果要使用 Gmail 连接器,则只有 G-Suite 商业帐户可以在逻辑应用中不受限制地使用此连接器。 如果有 Gmail 用户帐户,则只能将 Gmail 连接器与 Google 批准的特定应用和服务一起使用,也可以创建用于通过 Gmail 连接器进行身份验证的 Google 客户端应用。 有关详细信息,请参阅 Azure 逻辑应用中 Google 连接器的数据安全和隐私策略。
- 本文以在从 Azure 门户创建第一个函数主题中创建的资源为基础。 现在请完成以下步骤创建 Function App(如果尚未这样做)。
创建认知服务资源
Azure 中以单个资源的形式提供了认知服务 API。 使用文本分析 API 可检测受监视的推文观点。
-
登录 Azure 门户。
-
在 Azure 门户的左上角单击“创建资源”。
-
单击“AI + 机器学习” > “文本分析”。 然后,使用表中指定的设置来创建资源。
创建认知资源页
设置 建议的值 说明 名称 MyCognitiveServicesAccnt 选择唯一的帐户名称。 位置 美国西部 使用最靠近的位置。 定价层 F0 从最低的层着手。 如果已用完调用配额,请扩展到更高的层。 资源组 myResourceGroup 请本教程中的所有服务使用同一个资源组。 -
单击“创建”以创建资源。
-
单击“概览”,将“终结点”的值复制到文本编辑器。 创建到认知服务 API 的连接时使用此值。
认知服务设置
-
在左侧导航栏中单击“密钥”,复制“密钥 1”的值并将其留存在文本编辑器中。 使用此密钥将逻辑应用连接到认知服务 API。
认知服务密钥
创建函数应用
Azure Functions 可让你方便地卸载逻辑应用工作流中的处理任务。 本教程使用 HTTP 触发器函数处理认知服务提供的推文情绪评分,并返回一个类别值。
-
在 Azure 门户菜单或“主页”页中,选择“创建资源” 。
-
在 “新建” 页面,选择 “计算” > “函数应用” 。
-
在“基本信息”页上,使用下表中指定的函数应用设置。
设置 建议的值 说明 订阅 你的订阅 要在其下创建此新函数应用的订阅。 资源组 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 函数必须在本地开发。 版本 版本号 选择已安装的运行时的版本。 区域 首选区域 选择离你近或离函数访问的其他服务近的区域。 -
选择“下一步: 托管”。 在“托管”页上,输入以下设置。
设置 建议的值 说明 存储帐户 全局唯一名称 创建函数应用使用的存储帐户。 存储帐户名称必须为 3 到 24 个字符,并且只能包含数字和小写字母。 也可使用现有帐户,但该帐户必须符合存储帐户要求。 操作系统 Windows 系统会根据你的运行时堆栈选择为你预先选择一个操作系统,但你可以根据需要更改该设置。 仅在 Windows 上支持门户内编辑。 计划 消耗(无服务器) 定义如何将资源分配给 Function App 的托管计划。 在默认的 消耗 计划中,根据函数需求动态添加资源。 在此无服务器托管中,只需为函数运行时间付费。 按应用服务计划运行时,必须管理函数应用的缩放。 -
选择“下一步: 监视”。 在“监视”页上,输入以下设置。
设置 建议的值 说明 Application Insights 默认 在最近的受支持的区域中,创建一个具有相同应用名称的 Application Insights 资源。 通过展开此设置或选择“新建”,可以更改 Application Insights 名称或在 Azure 地理位置中选择要存储数据的其他区域。 -
选择“查看 + 创建”,以便查看应用配置选择。
-
在“查看 + 创建”页上查看设置,然后选择“创建”来预配并部署函数应用 。
-
选择门户右上角的“通知”图标,留意是否显示了“部署成功”消息。
-
选择“转到资源”,查看新的函数应用。 还可选择“固定到仪表板”。 固定可以更轻松地从仪表板返回此函数应用资源。
部署通知
创建 HTTP 触发器函数
-
从“Functions”窗口的左侧菜单中选择“Functions”,然后从顶部菜单中选择“添加”。
-
在“新建函数”窗口中,选择“HTTP 触发器”。
选择 HTTP 触发器函数
-
在“新建函数”页中,选择“创建函数”。
-
在新的 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"); }此函数代码基于请求中收到的情感评分返回颜色类别。
-
若要测试函数,请从顶部菜单中选择“测试”。 在“输入”选项卡上,在“正文”中输入值
0.2,然后选择“运行”。 “输出”选项卡上的“HTTP 响应内容”中会返回值“RED”。
现已创建一个可对情感评分分类的函数。 接下来,请创建用于将函数与 Twitter 和认知服务 API 集成的逻辑应用。
创建逻辑应用
-
在 Azure 门户中,单击位于 Azure 门户左上角的“创建资源”按钮。
-
单击“Web” > “逻辑应用”。
-
然后,键入一个值(例如
TweetSentiment)作为 名称,并使用表中指定的设置。在 Azure 门户创建逻辑应用
设置 建议的值 说明 名称 TweetSentiment 选择适当的应用名称。 资源组 myResourceGroup 选择与前面相同的现有资源组。 位置 美国东部 选择靠近你的位置。 -
输入适当的设置值以后,请单击“创建”以创建逻辑应用。
-
创建应用后,请单击已固定到仪表板的新逻辑应用。 然后,在逻辑应用设计器中向下滚动并单击“空白逻辑应用”模板。
“空白逻辑应用”模板
现在,可以使用逻辑应用设计器将服务和触发器添加到应用。
连接到 Twitter
首先,请与 Twitter 帐户建立连接。 逻辑应用将轮询推文,这会触发应用运行。
-
在设计器中单击“Twitter”服务,并单击“发布新推文时”触发器。 登录到 Twitter 帐户,并授权逻辑应用使用你的帐户。
-
使用表中指定的 Twitter 触发器设置。
Twitter 连接器设置
设置 建议的值 说明 搜索文本 #Azure 使用足够热门的井号标签按所选的间隔生成新的推文。 如果使用免费层并且井号标签过于热门,可能很快就会用完认知服务 API 中的事务配额。 间隔 15 每两次处理 Twitter 请求所用的时间,采用频率单位。 频率 Minute 用于轮询 Twitter 的频率单位。 -
单击“保存”连接到 Twitter 帐户。
应用现已连接到 Twitter。 接下来,请连接到文本分析以检测收集到的推文的情感。
添加情感检测
-
单击“新建步骤”,并单击“添加操作”。
-
在“选择操作”中键入“文本分析”,然后单击“检测情感”操作。
显示“选择操作”部分的屏幕截图,在搜索框中包含“文本分析”并已选择“检测情绪”操作。
-
键入连接名称(例如
MyCognitiveServicesConnection),粘贴在文本编辑器中留存的认知服务 API 和认知服务终结点的密钥,然后单击“创建”。选择“新建步骤”,并选择“添加操作”
-
接下来,在文本框中输入“推文文本”,然后单击“新建步骤”。
定义要分析的文本
配置情感检测后,可将一个连接添加到使用情感评分输出的函数。
将情感输出连接到函数
-
在逻辑应用设计器中单击“新建步骤” > “添加操作”,在 Azure Functions 上进行筛选,然后单击“选择一个 Azure 函数”。
检测情感
-
选择前面创建的函数应用。
屏幕截图,显示选择了函数应用的“选择操作”部分。
-
选择为本教程创建的函数。
选择函数
-
在“请求正文”中单击“评分”,并单击“保存”。
Score
现在,在从逻辑应用发送情感评分时,将触发该函数。 该函数会将一个带有颜色编码的类别返回到逻辑应用。 接下来,请添加当函数返回 RED 情感值时要发送的电子邮件通知。
添加电子邮件通知
工作流的最后一部分是当情感评分为 RED 时触发电子邮件。 本文使用 Outlook.com 连接器。 可以执行类似的步骤来使用 Gmail 或 Office 365 Outlook 连接器。
-
在逻辑应用设计器中,单击“新建步骤” > “添加条件”。
将条件添加到逻辑应用。
-
单击“选择值”,并单击“正文”。 选择“等于”,单击“选择值”并键入
RED,然后单击“保存”。为条件选择操作。
-
在“如果是”中单击“添加操作”,搜索
outlook.com,单击“发送电子邮件”,并登录到 Outlook.com 帐户。显示“IF TRUE”部分的屏幕截图,其中在搜索框中输入了“outlook.com”,并且已选择“发送电子邮件”操作。
NOTE 如果没有 Outlook.com 帐户,可以选择另一个连接器,例如 Gmail 或 Office 365 Outlook
-
在“发送电子邮件”操作中,请使用表中指定的电子邮件设置。
为“发送电子邮件”操作配置电子邮件。
| 设置 | 建议的值 | 说明 |
|---|---|---|
| 收件人 | 键入电子邮件地址 | 接收通知的电子邮件地址。 |
| 主题 | 检测到消极的推文情感 | 电子邮件通知的主题行。 |
| 正文 | 推文文本、位置 | 单击“推文文本”和“位置”参数。 |
- 单击“ 保存”。
完成工作流后,可以启用逻辑应用并查看函数的工作状态。
测试工作流
-
在逻辑应用设计器中,单击“运行”启动应用。
-
在左列中,单击“概述”查看逻辑应用的状态。
逻辑应用执行状态
-
(可选)单击某个运行查看执行详细信息。
-
转到函数,查看日志,并验证是否已收到并处理情绪值。
查看函数日志
-
检测到潜在的消极情感时,将收到一封电子邮件。 如果未收到电子邮件,可以更改函数代码,以便每次都返回 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 逻辑应用。
历史资料。此文对应 2022-08-12 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者(原始作者元数据 craigshoemaker)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体、发布器占位标签和导航标记。
