在设计器中编辑和管理你的工作流程

注释

本文的功能由 GitHub Copilot 框架驱动,该工具使用 Copilot 积分进行基于使用量的计费。 在GitHub Copilot harness驱动的代理计费概览中,了解更多关于Copilot积分的信息。

基于使用量的计费适用于使用、构建、测试和评估代理。 这些操作可能会消耗Copilot积分。

工作流程在重新设计的 Copilot Studio 中创建和编辑。 设计器提供了一个画布,你可以在这里构建或编辑自动化,添加和移除操作,检查错误,并发布工作流程,而无需离开设计器。

在设计器中显示工作流程

要在设计器中显示工作流程,打开 Copilot Studio,选择工作流程,再选择工作流程,然后选择构建标签。

Copilot Studio 设计器的屏幕截图,显示了一个具有触发器和多个操作的已发布工作流。

改变工作流程的显示方式

根据你工作流程的大小和复杂度,你可能需要调整显示方式,以便操作。 画布左下角的工具栏控制视图。

 Copilot Studio 设计器中视图选项工具栏的截图,标注从 1 到 6。

图例:

  1. 放大:增加画布上工作流的大小。
  2. 缩小视图:减小画布上工作流的大小。
  3. 拟合视图:调整视图大小以适应画布上的整个工作流。
  4. 整理:重新组织工作流和分支,以实现更清晰的端到端视图。
  5. 垂直布局:切换到工作流的垂直布局视图。

添加和删除操作

  1. 在要添加操作的卡片上,选择 “添加步骤”。 此时会打开 “添加 ”窗格。

  2. 添加选项下,开始输入你希望工作流程执行的动作或你想添加的连接器,然后从列表中选择它。 根据您的选择,您可能需要提供其他信息来完成操作。

如果确定某个动作不需要,请选择该动作右上角的 “删除 ”图标。

检查工作流程参数

若要查看工作流中的触发器或操作的参数,请选择其卡片。 配置面板在右侧打开。 若要输入参数的值,请在下拉列表中选择一个选项或输入表达式以动态设置该值。

检查是否有错误

工作流操作中的错误以红色表示。 要查看某个操作中的错误详情,请选择该错误。 要列出整个工作流程中的所有错误,请打开 健康中心 横幅。 要查看单个错误的详细信息,请选择错误。

Important

如果工作流包含错误,你就无法发布。 你必须纠正 所有 错误,才能发布。

发布工作流

如果工作流没有错误,可以发布它。 在画布顶部的菜单中,选择 发布

测试工作流

测试运行让你在不离开设计师的情况下验证一个步骤或整个工作流程,使用真实上游数据、自己模拟的数值或之前运行的输出。

有两种方法可以运行测试:

要验证的内容 如何测试 在何处找到它
单个操作或 AI 步骤的单独执行 测试此节点 节点侧面板中的“测试”选项卡
完整的工作流程,端到端 运行流测试 顶部命令栏中的“播放”按钮

这两个界面具有相同的理念:提供输入(真实或模拟),运行,然后检查输出。

在工作流中测试单个节点

打开工作流中的任何操作或节点,然后选择“播放”或“测试”按钮。 有三个部分:

  1. 运行/重置测试:按需运行步骤,或清除当前输入和输出。

    节点测试面板的屏幕截图,其中显示了“输入”、“配置”和“输出”部分,其中突出显示了“测试”按钮。

  2. 上一次运行的加载值:该工作流程最近运行的下拉菜单。 选择一个会把上游步骤的输出拉取,然后输入到下面的输入字段中。

  3. 输入:每个上游步骤输出节点引用的一个可编辑字段。 每行右侧的徽章显示字段的预期类型(字符串、电子邮件、日期时间、数字等)。

  4. 输出:最近一次测试的实时结果,按节点类型格式化。

模拟输入

默认情况下,输入字段为空。 您可以:

  • 直接在字段中键入任何值。 该字段接受右侧徽章中显示的类型。
  • 如果步骤不依赖于该字段,请将字段留空。

节点测试面板的屏幕截图,其中显示了右侧具有类型徽章的空白输入字段。

Tip

“测试”选项卡自动列出此节点的表达式引用的上游步骤输出。 如果将新令牌添加到节点,则下次打开“测试”时,将显示相应的字段。

从上一次运行加载值

上一个运行下拉列表中的“加载值”的屏幕截图,其中显示了过去运行的日期、时间和状态标签。

如果你的工作流程之前运行过,你可以重放真实数据,而不是直接输入:

  1. 上一个运行下拉列表中的“加载值 ”中,选择一个运行。

  2. 设计器提取该运行的步骤输出,并通过您的节点的输入模式投影这些输出。 匹配值将写入输入字段。

  3. 如果想要调整场景,请之后编辑任何字段。

下拉菜单显示最新的 10 次任何状态的运行。 如果一次运行没有包含某个上游步骤的输出,因为该步骤被跳过或路径未被使用,那么只有可用字段会被填满。 其余的保持原样。

如果之前没有运行过,则 不会显示任何可用的之前运行 ,下拉菜单也会被隐藏。

运行测试

选择 “运行测试”。 按钮在呼叫处于运行状态时显示忙碌状态;“输出”部分显示一个微调器,然后显示结果或错误。

  • 重置测试 会清除输入和最后一个输出。
  • 测试针对连接器的 API 隔离运行节点。 测试不会触发后续流程。

测试整个工作流程

在顶部命令栏中,选择播放按钮(测试)。 测试你的工作流程可以端到端地对比实时运行时。

在运行开始之前,设计器:

  1. 如果你有未保存的更改,或者第一次使用,它会保存并发布工作流程。
  2. 首次运行时安装新连接。
  3. 触发启动运行。 路径取决于触发器类型。
触发器类型 选择“测试”时会发生什么情况
手动/HTTP 请求 会打开一个对话框让你输入触发输入,然后工作流程会立即运行。
重复/滑动窗口/轮询 要么排程开始,第一次运行自动启动,要么如果已经安装,工作流程运行一次。
连接器事件(例如,电子邮件到达时) 工作流程被发布并等待。 你可以看到 《等待触发......》。在源系统中执行任务。
HTTP Webhook 工作流程会被发布;像平常一样从外部系统触发它。

模拟输入(手动触发)

对于手动触发器, 输入手动触发器输入 对话框会显示你在触发器上定义的每个输入一个字段:

  • 文本/数字/电子邮件/日期:适当的输入控件。
  • 布尔值(Boolean):切换按钮。
  • 单选(枚举):下拉列表。
  • 多选:多选下拉列表。
  • 文件:文件选择器。 这些内容会作为跑步的一部分上传。
  • 对象/数组:可在其中粘贴 JSON 的多行文本区域。

选择 “运行 ”以启动这些输入的工作流程 ,或者取消 以关闭而不运行。 必填字段用星号标记。 如果值缺失或无效,则会显示内联验证消息,并阻止运行,直到修复这些消息。

每次选择 测试时,这个对话框都会出现。 值不会在运行之间保存,因此可以快速尝试不同的方案。

查看操作运行

运行完成后:

  • 在运行时,命令栏会显示“取消”按钮。
  • 右侧的活动面板顶部列出当前运行,并带有状态标签: 运行中、 等待中、 成功失败取消。 选择任意运行以在画布上打开它,并检查每个步骤的输入和输出。

选择过去的运行

活动面板同时显示你的工作流程运行历史:

  • 用顶部的下拉菜单筛选“ 全部/成功/失败/运行 中”。
  • 选择 刷新以重新获取列表。
  • 请在底部选择 “加载更多” 以进一步翻页。
  • 选择运行会将它加载到画布上,其中每个节点显示收到的输入,以及它为该运行生成的输出。 在节点级测试选项卡的下拉菜单中选择运行时,所用的数据与该选项卡使用的数据相同。

何时使用每种类型的测试

  • 是单步AI步骤或连接器动作的迭代吗? 使用 测试这个节点。 它更快,不发布,而且只模拟重要的上游值。
  • 验证端到端的行为或触发逻辑? 使用 运行流量测试。 它会对整个图进行实际运行时间的计算。
  • 复制生产问题? 从活动面板打开失败的运行,然后打开失败节点,在其测试标签页中使用 上一次运行的加载值 ,将准确的上游数据重放到动作中。