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 be invoked from a business object that has a relationship (link) to, or can be invoked from, a CI business object record. Also note that, if the business object from which a Neurons Bot is invoked has a relationship with more than one CI record, an error is displayed.

Supported OOTB (Out Of The Box) business objects you can invoke a Neurons Bot from if linked to a CI record are:

Incident.

Change.

Problem.

Knowledge.

In this topic:

Invoke a Neurons Bot

Check a Neurons Bot Invocation and Invocation Results.

Troubleshooting a Neurons Bot Invocation.

For more information, refer to Neurons Bots.

For information on enabling a Neurons Bot you can invoke from within ITSM, refer to 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.

  2. 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.

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

  4. 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 results from the related CI business object record.

Troubleshooting a Neurons Bot Invocation

If you experience an error and a Neurons Bot fails to run when invoked, check the table below for possible reasons for the error, and possible solutions.

Issue

Possible Reason(s)

Solution
When run, the following Quick Action error is displayed: CI record with Neurons device information must be linked prior to running this Quick Action.

No CI record is linked to the current record, or is not being run directly against a CI record.

Link a CI record that was imported from Neurons to the current record.

When run, the following Quick Action error is displayed: CI record requires Neurons device information prior to running this Quick Action

The Quick Action is being run directly against a CI record, but does not have the Agent ID field populated.

Ensure the Neurons Bots device synchronization has been configured to import the Agent ID, and it has been run successfully.

Run directly against a CI record with an Agent ID.

When run, the following Quick Action error is displayed: Unable to resolve relationship from <Business Object A> to <Business Object B> via reference name.

The Quick Action is run against an unsupported business object. Business objects that are supported OOTB are:

 

Incident.

Change.

Problem.

Knowledge.

Only run a Neurons Bot against a supported business object.
When run, the following Quick Action error is displayed: Multiple Agent IDs linked. Cannot determine desired agent to target. More than one CI record is linked to the current record. Ensure that there is only a single CI record with a Neurons Agent ID linked to the current record.
When run, the following Quick Action error is displayed: The method or operation is not implemented. The Action Service feature flag has not been enabled. Request Ivanti Cloud Operations to enable the Action Service feature flag. Refer to More Information.

You created a Neurons Bot Quick Action in the Graphical Action Designer, but it is not shown when attempting to run it.

The EnableActionService global constant has not been enabled.

Set the EnabledActionService global constant to True. Refer to Working with Global Constants.