Skip to main content

Robots

Learn how to manage robots

The robots page displays your workspace's robots, the authentication token of your robots, the type of the robot and the connection status of the robot.

Robots List

You can create and delete your workspace robots on this page. You can also edit, force stop, generate/regenerate or revoke authentication tokens, and inject a vault secret key to your robots.

Add Robot

You can add a new robot by clicking the "Add Robot" button on the top right. You have to give your robot a unique name that is not present in your workspace and select the type of the robot.

Robot creation will be successful unless you reached the robot limit according to your Robomotion license.

Actions

You can manage a workspace robot by clicking the icon on the Actions column for the corresponding row.

Robot Actions

Edit Robot

You can edit your workspace robots by clicking the "Edit" action. It will automatically open a popup screen where you can rename the robot and add robot labels which will be discussed in the following section.

Update Robot

You can add robot tags by clicking the "New" button in the "Labels" section. It will create an empty label field in which you can fill a key-value pair.

Add Label

You can confirm the label addition by pressing Enter key on your keyboard or clicking the "OK" button on your screen. You can also delete previously created labels or discard new labels by clicking a button inside the label.

Force Stop

You can stop your running robot forcibly by clicking the "Force Stop" action. A corresponding signal will be sent to your robot and be stopped running immediately.

Generate Token

You can generate access tokens for your workspace robots by clicking the "Generate Token" action. These tokens can be used instead of user authentication while connecting the robots to your workspace.

warning

For security purposes, generated tokens will be displayed only once after their creation. If you refresh the page, you will only see the generation time of the access token.

Robot with Token

A robot connected with an access token will not be listed in the Robomotion Designer, but it will be displayed as connected on this page. That is why these robots can be used for only scheduled flows as long as they are connected with only the token.

info

To use a robot connected with a robot token from Flow Designer, you should add "-i" parameter with a user email on your workspace when you set up your operating system service. This associates the connected robot with a user.

Regenerate Token

In case of as forgotten access token, you can generate a new one by clicking the "Regenerate Token" action, and it will make the previous token invalid.

Robot Token Generated

Revoke Token

You can remove an access token by clicking the "Revoke Token" action.

warning

For security purposes, it is highly recommended to revoke the tokens that is not used actively.

Revoke Token

Inject Vault Secret

To run a flow that is using a vault item, the vault secret key of the vault has to be provided to the machine where the robot is currently running on. For detailed information, please navigate to the following section.

In addition to providing the vault secret key manually as described in the linked section, you can also inject the secret key through Admin Console by clicking the "Inject Vault Secret" action. This process will be available only for the robots connected and should be repeated for each different machine where the robot is installed since vault secret keys are stored locally on a machine.

Enter your workspace password to inject a vault secret key.

Inject Vault Password

Select the Vault and enter the vault's secret key.

Inject Vault Secret

After submitting the values you should see a notification below:

Vault Secret Success

info

Vault Secret injection should be done for every user if the robot is connected with user credentials. If the robot is connected with a robot user with a robot id and robot token, the injection should be repeated for every different installed machine once.