Overview

The IT Automation connector enables your Leena AI Agents to perform automated IT operations, including remote script execution, software installation, and software uninstallation on managed devices.

IT Automation is Leena AI's built-in IT Service Management (ITSM) integration that allows organizations to automate routine IT tasks directly from conversational workflows. The connector acts as a bridge between Leena AI and your organization's IT infrastructure, enabling seamless execution of IT automation scripts and software lifecycle management operations.

API Details

Leena AI integrates with IT Automation via internal REST APIs. This is a native Leena AI connector that communicates with the IT Automation service within the Leena AI platform.

Setup

The IT Automation connector is a pre-configured internal connector within the Leena AI platform. Authentication is handled automatically using internal application secrets.

Prerequisites

Before using the IT Automation connector, ensure you have:

• Access to your Leena AI workspace with connector management permissions
• IT Automation module enabled for your organization
• Scripts and software packages configured in your IT Automation library
• Target devices registered and managed within your IT infrastructure

Add connection

Here is how to add a connection on Leena AI:

1. Log in to your Leena AI workspace
2. Navigate to Settings > Integrations
3. Search for "IT Automation" and select it from the list to add its new connector
4. The connector will be automatically configured with internal authentication
5. Save the configuration

Actions

The following actions are supported for the IT Automation connector:

Trigger Execute Script

Executes a predefined automation script on a target user's device. The Agent can leverage the skill (workflow), which has been designed to run IT automation scripts, once the user raises a request to execute a specific script on their device.

Input Parameters

Here are the input parameters required to set up this action:

Mandatory

Optional

Here is a sample JSON input:

{
  "email": "[email protected]",
  "serialNo": "ABC123XYZ",
  "scriptId": "script-001",
  "workflowId": "workflow-123",
  "variables": {
    "targetPath": "C:\\Users\\Public",
    "timeout": "300"
  },
  "webhook": {
    "url": "https://api.leena.ai/callback/script-execution",
    "body": {
      "workflowItemId": "item-456"
    }
  }
}

Response

Upon successful execution trigger, the action returns:

• Execution status
• Execution ID
• Script execution details
• Callback confirmation (if webhook configured)

Trigger software installation

Initiates the installation of a software package on a target user's device. The Agent can leverage the skill (workflow), which has been designed to deploy software remotely, once the user requests software installation on their device.

Input Parameters

Here are the input parameters required to set up this action:

Mandatory

Optional

Here is a sample JSON input:

{
  "email": "[email protected]",
  "serialNo": "DEF456UVW",
  "softwareId": "software-chrome-001",
  "workflowId": "workflow-789",
  "variables": {
    "installPath": "C:\\Program Files",
    "silentInstall": "true"
  },
  "webhook": {
    "url": "https://api.leena.ai/callback/software-install",
    "body": {
      "workflowItemId": "item-789"
    }
  }
}

Response

Upon successful installation trigger, the action returns:

• Installation status
• Execution ID
• Software deployment details
• Callback confirmation (if webhook configured)

Software Un-installation

Initiates the uninstallation of a software package from a target user's device. The Agent can leverage the skill (workflow), which has been designed to remove software remotely, once the user requests software removal from their device.

Input Parameters

Here are the input parameters required to set up this action:

Mandatory

Optional

Here is a sample JSON input:

{
  "email": "[email protected]",
  "serialNo": "GHI789RST",
  "softwareId": "software-legacy-app-001",
  "workflowId": "workflow-456",
  "variables": {
    "removeUserData": "false",
    "forceUninstall": "true"
  },
  "webhook": {
    "url": "https://api.leena.ai/callback/software-uninstall",
    "body": {
      "workflowItemId": "item-321"
    }
  }
}

Response

Upon successful uninstallation trigger, the action returns:

• Uninstallation status
• Execution ID
• Software removal details
• Callback confirmation (if webhook configured)

Fetch script details

Retrieves detailed information about a specific automation script from the IT Automation library. The Agent can leverage this action to get script metadata, parameters, and configuration details before execution.

Input Parameters

Here are the input parameters required to set up this action:

Mandatory

Here is a sample JSON input:

{
  "scriptId": "script-disk-cleanup-001"
}

Response

Upon successful retrieval, the action returns:

• Script ID
• Script name
• Script description
• Required variables/parameters
• Supported operating systems
• Script content details
• Last modified timestamp

Fetch software details

Retrieves detailed information about a specific software package from the IT Automation catalog. The Agent can leverage this action to get software metadata, version information, and deployment requirements before installation.

Input Parameters

Here are the input parameters required to set up this action:

Mandatory

Here is a sample JSON input:

{
  "softwareId": "software-office365-001"
}

Response

Upon successful retrieval, the action returns:

• Software ID
• Software name
• Software version
• Description
• Supported operating systems
• Installation requirements
• Content variables
• Last modified timestamp