Invoking a Neurons Bot

Ivanti Neurons Bots provide powerful hyper-automation capabilities. Neurons Bots capability within Ivanti ITSM provides an integration between ITSM and Ivanti Neurons, and enables you to invoke a Neurons Bot from ITSM.

Neurons Bots can only be invoked from a business object that has a relationship (link) to a CI business object record. Also note, if the business object from which a Neurons Bot is invoked has a relationship with more than one CI record, an error is displayed.

For more information, see Neurons Bots.

For information on enabling a Neurons Bot you can trigger from within ITSM, see Neurons Bots Integration for ITSM.

Invoke a Neurons Bot

1. Open the business object record that is linked to the CI record you want to invoke a Neurons Bot upon.

The business object selected to invoke the Neurons Bot must only be linked to a single CI record, if it is linked to more than one CI record an error is displayed.


2. Click More, and then select the required Neurons Bot Quick Action.
   If the Neurons Bot Quick Action requires user input, a dialog box opens.

3. Enter the required input into the dialog box, and then click OK. Skip this step if no input is required.
   The Neurons Bot is invoked and performs the action.

When the Neurons Bot invokes successfully a Neurons Bots Invocation confirmation is displayed.

Check a Neurons Bot Invocation and Invocation Results

Once a Neurons Bot is invoked you can check the invocation status, and invocation results, from the related CI business object record.

To check invocation status:

The Neurons Bot Invocations tab displays a list of bot invocations. Each entry contains status information for a single bot invocation. A single bot invocation may provide multiple results, which are displayed in the Neurons Bot Results tab.

1. Open the related CI business object record.

2. Select the Neurons Bot Invocations tab.
   If this tab is not visible, click the Restore hidden tabs icon , and then select it from the list.

3. Double-click the invocation record in the list.
   The Edit Neurons Bot Invocation dialog opens.

• Bot Name: Name of the bot that was invoked.

• Completion State: Current state of invocation, which can be:

  • Pending

  • In Progress

  • Success

  • Failed

  • Timed Out

  • Skipped

  • Unknown

• Invoked On: Date/time the bot was invoked.

• Started On: Date/time the bot started running and processing inputs.

• Finished On: Date/time the bot finished running.

• CI Results: Contains invocation results. There may be multiple results. Double-click results to access the result records directly.

• Inputs: Contains a log of input parameter ID's (in JSON) against the values sent when invoking the bot. This field is empty if no parameter ID's are sent.

• Failure Code: Contains a failure code if the bot fails to run or complete.

• Failure Reason: Contains information on the reason the bot failed to run or complete.

To check invocation results:

The Neurons Bot Results tab displays a list of results for each invocation. There may be one or more results for a single bot invocation.

1. Open the related CI business object record.

2. Select the Neurons Bot Results tab.
   If this tab is not visible, click the Restore hidden tabs icon , and then select it from the list.

3. Double-click the invocation record in the list.
   The View Neurons Bot Invocation CI Result dialog opens.

• Agent Identifier: ID of the Ivanti Neurons agent running on the CI device

• Result State: State of invocation, which can be:

  • In Progress

  • Complete

  • Failed

  • Timed Out

  • Skipped

  • Unknown

• Bot Name: Name of the bot that produced the result.

• Completion State: As listed for Completion State above.

• Invoked On: Date/time the bot was invoked.

• Started On: Date/time the bot started running and processing inputs.

• Finished On: Date/time the bot finished running.

• Inputs: Contains a log of input parameter ID's (in JSON) against the values sent when invoking the bot.