---
title: Bots Results
slug: neurons/help/en_us/bots-results
createdAt: 2026-11-05T08:02:06.740Z
---

The Bots results page displays when you:

- Save and publish from the [Bots editor](docId:1J3-PICmwB5sYoZ1rg9En)
- Click on a bot name on the [Bots homepage](docId\:IPiwC3w-bXkrO_kZuFEdb). If you select a draft bot, the Bots editor displays.
- Click on a bot name on the [Trigger History](docId\:NLqipFoQ9tjU1xukyW_X2) page.
- Select the **Survey history** button on the [Survey Results](docId\:TOPiFWJBBzVjaooVXCgv7) page.

To edit the bot name click :inlineImage[]{src="https://api.archbee.com/api/optimize/9rfvxhrv8FA-8bxcK2IRv/rfwuX6H8GMk8T4AJQ-U8F_bots-nameedit.png" alt="pencil icon" caption size="10" width="22" height="21"}, the **Rename&#x20;**&#x64;ialog appears.

**Description**: To view or edit the bot/survey description select **Description**, the **Bot/Survey description** panel appears. Select **Save&#x20;**&#x74;o save any changes.

**Survey results**: This button only displays for survey bots. Select to display the [Survey Results](docId\:TOPiFWJBBzVjaooVXCgv7) page.

## Versions

All versions of the bot are listed under the Versions drop-down. Select a version to display the results in the work area. The latest version is always the current version. Learn more about [Bots versioning](docId\:NBrIrrbvuIjxl29YeQSFL).

## Filters

- **Version**: Select the version of the bot you want to view the results for.
- **Time**: Select a time range to filter the result data. The default is Last 7 Days. The maximum is limited to the last 90 days.
- **Triggers**: Select the source trigger to filter the result data; Schedule triggers, Custom Action triggers, Run Now, or All triggers. The default is All triggers.
- **States**: Select the last run device state to filter the result data; All states, shows all runs for all devices. Last state only, shows the last generated run per unique device including if the last run is still in progress. The default is All states.

## Actions

:::ExpandableHeading
## Edit Version

Select a version of the bot, and select **Edit version** to edit the bot stages or settings. When you have made all changes select **Save and publish** this creates a new version of the bot. Learn more about [Bots versioning](docId\:NBrIrrbvuIjxl29YeQSFL).
:::

:::ExpandableHeading{customAnchorSlug="RunNow"}
## Run Now

Select to start a bot run immediately:

1. Click **Run Now**. The Run now dialog displays.
2. In the Run now dialog, select a **Target group** to run the bot against.
   Target groups are set up in **Ivanti Neurons** > **Devices&#x20;**> **Groups**. Based on the scoped access granted to the initiating user, the devices or people targeted will fall into one of the following three categories:
   - **ALL SCOPES PERMISSION** – The bot will execute actions against all requested targets.
   - **PARTIAL SCOPES PERMISSION** – The bot will execute actions only for the target devices or people that fall within the user's assigned scope. It will not act on out-of-scope targets. As a result, the target count shown in the workflow may be lower than the number initially requested by the bot user.
   - **NO SCOPES PERMISSION** – The bot will not execute against any targets, and a scopes-related error will be displayed in the Trigger history. For more information on creating scopes for devices and people, see [Access Control](docId\:LbFC4ETyl4tETRWzdwEkK).
3. Select the **Target scope**. The scope is a percentage, in 10 unit intervals, between 10% to 100%. The scope randomly selects a number of devices within the target group, it does not detect whether the devices are online or offline.
   **Note**: A minimum of one device will always be selected, regardless of the percentage threshold.
4. Select the **Device run behavior**. There are two options to choose from:
   - **Run for online devices&#x20;**- Choose this option to run the custom actions only on devices that are currently online.
   - **Run for online devices and queue offline devices to run when next online&#x20;**- Choose this option to run the custom actions immediately on online devices. For offline devices, the tasks are queued and will run when they come online.
5. Specify the **Days to wait before timeout**. Enter the number of days to wait for the device to come online. If the device does not come online within the specified time period, the run request times out. The Maximum waiting period is 28 days.
6. If the bot has any Bot inputs, you must set the mandatory ones.
   Bot inputs are setup on the Bot editor page. Learn mo re about [Bot inputs](docId:1J3-PICmwB5sYoZ1rg9En).
7. Click **Run now**. The trigger in progress dialog displays.
8. The **Trigger history** and **Device history** will update as the Bot progresses.
   The successful or failed trigger details can be viewed in the **Trigger history**.
:::

:::ExpandableHeading
## Information

Select to view version details for a bot:

1. Select the **Version&#x20;**&#x6F;f the bot you want to see more information on. The Version information panel displays.
   The information displayed depends on the trigger type and status:
   - **Version**: The bot version number.
   - **Trigger type**: The bot trigger type: Schedule or Custom action.
   - **Trigger status**: The status of the bot;
     - active/inactive - for current version.
     - was active/was inactive - for past version.
   - **Target groups**: The target device groups on which the bot will run. Only applicable for active scheduled bots.
   - **Frequency**: The schedule frequency the bot is due to run on the target groups. Only applicable for active scheduled bots.
   - **Custom action display name**: The bot name as it will display in the Device Action panel. Only applicable for active custom actions.
   - **Created**: The date and time the version of the bot was created.
   - **Created by**: The name of the person that created the version of the bot.
   - **Version comments**: Any descriptive text relating to the bot version creation.
:::

:::ExpandableHeading
## Canceling a bot

You can terminate a running bot at any stage to stop further processing. This ensures better control, efficiency, and flexibility in bot management. This functionality helps to deal with unintended executions, stop faulty workflows, and prevent unnecessary actions that could cause errors or performance issues.

To cancel a running bot:

1. On the **Bots** homepage, select **Trigger history**.
   The **Trigger history** page appears.
2. In the cancel column, select **Cancel** in the in-progress bot to terminate the bot
3. Select **OK** to confirm the cancellation.

Or

1. On the **Bots** homepage, select the name of the bot you want to cancel.
   The **Bots results** page appears.
2. In the **Trigger history** section, select **Cancel running** to stop all targets of a bot in a particular version.
   Or select **View details** to stop individual targets.
   The **Trigger history** page appears.
3. In the cancel column, select **Cancel** in the in-progress bot to terminate the bot.
4. Select **OK** to confirm the cancellation.
:::

## Results view

The Results view displays the Trigger and Device history, and the bot stages together with their run results.

### Trigger history

The Trigger history section indicates the number of times the bot had been triggered. The following trigger states are recorded:

- **Attempted**: The number of times the bot version has been triggered, either by a Schedule, Custom Action, or as a manual run now action.
- **Failed**: The number of times a trigger has failed, such as a system error has occurred, or the target devices for the bot cannot be found.
- **Fired**: The number of times the trigger has been successful.

Click **View details** to display the [Trigger History](docId\:NLqipFoQ9tjU1xukyW_X2) page.

### Device history

The Device history section indicates the number of devices targeted by the bot. The following device states are recorded:

- **In scope**: number of devices in the selected Devices target group.
- **Unavailable**: number of devices that are offline in the Devices target group.
- **Targeted**: number of devices that are online in the Devices target group which the bot will run against.
- **Successful**: number of devices where the bot has successfully completed all stages.
- **With error**: number of devices where the bot has a failed or timed-out stage. It depends on the configuration whether the bot continues to run for the devices without error.
- **In progress**: number of devices where the bot is still running.

### Stage results

All the stages of the bot display in the results area. The trigger stage displays the status Active/Inactive, and for a Custom action trigger the number of users that the bot is visible to is also shown. Hover over the number to display the names of the users who have been granted access to view and run the bot as a Custom action in Devices.

All other stages contain run metrics, the metrics shown are restricted by the results filter criteria and depend on the type of stage:

### Stage type: Queries and Filters

- **Performed&#x20;**: the number in the top right of the Stage indicates the number of devices on which the Query/Filter was performed during this bot version.
- :inlineImage[]{src="https://api.archbee.com/api/optimize/9rfvxhrv8FA-8bxcK2IRv/Konn3UM7LewZqtNqBIptq_bots-inprogress.png" alt="Run in progress icon" caption="Run in progress icon" size="10" width="26" height="23"} **In progress**: number of devices the Query/Filter is currently still in progress for this bot version.
- :inlineImage[]{src="https://api.archbee.com/api/optimize/9rfvxhrv8FA-8bxcK2IRv/pC1KMo8YNbUBWym0Y4-gX_bots-failed.png" alt="Run failed icon" caption="Run failed icon" size="10" width="27" height="27"} **Failed&#x20;**: number of devices the Query/Filter has failed on for this bot version.
- :inlineImage[]{src="https://api.archbee.com/api/optimize/9rfvxhrv8FA-8bxcK2IRv/8y51Tv5RpUB_noU-idM6l_bots-successful.png" alt="Run successful icon" caption="Run successful icon" size="10" width="24" height="25"} **Matched&#x20;**: number of devices where the Query/Filter criteria has been successful for this bot version.

  :::hint{type="info"}
  A Query/Filter is successful even if there are no results. For more detail see the stage tooltip which shows Queries matched and Queries not matched.
  :::

### Stage type: Actions and Interactions

- **Performed&#x20;**: the number in the top right of the Stage indicates the number of devices the Action/Interaction was performed on during this bot version.
- :inlineImage[]{src="https://api.archbee.com/api/optimize/9rfvxhrv8FA-8bxcK2IRv/Konn3UM7LewZqtNqBIptq_bots-inprogress.png" alt="run in progress icon" caption="run in progress icon" size="10" width="26" height="23"} **In progress**: number of devices the Action/Interaction is currently still in progress for this bot version.
- :inlineImage[]{src="https://api.archbee.com/api/optimize/9rfvxhrv8FA-8bxcK2IRv/pC1KMo8YNbUBWym0Y4-gX_bots-failed.png" alt="run failed icon" caption="run failed icon" size="10" width="27" height="27"} **Failed**: number of devices where the Action/Interaction has failed for this bot version.
- :inlineImage[]{src="https://api.archbee.com/api/optimize/9rfvxhrv8FA-8bxcK2IRv/8y51Tv5RpUB_noU-idM6l_bots-successful.png" alt="run successful icon" caption="run successful icon" size="10" width="24" height="25"} **Successful**: number of devices where the Action/Interaction has been successful for this bot version.

Click any of the stage metrics, that has a number greater than zero, to display the Stage results details page.

### Stage results details

The Stage results details page displays when you select a stage metric. The details table will be dependent on the type of stage. If the stage is connected to another application, a link is available to click and go to a deeper level of detail. For example, the Create or update ITSM Ticket stage has an **Open in ITSM** link, this opens the corresponding ticket in Ivanti Neurons for ITSM.

### Related topics

[Trigger History](docId\:NLqipFoQ9tjU1xukyW_X2)

[Bots versioning](docId\:NBrIrrbvuIjxl29YeQSFL)

[Bots editor](docId:1J3-PICmwB5sYoZ1rg9En)
