Create a Desktop action parameter record

Create a Desktop action parameter record to store a name that an AI agent references when accessing credentials or other values during desktop action execution.

Before you begin

Perform this task in the ServiceNow instance.

For SSH connector desktop actions, verify that you have an active SSH server.

Role required: sn_aia.admin

About this task

Parameter records are supported for on-screen tasks and SSH background tasks. Use them to replace fixed values with configured ones for on-screen tasks and username and password for SSH.

Procedure

1. Navigate to All > AI Desktop Actions > Desktop Action Parameters.
2. Select New.
3. Fill in the following fields.

   Table 1. Desktop action parameter fields

   Field	Description
   Name	Enter a unique name for the parameter. The AI agent references this name when retrieving the stored value. For example, un_username_group or un_password_group.
   Description	Enter a description of what value this parameter stores.
   Shared	Option to make this parameter available to all users. When selected, only one Desktop action parameter value record can be created under this parameter, and only a user with the sn_aia.admin role can create it. During execution, the AI agent uses this single value regardless of which user triggered the agent.
   Mark As Sensitive	Option to encrypt all associated Desktop action parameter value records. The agent decrypts the value at execution time.

   Important:

   Shared and Mark As Sensitive can only be edited when there are no associated parameter value records.

4. Select Submit.

Result

The Desktop action parameter record is created and appears in the Desktop Action Parameters list. You can now create Desktop action parameter value records under this parameter. For more information, see Create a parameter value record.