你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
适用于：Azure 逻辑应用（消耗）
注释
此功能处于预览状态，可能会产生费用，并受 Azure 预览版Microsoft补充使用条款的约束。
如果 Azure AI Foundry 中有一个 AI 应用，需要自动执行多步骤过程或与各种服务、系统、应用和数据源集成，则可以在代理中添加作，以在 Azure 逻辑应用中运行自动化工作流。
在 Azure AI Foundry 中，代理使用操作和 AI 模型以自主或交互方式完成任务。 例如，代理人使用动作来回答问题、获取信息，并通过 AI 模型来执行其他作业。
在 Azure 逻辑应用中，逻辑应用工作流可自动执行流程，并且可以在其他生态系统中集成 Azure、Microsoft和服务、系统、应用和数据源，通常无需任何额外的代码。 工作流使用来自库的预生成触发器和操作，其中包含 1,400 多个连接器，以及运行时本机操作或“内置”操作。
下图显示了 Azure AI Foundry 中代理的作如何与 Azure 逻辑应用中的逻辑应用工作流相关：
本指南介绍了如何将一个动作添加到 Azure AI Foundry 中的代理，使该代理创建在多租户 Azure Logic Apps 中运行的 Consumption 逻辑应用工作流。 向导将引导你逐步完成使用预定义的逻辑应用工作流来设置此操作。 完成添加作后，可以使用 Azure 逻辑应用中的图形设计器，根据方案的需求扩展此工作流。
有关详细信息，请参阅以下文档：
先决条件
一个 Azure 帐户和订阅。 如果没有 Azure 订阅，请注册一个免费 Azure 帐户。
使用默认中心创建的 Azure AI Foundry 项目。
此项目组织工作并在生成 AI 应用时保存状态。 中心托管项目并提供团队协作环境。
若要使用中心创建项目，根据最低权限原则需要以下角色之一才能获得 Microsoft Entra 基于角色的访问控制 (RBAC)：
参与者 （最低权限）
所有者
如果你有任何其他角色，则需要为你创建中心。 有关详细信息，请参阅以下文档：
为项目部署的 Azure OpenAI 服务模型。
如果没有已部署的模型，请参阅 “部署模型”。
-
此要求包括在 Azure OpenAI 服务中部署模型，以便代理在工作流运行时使用。
是否可以创建并使用自己的工作流作为动作？
是的，若要通过 Azure AI Foundry 门户中的作库提供自己的逻辑应用工作流，工作流需要满足以下要求：
包含工作流的逻辑应用资源使用 消耗 托管选项。
逻辑应用资源使用与 Azure AI Foundry 相同的 Azure 订阅。
触发器包括一个说明，可在工作流设计器中的触发器信息窗格中提供说明。
工作流以 响应 作结束。
AI 应用拥有几乎无休止的功能，用于运行与 Azure、Microsoft 及其他服务或产品交互的工作流，还有助于管理、组织、转换和处理数据的操作。 如果没有现成的连接器来支持您想进行的操作，您也可以创建自己的连接器。
有关详细信息，请参阅以下文档：
- 快速入门：使用 Azure 门户创建示例消耗逻辑应用工作流
- 什么是 Azure 逻辑应用中的连接器
- 在全局多租户 Azure 中运行的托管连接器
- Azure 逻辑应用的托管连接器参考
- 使用 Azure 逻辑应用运行时运行的内置操作
- Azure 逻辑应用中的自定义连接器
限制和已知问题
此版本具有以下限制或已知问题：
| 限度 | DESCRIPTION |
|---|---|
| 逻辑应用工作流支持 | 目前，代理操作仅支持多租户 Azure 逻辑应用中的消耗型逻辑应用工作流。 消耗逻辑应用资源只能有一个工作流。 有关详细信息，请参阅 部署的托管选项。 代理操作目前不支持在单租户 Azure 逻辑应用、应用服务环境或混合部署中的标准逻辑应用工作流。 标准逻辑应用可以有多个工作流。 有关详细信息，请参阅 部署的托管选项。 |
向代理添加一项操作
按照以下步骤为你的代理设置一个操作，以创建和运行逻辑应用工作流。
登录到 Azure AI Foundry 门户并打开项目。
在项目概述中，在门户导航菜单上的 “生成和自定义”下，选择 “代理”。 在 “代理 ”页上的 “我的代理”下，选择代理。
在代理列表旁边的 “设置 ”部分中，向下滚动到 “作 ”部分，然后选择“ 添加”。
在 “添加操作” 窗口中，选择 “Azure 逻辑应用”。
在选择操作下，选择一个具有以下标签之一的预定义操作：
操作标签 DESCRIPTION Microsoft 作者 此操作使用 Microsoft 编写的模板来创建该操作的工作流。 工作流 此操作使用您 Azure 订阅中符合条件的逻辑应用工作流作为模板来创建该操作的工作流。
注意：如果选择此选项，请跳到名为 确认操作详情 的部分。 如果工作流未按预期显示在动作库中，请检查要求。以下示例使用由 Microsoft 创作的名为 获取今天的天气预报 的操作，通过 MSN 天气进行：
在 “添加逻辑应用”操作 窗口中，在 输入一些基本信息栏中，提供以下信息：
参数 必选 价值 DESCRIPTION 您的操作名称 是的 <action-name 操作的友好名称，是以任务为重点，谓词开头的简洁的名称。 此名称还用于 Azure 逻辑应用中的逻辑应用资源和工作流。
注意：
-作名称只能使用字母、数字和以下特殊字符：-、（、、、_或'。
- 不能使用空格或其他特殊字符。
- 消耗型逻辑应用资源与工作流结合，并具有 1:1 关系，因此它们使用相同的名称。 相比之下，标准逻辑应用资源可以有多个使用不同名称的工作流。
此示例使用 Get-weather-forecast-today。您的操作描述 是的 < action-description> 明确描述行动目的的说明。
此示例使用 此作创建可调用的消耗逻辑应用工作流，该工作流可获取当前天气预报并在全局多租户 Azure 逻辑应用中运行。订阅 是的 <Azure 订阅> 要使用的 Azure 订阅大概与项目和模型相同。 资源组 是的 <Azure 资源组> 要使用的 Azure 资源组。 位置 是的 < Azure-region> 托管逻辑应用资源和工作流的 Azure 区域。 以下屏幕截图显示了示例操作 Get-weather-forecast-today 的详细信息：
完成后，选择“下一步”。
创建和验证连接
按照以下步骤创建作需要的任何连接，并验证对相关服务、系统、应用或数据源的访问权限。 基础模板指定要用于此作的连接器和逻辑应用工作流。
在 “添加逻辑应用作 ”窗口中的 “身份验证”下，查看创建和进行身份验证所需的任何连接。
在 “连接 ”列中，为相关服务或数据源选择 “连接 ”。
以下屏幕截图显示了为 MSN 天气服务创建和进行身份验证的示例连接：
某些连接需要更多详细信息，因此请按照提示提供请求的信息。
对于每个必需的连接，请重复这些步骤。
完成后，选择“下一步”。
确认操作详细信息
查看并检查所有的操作信息是否正确。 如果选择了由 Microsoft 创建的操作，请阅读并同意确认声明。
在 “添加逻辑应用操作” 窗口中的 “资源”下，检查所有提供的操作信息。
对于所选的微软创作的操作，请完成以下步骤：
通过选择“下一步”，查看确认并了解离开“资源”页后发生的以下事件：
无法返回到前面的步骤。
该操作将创建消耗逻辑应用资源。
连接到 Azure 逻辑应用会在您的 Azure 帐户中产生费用。
有关消耗逻辑应用工作流计费模型的详细信息，请参阅以下文档：
若要同意，请选择确认框，例如：
准备就绪后，选择“下一步”
操作创建完成
在最后一步中，请查看门户生成的关于代理使用的工具的信息，以便执行操作，并验证对任何相关的 Azure、Microsoft 和非 Microsoft 服务或资源的访问权限。
在“添加逻辑应用”操作窗口中的“架构”页上，查看以下信息，并确保提供有关调用该工具的情况的说明：
参数 DESCRIPTION 工具名称 代理使用的工具用于运行操作并访问 Azure、Microsoft、外部服务、数据源或专用 AI 模型，其名称是可编辑的，以便代理可以获取数据、执行任务以及与其他平台进行交互。
注意：
-作名称只能使用字母、数字和下划线 （_） 字符。
- 不能使用空格或其他特殊字符。身份验证连接 代理用于访问 Azure、Microsoft 和外部资源的连接的只读名称，无需每次都请求凭据。 有关详细信息，请参阅 Azure AI Foundry 门户中的连接。 介绍如何调用该工具 指定代理何种情况调用该工具的说明。 架构 JavaScript 对象表示法（JSON）格式的逻辑应用工作流的架构。 
准备就绪后，选择“创建”。
门户将您返回到所选代理的代理页面。 在“设置”部分中，“操作”部分现在显示运行操作的工具的名称，并显示工具名称旁边的 Azure 逻辑应用的图标，例如：
测试代理的操作
若要使用 代理操控台尝试代理的新操作，请执行以下步骤：
在“代理”页上的“设置”部分顶部，选择“在操场中试用”。
在“代理”操场页上，在用户查询聊天框中询问有关天气的问题，例如：
伦敦的天气是什么？ 以项目符号列表格式显示结果。
代理返回类似于以下示例的响应：
查看基础逻辑应用和工作流
作运行后，可以在 Azure 门户中查看基础逻辑应用资源和工作流。 可以查看工作流的运行历史记录，该历史记录可用于调试或排查工作流可能遇到的问题。
登录到 Azure 门户。 在门户标题栏的搜索框中，输入你所创建的操作名称。
在结果列表中，在 “资源”下，选择逻辑应用资源。
若要查看工作流的运行历史记录、输入、输出和其他信息，请在“ 开发工具”下的“逻辑应用”菜单上选择“ 运行历史记录”。
在 “运行历史记录 ”列表中，选择最新的工作流运行，例如：
监视视图打开并显示工作流中每个操作的状态后，选择一个操作以打开信息窗格并查看该操作的输入和输出。
此示例选择名为“获取今天的预测”的动作，例如：
有关工作流运行历史记录的详细信息，请参阅 查看工作流状态和运行历史记录。
在设计器中打开工作流
按照以下步骤查看工作流定义和作，或通过打开工作流设计器来编辑工作流。
在逻辑应用菜单上的 “开发工具”下，选择设计器。
工作流将在设计器中打开。 现在可以查看工作流的操作，这些操作包括触发器和动作，例如：
若要查看操作的参数和设置，请在设计器中选择该操作，例如：
若要扩展工作流的行为，可以按照 构建具有触发器或动作的工作流中的步骤添加更多动作。
要使此工作流或任何其他工作流显示在作库中，并在代理中作为作运行，工作流必须始终满足以下要求：
包含工作流的逻辑应用资源必须使用消耗托管选项。
逻辑应用资源必须使用与 Azure AI Foundry 一起使用的同一 Azure 订阅。
触发器需要说明，可以在设计器中的触发器信息窗格中找到该说明。
工作流必须结束于响应动作。
谨慎
虽然可以添加操作或更改工作流，但不要编辑原始触发器和操作，以避免破坏工作流、代理和操作之间的关系。 其参数设置为协同工作，因此更改这些操作可能造成在代理中中断操作的风险。 相反，请考虑创建一个自定义版本或其他流程，并将其作为一个操作添加到代理中。
例如，触发器使用以下参数，这是调用触发器所必需的：
参数 DESCRIPTION 名称 此名称是触发器的 HTTPS URL 的一部分。 外部调用方（如其他服务）向此 URL 发送 HTTPS 请求，这会触发触发器并启动工作流。 触发器始终是工作流中的第一步，并指定运行触发器需满足的条件。 HTTPS URL 首次保存工作流时，将生成此 URL，并用于调用触发器为工作流创建的终结点。 方法 此设置指定触发器是接受所有还是仅接受特定的 HTTPS 方法。 请求正文 JSON 架构 如果要验证触发器希望在从外部调用方发送的 HTTPS 请求中接收的输入，此架构指定用于验证该输入的 JSON 架构。 若要保存所做的任何更改，请在设计器工具栏上选择“ 保存”。
在设计器中测试工作流
如果更改了天气工作流或测试其他工作流，请执行以下步骤：
在设计器工具栏上，选择“运行>使用有效负载运行”。
打开“运行有效负载”窗格后，在“正文”字段中提供预期的 JSON 格式触发器输入，例如：
{ "location": { "type": "London", "description": "Location for the weather" } }准备就绪后，选择“ 运行”。
在“ 输出 ”选项卡上， “响应正文 ”包含工作流的结果和响应。
如果工作流运行生成错误或需要故障排除，请打开工作流的运行历史记录，以便可以使用 “查看基础逻辑应用和工作流”中的相关步骤检查每个作的输入和输出。
计费和定价
消耗逻辑应用工作流基于“即用即付”计费模型产生费用。 有关此模型的详细信息，请参阅以下资源：
对于 Azure AI Foundry，请参阅以下资源：
清理资源
如果不需要为本指南创建的资源，请删除资源，以免继续收费。 可以按照以下步骤删除包含这些资源的资源组，也可以单独删除每个资源。
在 Azure AI Foundry 门户中，若要从代理中删除作，请在作名称旁边选择省略号（...）按钮，然后选择“ 删除”。
在 Azure 门户 标题栏搜索框中，输入 资源组，然后选择 资源组。
查找包含已部署中心资源的资源组。
在“概述”页面的工具栏上，选择“删除资源组”。
出现确认窗格时，输入资源组名称，然后选择“删除”。