---
title: 机器人编辑器
slug: neurons/help/zh_cn/DGK8PFFeI6F1yhty2vPmE
createdAt: 2026-09-07T07:01:34.498Z
---

在创建机器人页面上选择机器人触发器类型后，将显示机器人编辑器页面。 使用编辑器，通过构建阶段来创建机器人。 阶段可以是查询组合，带有用于查询结果的筛选器和操作。 了解有关[机器人阶段](https://docs.ivanti.com/neurons/help/zh_cn/Ai-MQmzJ-S-g2XEMPxjxP)的更多信息。

## 如何构建机器人

1. 机器人将始终从您在[机器人创建](https://docs.ivanti.com/neurons/help/zh_cn/_Zep_u2udEyqo7s_ueV3A)页面上选择的触发器开始。
   将机器人从**非活动**（默认）设置为[触发器设置](https://docs.ivanti.com/neurons/help/zh_cn/DGK8PFFeI6F1yhty2vPmE#Triggersettings)时，可以更新**触发器设置**。您可以立即进行此操作，也可以在构建机器人后进行。 您也可以在“触发器设置”中更改**触发器类型**。
2. 要构建机器人，请向工作区添加阶段。 您可以使用搜索来查找阶段，或者通过展开阶段类别来查看可用的阶段。 深入了解[阶段类别](https://docs.ivanti.com/neurons/help/zh_cn/Ai-MQmzJ-S-g2XEMPxjxP#Stages)。
3. 点击并拖放所需阶段到工作区。 阶段放入工作区后，以下功能将可用：
   - :inlineImage[]{src="https://api.archbee.com/api/optimize/9rfvxhrv8FA-8bxcK2IRv/yqlPwPruOHsxAdvybSLUD_bots-stagehelp.png" alt="信息图标" caption="信息图标" size="10" width="25" height="27"} 点击可显示“查看阶段信息”面板。 此面板提供了阶段描述以及其将返回的所有属性的列表，例如设备名称、设备型号、事件 ID、事件日期。
   - :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)。
   - :inlineImage[]{src="https://api.archbee.com/api/optimize/9rfvxhrv8FA-8bxcK2IRv/0nzrFV6hwRnhtnb10ev4d_bots-stagedisconnect.png" alt="裁切图标" caption="裁切图标" size="10" width="26" height="21"} 点击可断开不同阶段之间的连接。
   - :inlineImage[]{src="https://api.archbee.com/api/optimize/9rfvxhrv8FA-8bxcK2IRv/zG3QmHflRf4TInHA1V5px_bots-stagedelete.png" alt="删除阶段图标" caption="删除阶段图标" size="10" width="25" height="25"} 点击以从机器人删除阶段。

:::hint{type="info"}
可以复制 (CTRL+C) 工作流程的任何部分，然后粘贴 (CTRL+V) 到工作区或在浏览器标签页之间进行粘贴（仅适用于 Chrome）。
:::

4. 点击**阶段**查看“阶段设置”。 填写阶段属性以自定义机器人。 红色星号表示必填属性。
5. 点击并拖放连接器图标 :inlineImage[]{src="https://api.archbee.com/api/optimize/9rfvxhrv8FA-8bxcK2IRv/pv_NnT8Oq4CPZyXAvCz6R_bots-stageconnect.png" alt="连接器图标" caption="连接器图标" size="10" width="27" height="25"}，以连接各个阶段。
6. 连接所有必要阶段、筛选器和操作，并创建完机器人后， 请选择**保存并发布**。

:::hint{type="info"}
可以随时点击**保存草稿**，将机器人保存为草稿。 如果退出编辑器而不保存，将显示确认对话框。 可以选择保存草稿，也可以放弃所做的任何更改。
在保存草稿时，机器人名称旁边会显示**我的草稿**，以指示草稿状态。
:::

### 触发器设置

触发器阶段是机器人的类型，即 **计划**或**自定义操作**或**修补程序部署调查**。 它始终是机器人编辑器中的第一阶段。

要编辑触发器设置，点击工作区中的“触发器阶段”，打开“触发器设置”面板。 仅当触发器**状态**为**活动**时，您才可以编辑触发器设置。

可用的设置将取决于触发器类型：

::::ExpandableHeading
## 计划机器人触发器设置

- **目标组**：选择要运行机器人的目标组。
- **目标范围**：在 10% 至 100% 之间选择一个百分比，以 10 个单位为间隔。 范围会随机选择目标组内的多个设备，并且不检测设备是在线还是离线。

:::hint{type="info"}
无论百分比阈值如何，都将始终至少选择一台设备。
:::

- **设备运行行为**：有两个选项可供选择：
  - **针对在线设备运行** - 选择此选项时，仅在当前在线的设备上运行计划的机器人。
  - **针对在线设备运行，同时让离线设备排队，以便下次在线时运行** - 选择此选项时，可在在线设备上运行计划的机器人。 对于离线设备，任务会排队并在设备上线时运行。
    选择此选项时，需要指定**超时前等待的天数**。 输入等待设备上线的天数。 如果设备在指定时间段内未上线，则运行请求将超时。 最长等待 28 天。
  - 点击**运行**开始操作。
- **限制设备**：启用**限制设备**以指定目标设备的最大数量。 如果超过最大目标计数，则整个调用会立即失败，并且不会处理单个设备。 触发器在**触发器历史记录**中标记为**失败**。 在应用范围界定后评估设备计数（基于允许用户查看或作为目标的内容）。 联机和脱机设备都包含在计数中。 此限制仅适用于计划的触发器。
  您还可以在**设置** → **通知**下配置电子邮件通知功能，这样当超出阈值且工作流程出现失败情况时，您就能收到通知了。 有关通知的详细信息，请参阅[机器人主页](https://docs.ivanti.com/neurons/help/zh_cn/e_zoKSuDptKjpDHJJ6teN)。
- **最大目标数**：切换**限制设备**后将显示此字段。 输入目标设备的最大数量。
- 切换**计划模式**以选择基本或高级计划功能。
  基本设置使计划保持简单。 该计划是重复的，并提供**每日**或**每周**的选项。 重复间隔可以以分钟、小时或周为单位指定。
- **重复**：选择计划是否重复，是每日重复还是每周重复。
- **频率**：选择计划频率的单位，按分钟还是小时。
- **间隔**：选择间隔，从 30 到 55，以 5 个单位为间隔。
- **开始**：选择第一次计划运行的开始日期和时间。
- **结束**：选择最后一次计划运行的结束日期和时间。

  高级设置提供了附加选项，例如要包含的特定日期和每月计划，以便更好地控制计划。 该计划将一直运行，直到计划触发器设置为非活动状态。 要开始高级模式，请选择**高级计划设置** ，然后会出现**计划设置**部分。
- **重复**：选择计划是否重复，是每日重复、每周重复还是每月重复。 以下选项取决于每日/每周/每月选项的选择。
  **每日**:
- **一周中的天数**：您可以选择一周中的每一天，星期一至星期五，星期六至星期日，或用户定义的日子。
- **天数**：如果您在上一个字段中选择了用户定义的选项，那么您必须选择此机器人运行的天数。
- **每隔**：选择机器人可以运行的时间。 默认情况下，设置为 3 小时。
  **每周**：
- **每隔**：您可以选择一周中的任意天数。
  **每月**：
- **频率**：选择计划频率选项：当月中某天、当月的周或每月发生。 以下选项取决于频率选项的选择。
  - **当月中某天**：您可以选择月份中的任意日期来运行机器人。
  - **当月的周**：您可以选择该月的第一周、第二周、第三周、第四周或最后一周。
  - **一周中的天数**：一旦您选择了月份中的第几周，您就需要选择用来运行机器人的一周中的天数。
  - **每月间隔**：您可以选择每月、每 3 个月或每 6 个月作为每月间隔。 或者，如果您选择用户定义选项，那么您可以在月份字段中选择任意月份或多个月份。
  - **以月份开始**：如果您选择每 3 个月或每 6 个月作为每月间隔，那么您需要从 1 月到 12 月选择一个起始月份。
- 在概览中，您可以看到您的设置概览；它为您提供了机器人运行方式的估计。
- 点击**确定**可激活高级计划设置。

:::hint{type="info"}
对于基本设置，一旦您保存并发布机器人，机器人就会自动运行，但对于高级设置，则不会发生这种情况。
:::

**机器人输入**：如果已经为此机器人定义任何机器人输入，它们将出现在这里供您设置。
::::

::::ExpandableHeading{customAnchorSlug="Customaction"}
## 自定义操作机器人触发器设置

### “设备”视图中的已发布选项

**单台设备**：将切换开关设置为**打开**，以在**设备**中启用单台设备的自定义操作。 启用后，机器人可以在**设备**中所选的单个设备上运行。 此为默认设置。

:::hint{type="info"}
机器人排队时，仅针对已选择的设备运行。
:::

在单台设备上使用设备运行行为选项：

1. 前往**主菜单** > **设备**。
   **设备**页面随即显示。
2. 点击所需的设备。
   设备**概述**选项卡随即显示
3. 在**操作**面板上，点击运行 :inlineImage[]{src="https://api.archbee.com/api/optimize/9rfvxhrv8FA-8bxcK2IRv/BaLHkWhW_FCx7gmcwLtxR_generalrun.png" alt caption size="10" width="23" height="24"} 来使用**设备运行行为**选项。
   **设备运行行为**对话框随即显示。 有两个选项可供选择：
   - **针对在线设备运行** - 选择此选项时，仅在当前在线的设备上运行自定义操作。
   - **针对在线设备运行，同时让离线设备排队，以便下次在线时运行** - 选择此选项时，可立即在在线设备上运行自定义操作。 对于离线设备，任务会排队并在设备上线时运行。
     选择此选项时，需要指定**超时前等待的天数**。 输入等待设备上线的天数。 如果设备在指定时间段内未上线，则运行请求将超时。 最长等待 28 天。
4. 点击**运行**开始操作。

**多个设备**：将切换开关设置&#x4E3A;**“打开”**，以在“设备”中启用多个设备的自定义操作。 启用后，机器人可以在“设备”中所选的多个设备上运行。

在多台设备上使用设备运行行为选项：

1. 前往**主菜单** > **设备**。
   **设备**页面随即显示。
2. 选择所需的设备。 必须至少选择两台设备才能使用**自定义操作**按钮。
3. 点击**自定义操作**按钮。
   **自定义操作**窗口随即显示。
4. 点击运行 :inlineImage[]{src="https://api.archbee.com/api/optimize/9rfvxhrv8FA-8bxcK2IRv/BaLHkWhW_FCx7gmcwLtxR_generalrun.png" alt caption size="10" width="23" height="24"} 来使用**设备运行行为**选项。
   **设备运行行为**对话框随即显示。 有两个选项可供选择：
   - **针对在线设备运行** - 选择此选项时，仅在当前在线的设备上运行自定义操作。
   - **针对在线设备运行，同时让离线设备排队，以便下次在线时运行** - 选择此选项时，可立即在在线设备上运行自定义操作。 对于离线设备，任务会排队并在设备上线时运行。
     选择此选项时，需要指定**超时前等待的天数**。 输入等待设备上线的天数。 如果设备在指定时间段内未上线，则运行请求将超时。 最长等待 28 天。
5. 点击**运行**开始操作。

要在**设备**上启动自定义操作的用户，其角色必须具备**执行自定义操作**权限和/或**在多个设备上执行自定义操作**权限。 有关角色和权限的详细信息，请参阅[访问控制](https://docs.ivanti.com/neurons/help/zh_cn/jth63j9IOALMbIPN76faa)。

必须启用其中一个已发布选项，否则机器人将不会在[设备](https://docs.ivanti.com/neurons/help/zh_cn/P4k1P0BYFIA4ORRku1LvJ)中作为自定义操作发布。

### “设备”视图用户访问

**选择访问范围**：

- **所有人**：选择**所有人**可允许所有具有**执行自定义操作**权限和/或**在多个设备上执行自定义操作**权限的用户从**设备**查看和运行机器人。
- **角色**：选择一个或多个可从**设备**查看和运行机器人的角色，并且这些角色具有**执行自定义操作**权限和/或**在多个设备上执行自定义操作**权限。
- **用户**：选择**用户**可仅允许列入所选用户的用户从“设备”查看和运行机器人。
  所选用户必须具有**执行自定义操作**权限和/或**在多个设备上执行自定义操作**权限。

**限制用户访问：**

1. 在**触发器设置**中，将**触发器状态**切换开关设置为**活动**。
2. 选择**限制用户访问**。
   随即显示**用户访问**页面。
3. 在**用户访问**页面上，选择**添加用户**。
   随即显示**添加用户**面板。
4. 在**添加用户**面板上，选择您要授予机器人访问权限的所有用户（这些用户可以在设备中用自定义操作方式访问机器人）。 这会限制所有其他用户访问机器人。
5. 选择**确定**确认您的选择并关闭面板。
6. 您选择的用户列在用户访问页面上。 选择**应用并关闭**以保存更改并返回到触发器设置。

工作区上的自定义操作阶段，显示**可见使用者**，其为拥有访问权限的使用者数，或者如果没有指定使用者，则显示所有使用者。

### 自定义操作名称和描述

- **自定义操作显示名称**：输入自定义操作的显示名称。 此名称将显示在 Ivanti Neurons **设备** > **操作**中。
- **描述**（可选）：输入操作的描述性文本。

### 在“设备组”上运行自定义操作

1. 前往**主菜单** > **设备** > **组** > **公共组**。 选择所需的组。
2. 从筛选后的列表中点击所需的设备组。
3. 在**操作**面板上，导航到**自定义操作**，点击所需自定义动作的播放按钮。
   随即显示对话框。
4. 点击**运行**，针对所选设备启动自定义操作。
   显示以下消息：
   “机器人正在运行。 您可以关闭此对话框并继续工作。 操作完成后，您将收到通知。”
5. 收到完成消息后点击**关闭**。

查看结果：

1. 点击左上角的 :inlineImage[]{src="https://api.archbee.com/api/optimize/9rfvxhrv8FA-8bxcK2IRv/ubHkW9HD4CEJUel4jI_JS_bell-icon.png" alt caption size="10" width="20" height="28"} 图标，然后点击**查看结果**。
   随即显示**触发器历史记录**页面。
2. 点击**目标计数**下的值，查看设备的详细状态。

或者，也可以针对设备运行自定义操作：

1. 前往**主菜单** > **设备**，然后选择要运行自定义操作的设备。
   必须选择多个设备才能获取**自定义操作**按钮。
2. 点击**自定义操作**按钮。
   随即显示**自定义操作**面板。
3. 点击要运行的自定义操作的播放按钮。
   **自定义操作**面板仅列出为多个设备启用的自定义操作。

请参阅上文中的步骤 3-6 以继续。

### 在“人员”上运行自定义操作

1. 前往**主菜单** > **人员**。 附有列表的**人员**页面随即显示。
2. 点击所需用户的名称。 也可以搜索用户。
   用户页面随即显示。
3. 点击**操作**来打开**操作**面板。
4. 在**操作**面板上，导航到**自定义操作**，点击所需自定义动作的播放按钮。
   **机器人输入**对话框随即显示。
5. 输入内容并点击**运行**，针对所选用户启动自定义操作。
   以下消息随即显示：
   “机器人正在运行。 您可以关闭此对话框并继续工作。 操作完成后，Ivanti Neurons 托盘中会收到通知。”
6. 收到完成消息后点击**关闭**。

或者，也可以针对多个用户运行自定义操作：

1. 前往**主菜单** > **人员**。 选择要运行自定义操作的用户。
   必须选择多个用户才能使用**自定义操作**按钮。
2. 点击**自定义操作**按钮。
   随即显示**自定义操作**面板。
3. 在**操作**面板上，点击要运行的自定义操作的播放按钮。
   **机器人输入**对话框随即显示。

:::hint{type="info"}
**自定义操作**面板仅列出为多个用户启用的自定义操作。
:::

请参阅上文的步骤 4 到 5 继续操作。
::::

### 连接设置

点击连接器线，打开**连接**面板。

### 条件

连接器线条件有助于在端点通过各个阶段时筛选端点。 对于多个类型阶段，连接器条件不会删除结果元素，因此不会修改任何数据。

- **已启用链接**：选择允许下游阶段运行并选择性地指定连接的条件、外观和标签。 无论指定什么条件，禁用切换都会停用连接，并且下游阶段将不会执行。 工作流中连接的可视外观将根据此设置进行更新。 此断路器功能在设计机器人或排除机器人故障时可能很有用。

:::hint{type="info"}
当链接被禁用时，连接的所有当前条件、标签和线条样式都会自动保留。 任何时候启用连接上的切换都会自动将所有这些设置恢复到连接，即使您已保存、退出并稍后重新打开机器人。
:::

- **有条件**：选择使用条件来确定哪些端点继续到下一个机器人阶段。
  - **有自动描述**：选择在连接线上显示条件参数。 以 Ivanti Neurons 登录配置文件中配置的语言显示。
  - **有多少为 true？**：选择**所有**（以及）或者**一个**（或者）。 仅当您**添加**超过一个条件时才适用。
  - **选取值**：选择条件值。
  - **结果匹配**：选择**全部**或**一个**。 仅适用于连接到多个类型的阶段。
  - **选择运算符**：选择条件运算符。 取决于所选值。
  - **自定义值**：为所选运算符选择自定义值。 取决于所选的运算符。

### 外观

可以自定义连接器线的类型、样式、线宽、链接样式和颜色。

### 标签

可以将标签添加到连接器线。 选择**添加标签**可创建新标签。 您可以按位置、填充、轮廓和文本颜色自定义标签。 选择**删除标签**可从连接器线删除标签。

## 机器人输入

如果您可以选择可以采取的操作，则在机器人编辑器中创建机器人输入以供在机器人中使用。 所以您可以有一个通用的机器人，但允许分析师选择在运行时采取什么行动。

例如，在磁盘清理操作中，您可以使用以下选项回收磁盘空间字段；删除临时文件并仅制作 onedrive 内容云，或者删除临时文件并执行 cleanmgr，或者两者都执行。

您可以配置输入字段的名称、类型和默认值，以及它是可选的还是必填的。

当您选择从设备视图或通过[立即运行](https://docs.ivanti.com/neurons/help/zh_cn/0Mb5LmQIkQxN7YM0XtXml#RunNow)手动运行自定义操作时，可以使用机器人输入。 输入也可用于计划机器人，在这种情况下，已创建的任何机器人输入都将显示在[触发器设置](https://docs.ivanti.com/neurons/help/zh_cn/DGK8PFFeI6F1yhty2vPmE#Triggersettings)中。

:::ExpandableHeading{customAnchorSlug="Define-inputs"}
## 如何定义机器人输入

1. 在“Neurons 机器人编辑器”页面中，选择**定义输入**以打开“定义输入”面板。
2. 选择**添加输入**以显示用于创建新输入的字段。
3. **名称**：输入字段的显示名称。
4. **类型**：字段所需的输入类型。 选择自:
   - **文本/字符串**：选择此项可创建自由文本字段。
   - **数字**：选择此项可创建数值字段。
   - **True/False**：选择此项可创建 True 或 False 选择字段。
   - **日期**：选择此项可创建日期字段，使用日期选择器。
   - **文本选项**：选择此项可创建选项字段。 如果选中，您需要定义选项是什么，输入**选项名称**和**选项值**，名称是友好的显示名称，值是通过机器人传递的字符串。 您可以添加多个选项。
5. **可选**：选择字段是否可选。
6. **默认值**：设置输入的默认值。 默认值中的选项取决于您选择的输入类型。
:::

## 定义变量

在机器人级别定义变量。 然后，当使用**设置变量**、“通用”阶段时，该变量会更新。

进一步了解[设置变量阶段](https://docs.ivanti.com/neurons/help/zh_cn/Ai-MQmzJ-S-g2XEMPxjxP#setvariable)和[阶段变量](https://docs.ivanti.com/neurons/help/zh_cn/Ai-MQmzJ-S-g2XEMPxjxP#variables)

::::ExpandableHeading
## 如何定义机器人变量

1. 在“Neurons 机器人编辑器”页面中，选择**定义变量**。
2. 选择**添加变量**以显示变量字段。
3. **名称**：输入变量的名称。 使用设置变量阶段时，这是**选择变量**下拉列表中列出的名称。
4. **类型**：可以为“设备”和“人员”选择不同的变量集。
   - **设备**：从以下选项中选择变量类型：
     - 文本/字符串
     - 编号
     - True/False
     - 日期
     - 文本选项
   - **人员**：从以下选项中选择变量类型：

     - 人员职务
     - 人员位置
     - 人员经理
     - 人员部门
     - 人员电子邮件
     - 人员名称

     :::hint{type="info"}
     可以针对列表中可用的静态人员组运行机器人。
     :::
5. **初始值**：设置变量的初始值。 该条目将取决于您选择的变量类型。
::::

## 运行机器人的一部分

您必须选择至少两个阶段才能进入测试模式。 您可以按住 Shift 键进行点击和拖动，或按住 Ctrl 键并双击来选择阶段。 一旦您选择了阶段，在右侧，就会出现**针对设备运行阶段**部分。

它可让用户有选择地执行机器人工作流程的特定部分，以便高效地调试、测试和分析问题，而无需运行整个机器人。 它可让用户检查实时日志、变量状态和中间输出，有助于隔离错误并快速验证修复。 具有重放功能，可在优化开发和故障排除的同时确保稳定性。

在“针对设备运行阶段”部分，您必须在**选择设备**字段中选择要运行测试的设备，并填写阶段所需的任何其他输入。

填写完所有输入后，点击**运行**，这将创建一个新的工作流程。 它使未选定的工作流程变灰，并且仅在您选择的阶段运行。

### 相关主题

[机器人阶段](https://docs.ivanti.com/neurons/help/zh_cn/Ai-MQmzJ-S-g2XEMPxjxP)

[机器人结果](https://docs.ivanti.com/neurons/help/zh_cn/0Mb5LmQIkQxN7YM0XtXml)
