---
title: 机器人阶段
slug: neurons/help/zh_cn/Ai-MQmzJ-S-g2XEMPxjxP
createdAt: 2026-09-07T07:01:34.527Z
---

阶段用于构建机器人。 在[机器人编辑器](https://docs.ivanti.com/neurons/help/zh_cn/DGK8PFFeI6F1yhty2vPmE)页面上，将阶段拖到工作区。 阶段设置面板显示，供您定义操作或查询的设置。 阶段必须连接 :inlineImage[]{src="https://api.archbee.com/api/optimize/9rfvxhrv8FA-8bxcK2IRv/pv_NnT8Oq4CPZyXAvCz6R_bots-stageconnect.png" alt="阶段连接器图标" caption size="10" width="27" height="25"} 才能在机器人中创建工作流程，请参阅[连接设置](https://docs.ivanti.com/neurons/help/zh_cn/DGK8PFFeI6F1yhty2vPmE#Connecti)。 您可以从阶段类别选择一个阶段。 您还可以创建[自定义阶段](https://docs.ivanti.com/neurons/help/zh_cn/GBxujJGStCotjeZeWxPsz)和[用户阶段](https://docs.ivanti.com/neurons/help/zh_cn/yhd0EqErVHijNXNMq1oa-)以与机器人一起使用。

## 阶段类别

:::hint{type="success"}
下方的概述并不会列出每一个阶段。 列出的阶段不一定在每个配置路径中都可用。
:::

::::ExpandableHeading
## 查询

用于显示和筛选满足指定条件的设备信息。 此查询阶段的输出和上下文可传递到机器人中的后续阶段。
例如，显示可用磁盘空间小于 10％ 的设备。

- **Teams 通话质量阶段**：Teams 通话质量阶段获取目标设备或用户的通话记录和质量信息。 它会在现场会议之前或期间评估网络性能、设备兼容性和整体通话体验，有助于识别潜在问题。
  配置 Teams 通话质量阶段：
  1. 选择 **Teams 通话质量**阶段并转到**阶段设置**。
  2. 在 **选择凭据的连接器**字段中，使用下拉菜单选择要连接到 Microsoft Entra ID 的连接器。
  3. **开始日期**和**结束日期**是可选字段；您可以选择自定义值或现在的日期选项。 如果选择自定义值选项，请输入该值，如果选择现在的日期，请打开**添加迄今为止的时间**以输入**时间单位**和**持续时间**。

     :::hint{type="info"}
     这将检索过去 30 天的数据，每个用户最多 60 次通话。
     :::
- **清单查询**：此阶段根据用户选择的筛选器和列从清单中检索值，然后可以在机器人工作流程中稍后使用。 可检索属性仅限于具有单个值（1:1 关系）的属性；不支持基于数组的属性。
  此阶段存在于所有机器人上下文中， **通用**上下文中也提供设备和人员清单的专用阶段。

:::hint{type="info"}
使用“到人员上下文”或“到设备上下文”阶段时，如果未在阶段中放置正确的库存查询，将导致“无效上下文”错误。
:::

- **Inventory 查询（高级）**： 此阶段的工作方式与 Inventory 查询阶段相同，但也允许检索基于数组的清单属性（1：许多关系）。 它存在于所有机器人上下文中， **通用**上下文中也提供设备和人员清单的专用阶段。

:::hint{type="info"}
使用“到人员上下文”或“到设备上下文”阶段时，如果未在阶段中放置正确的库存查询，将导致“无效上下文”错误。
:::
::::

:::ExpandableHeading
## 操作

操作阶段利用自动化结构来执行操作。 有些操作可使用变量。 深入了解[阶段变量](https://docs.ivanti.com/neurons/help/zh_cn/Ai-MQmzJ-S-g2XEMPxjxP#variables)。
:::

::::ExpandableHeading
## 通用

- **筛选结果**：您可以根据可自定义的属性筛选查询结果。 一旦将内置的查询阶段连接到筛选器，**属性**下拉列表将列出可选择的所有可用属性。 要查看属性的详细信息，请转至查询**阶段设置**面板并选择**阶段信息**。
  - 您还可以使用**预览查询**功能来评估所有目标设备，并使用结果表格来查看可以筛选的值的格式和范围。
  - 您可以将多个查询按顺序连接在一起。 如果执行此操作，那么所有结果将组合起来并可进行筛选，或者在“操作阶段”中使用。 您可以更改已连接的筛选器的比较行为，以便其应用 AND 或 OR 逻辑来确定结果。

**联接**：使用此阶段重新合并已拆分为独立分支的机器人。 在阶段设置中，选择联接行为；任何状态、全部成功、至少有一个成功。

- **设置变量**：使用此阶段提供一致的参考点，可以使用默认值配置并根据结果按阶段更新。 当您想要使用单个变量来引用可能从跨不同分支的查询更新的字段时，这很有用。 您可以设置的变量在[定义变量](https://docs.ivanti.com/neurons/help/zh_cn/DGK8PFFeI6F1yhty2vPmE#Definevariable)中定义。
- **延迟**：使用此阶段可让工作流程保持预定义的时间。 此功能可根据延迟阶段中配置的时间延迟执行后续的阶段。 在阶段设置中，以分钟、小时和天为单位选择延迟持续时间。 用户可以设置的最长延迟时间为七天，最短为一分钟。 如需等待用户回复消息或等待进程完成，此阶段非常实用。
- **设备上下文阶段**：当您选择“通用”作为机器人目标类型时，此阶段可用。 使用此阶段从人员上下文或通用上下文切换到设备上下文。 在阶段设置中，您可以创建一个输入，然后将其绑定到**设备名称**，或者您可以将其切换到**列表输入模式**。 当您点击设备上下文可调整大小阶段时，阶段库将动态地更改为设备上下文库。 您可以从设备上下文阶段中的阶段库中拖放所需的阶段，以收集可在此设备上下文之外进一步使用的数据。 当您想要将不同设备上的不同操作作为同一工作流的一部分进行排序时，此格式对于编排工作流程很有用。
- **投射到类型**阶段：**投射到类型**阶段允许您将输入值转换为特定数据。 当下游阶段或筛选器需要特定类型的值时，此阶段非常有用，例如字符串、数字、布尔值或日期。
  例如，从日志消息字符串中提取数字后，您可以将输出投射到整数并在下游阶段执行数学运算。

:::hint{type="info"}
如果需要将对象转换为字符串，请使用 **To JSON** 阶段。
:::

关键功能包括：

:::Paragraph{listStyleType="disc" indent="2"}
**布尔会话**
:::

:::Paragraph{listStyleType="disc" indent="3"}
将 'true'、'TRUE' 或 '1' 等值转换为布尔值 true。
:::

:::Paragraph{listStyleType="disc" indent="3"}
仅精确值 1 视为真；1.5 等十进制值不视为真。
:::

:::Paragraph{listStyleType="disc" indent="2"}
**日期对话**
:::

:::Paragraph{listStyleType="disc" indent="3"}
使用 [JavaScript 日期构造函数](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/Date)将支持的字符串值转换为日期对象。
:::

:::Paragraph{listStyleType="disc" listStart="2" indent="2"}
**数字对话**
:::

:::Paragraph{listStyleType="disc" indent="3"}
执行直接数字转换。
示例：
:::

:::Paragraph{listStyleType="disc" indent="4"}
输入：“23”
:::

:::Paragraph{listStyleType="disc" indent="4"}
输出：23
:::

:::Paragraph{listStyleType="disc" listStart="3" indent="2"}
**字符串对话**
:::

:::Paragraph{listStyleType="disc" indent="3"}
将值转换为字符串表示，因为输入支持令牌。 多个值可以合并为单个字符串。
:::

- **JavaScript AI 阶段**：**JavaScript AI** 阶段将 JavaScript 阶段的灵活性与 AI 辅助代码生成相结合，使用户能够通过提示而不是手动编写代码来创建数据转换和业务逻辑。 生成的代码可以在工作流程中查看、编辑、测试和重复使用。
  **阶段设置&#x20;**&#x5305;括用于生成 JavaScript 代码的提示字段。 它支持用户定义的输入，可直接在提示中引用。 您可以使用**打开阶段编辑器**选项修改提示。 在**测试并获得输出**中进行测试之前，必须应用并保存更改。
  首次保存机器人时，必须接受位于**阶段设置**面板底部的 JavaScript AI 阶段的条款和条件。
  与所有 AI 相关阶段一样，在**管理员** > **设置**中启用 **AI 支持阶段**选项， 并且已为用户分配包含**人工智能** > **机器人生成式 AI 阶段**权限的 RBAC 角色之前，此阶段仍然不可用。
- **JavaScript 阶段**：**JavaScript** 阶段允许您执行 JavaScript 代码作为工作流程的一部分，并且不会在端点设备运行。 它可用于操作数据、执行计算、格式化值和生成结构化输出。 这使工作流程即使在目标设备离线时也能执行处理。
  在**阶段设置**中，您可以为阶段定义一个或多个输入。 输入值在 JavaScript 代码中自动可用，不需要显式变量声明。
  在 **JavaScript 编辑器**字段中输入代码后，单击**测试和获取输出**以执行代码并查看输出。 输出由返回的 JSON 生成，并可用作工作流程下游阶段的结构化输出。 生成的 JavaScript 可以使用 **Open stage 编辑器**选项进行修改。 在测试之前，必须应用并保存更改。

:::hint{type="info"}
此阶段是孤立运行的；因此，其功能受到限制。 例如，使用 JavaScript 调用网络服务的能力会导致连接失败。
:::
::::

:::ExpandableHeading
## Beta

此处提供用于早期访问的阶段。 提供 Beta 阶段，使 Ivanti 可以收集有关未来功能的反馈和数据。
:::

::::ExpandableHeading
## 自定义

自定义阶段允许您执行自定义脚本。 可从下列脚本模板进行选择：

- **osquery**：一种开源 SQL 语言，可用于从设备查询和检索信息，支持 Windows 和 macOS 设备。
- **PowerShell 查询**：可用于查询 Windows 和 macOS 设备。 它可以作为系统或登录用户运行，或使用指定的凭据。
- **PowerShell AI**：可用于在机器人工作流程中生成和执行 PowerShell 脚本。 它可以作为系统或登录用户运行，或使用指定的凭据。
- **Bash 操作**：可用于在 macOS 设备上执行操作。
- **Bash 操作 AI**：可用于在机器人工作流程中生成和执行自定义 Bash 脚本。 它可以作为系统或登录用户运行。
- **命令操作**：在目标端点上执行 Windows 命令提示符命令。 其能够以系统或登录的用户身份运行。
- **命令操作 AI**：可用于在机器人工作流程中生成和执行自定义命令脚本。 它可以作为系统或登录用户运行。
- **Powershell 操作**：可用于在 Windows 设备上执行操作。

:::hint{type="info"}
在 FRU 环境中，AI 功能不可用。
:::

深入了解[自定义阶段](https://docs.ivanti.com/neurons/help/zh_cn/GBxujJGStCotjeZeWxPsz)。
::::

:::ExpandableHeading{customAnchorSlug="list"}
## 列表函数

列表函数阶段允许您对列表形式的阶段结果执行操作。 例如，您可以对列表进行筛选、排序、计数或求和。
如果列表函数阶段的结果仍是列表，则可以再添加一个列表函数来进一步优化结果。

在工作区中，您可以通过**列表**标签识别（预期）会返回列表结果的阶段。

**在工作流程中应用列表函数阶段：**

1. 添加具有列表结果的阶段。
2. 添加所需的列表函数。
3. 使用 :inlineImage[]{src="https://api.archbee.com/api/optimize/9rfvxhrv8FA-8bxcK2IRv/pv_NnT8Oq4CPZyXAvCz6R_bots-stageconnect.png" alt caption size="10" width="27" height="25"} 连接步骤 2 和 3 中的阶段。
   此操作将填充列表函数阶段中**选择列表**的值。
4. **选择列表**以在其上执行列表函数。
5. 根据所需的列表函数，完成阶段余下的配置。
6. 完成机器人工作流程的其余部分并保存更改。
:::

:::ExpandableHeading
## 字符串函数

字符串操作阶段允许您在自动化工作流程中转换、清理、验证和提取字符串数据中的信息。 它们旨在用于工作流程需要处理数据的任何位置，例如检查字符串格式、从日志消息中提取数据或动态构建字符串。 部分阶段包括：

- **提取字符串**：使用正则表达式匹配文本块中的字符串并从文本块中提取字符串，返回匹配的字符串以供稍后在工作流程中使用。
- **替换字符串**：允许在字符串中将一个值替换为另一个值。 匹配可以通过显式值或正则表达式来完成。
- **字符串匹配**：使用正则表达式在字符串中匹配，返回 true 或 false 条件。
:::

:::ExpandableHeading{customAnchorSlug="Interaction"}
## 交互

交互阶段允许机器人使用 Microsoft Teams 与最终用户交互并收集输入。 可从下列交互阶段进行选择：

- **MS Teams 交互**：允许机器人通过 Microsoft Teams 与最终用户交互并收集输入。 此消息包括标题、消息正文和交互选择：按钮或自由文本输入。
- **MS Teams 消息**：允许机器人使用 Microsoft Teams 向最终用户发送单向消息。 此消息由标题和消息正文组成。
- **MS Teams 评分**：允许机器人通过 Microsoft Teams 与最终用户交互并收集评分。 此消息由标题、问题和评分组成。
- **MS Teams 观点反馈**：允许机器人通过 Microsoft Teams 与最终用户交互并收集输入。 此消息包括标题、消息正文和交互选择：按钮或自由文本输入。

如需了解更多信息，请参阅 [MS Teams 阶段](https://docs.ivanti.com/neurons/help/zh_cn/ms-teams)。
:::

:::ExpandableHeading
## 用户

用户阶段是自定义脚本阶段。 它们被保存并在此用户部分中可用，以便在机器人创建中多次重复使用。

了解有关[ 用户阶段](https://docs.ivanti.com/neurons/help/zh_cn/yhd0EqErVHijNXNMq1oa-)的更多信息。
:::

## 阶段变量

阶段设置中的变量可用于在阶段间传递信息，并将某个操作的输出传递给其他操作。

### 插入变量

要插入变量，请打开**阶段设置**。 任何支持变量的字段将显示文本 Ctrl + Space。 选择 **Ctrl + 空格**从列表中选择并插入一个变量。

:::hint{type="info"}
在 PowerShell 中将变量定义为脚本输入时，请使用 $myvar 语法在脚本中引用这些变量。
:::

:::ExpandableHeading
## 标准变量

**机器人名称**：当前机器人的名称。

**启动用户**：启动机器人的用户的名称。 这可能是一个用户，也可能是一项 Neurons 服务。

**启动用户 ID**：启动用户的用户 ID。 这可能是用户 ID，也可能是一项 Neurons 服务。

**时间戳 (ISO)**：ISO 格式的当前时间戳。

**设备名称**：获取当前阶段中的当前设备的设备名称。 返回的设备名称以逗号分隔。

**所有设备数据**：获取当前阶段中的当前设备的所有数据。 这将是一个 JSON 对象。

**指定名称**：登录的最终用户的名称。

**显示名称**：最终用户的全名。

**电子邮件**：最终用户的电子邮件。
:::

提供开箱即用的模板，可与变量结合使用。 如有更复杂的需求，可通过 handlebarsjs 使用 javascript。

## 阶段设置

将阶段拖放到工作区并突出显示后，将显示**阶段设置**面板。 使用设置来配置和自定义每个阶段。

:::hint{type="info"}
您可以使用用户阶段脚本功能自定义设置。 了解有关[ 用户阶段](https://docs.ivanti.com/neurons/help/zh_cn/yhd0EqErVHijNXNMq1oa-)的更多信息。
:::

每个阶段都有一个唯一数字 ID。 如果机器人多次使用同一阶段，该 ID 可用于单独标识各个阶段。

点击**查看阶段信息**以显示**阶段信息**面板，其中将显示阶段的描述和所有相关属性。 可将这些内容用作筛选查询结果的标准。

将**结果影响 DEX 分数**切换为启用，以在“设备”页面显示**调查**部分。

:::hint{type="info"}
如果阶段的设置没有正确设置，或者缺少某些信息，阶段将有一个红色边框，需要注意的设置也是如此。 正确完成设置后，红色边框将被移除。
:::

## 弃用的阶段

如果机器人中有更新版本的阶段可用，会有一个黄色横幅显示需要操作：此机器人包含已弃用的 x 阶段。 已弃用阶段的边框将为黄色。

选择**更新**将阶段升级到较新的版本。 完成后，横幅将消失，阶段边框将不再是黄色。

## 已禁用阶段

如果机器人中的某个阶段已被删除且不再可用，则会显示红色横幅需要采取措施：此机器人包含已禁用的 x 阶段。 禁用阶段的边框将为红色。

您必须从机器人删除阶段。 一旦完成，横幅就会消失。

## 固定阶段

使用固定类别对您最常用的阶段进行分组。

要固定阶段，将鼠标悬停在阶段上，选择“固定”图标 :inlineImage[]{src="https://api.archbee.com/api/optimize/9rfvxhrv8FA-8bxcK2IRv/r8rKDSIJOhx7yS3UeK_oX_bots-pin.png" alt="“固定”图标" caption size="10" width="19" height="24"}。

要取消固定阶段，请点击“固定”图标 :inlineImage[]{src="https://api.archbee.com/api/optimize/9rfvxhrv8FA-8bxcK2IRv/arcOyyLMlzMUocmB7CDPJ_bots-pinned.png" alt="“固定”图标" caption size="10" width="19" height="24"}。

## 阶段信息

使用任何阶段上的信息图标 :inlineImage[]{src="https://api.archbee.com/api/optimize/9rfvxhrv8FA-8bxcK2IRv/zhADqF8Xg-JjZCllr9LX7_general-info-icon.png" alt="信息图标" caption size="10" width="24" height="23"} 可显示该阶段的功能描述、操作系统特定信息和设置详细信息。

## 重命名阶段

使用重命名 :inlineImage[]{src="https://api.archbee.com/api/optimize/9rfvxhrv8FA-8bxcK2IRv/NzJ4RatFKTvRdJAPyPfod_rename-stage.PNG" alt caption size="10" width="34" height="28"} 图标可为工作流程中的任何阶段指定自定义名称。 文本可以是任何有助于说明机器人相应部分的内容，而且在保存机器人时会保留。 机器人处于编辑模式时，选择工作流程中的阶段，然后点击重命名图标以显示**重命名阶段**对话框。 在对话框中指定名称或描述后，相关内容即会显示在工作流程的阶段中。 阶段文本现在还包括默认阶段名称（括号内）。 同样的组合文本也会显示在“阶段设置”面板和“阶段结果”视图中，如果将任何阶段结果用作另一个阶段的输入，则还会显示在变量选择器中。

:::hint{type="info"}
自定义名称字段中最多可以添加 200 个字符。
:::

## 新建和更新组

在机器人中添加新阶段或更新阶段后，这些阶段将在“新建和更新”组中显示 30 天（从发布日期起），而且阶段会标有*新建*或*更新*的绿色徽章。 30 天后，这些阶段将从“新建和更新”组中消失，并显示在实际组中。 此徽章可帮助用户识别新添加的阶段和旧阶段。

:::hint{type="info"}
如果此阶段处于抢先访问状态，则无论持续时间多长，此标记始终存在。 为所有人启用阶段后，新建或更新的徽章会在显示 30 天后删除。
:::

### 相关阶段

[自定义阶段](https://docs.ivanti.com/neurons/help/zh_cn/GBxujJGStCotjeZeWxPsz)

[用户阶段](https://docs.ivanti.com/neurons/help/zh_cn/yhd0EqErVHijNXNMq1oa-)
