Skill Runner

The Misty Skill Runner web tool is a graphic interface for some of the skill-management actions that you would otherwise need to handle via a REST client. Use the Skill Runner to install, start, stop, and delete JavaScript and .NET skills.

Skill runner home page

Setting up Skill Runner

When using Skill Runner, make sure your computer and Misty are connected to the same Wi-Fi network. Follow these steps to connect Misty to Skill Runner:

  1. Open Skill Runner in a new browser window.
  2. Enter Misty's IP address in the Robot IP Address field at the top of the page and select Connect.

When Misty connects, the text on the button displays Connected and the Manage section populates with the skills currently installed on your robot.

Viewing Debug Messages (and Other Skill Data)

When Misty connects to Skill Runner, the web page subscribes to SkillData events through a WebSocket connection to Misty. SkillData event messages include debug messages, error messages, and other data on-robot skills publish during skill execution. When you run a skill from the Skill Runner page, these messages print to the console in your web browser.

Skill Runner web console

We recommend using Skill Runner in Chrome browsers for best results. To open the web console in Chrome, use:

  • Ctrl + Shift + J (Windows/Linux)
  • Cmd + Option + J (Mac)

Installing Skills with Skill Runner

Use the Install interface to install and update JavaScript or .NET skills.

Skill Runner Install Interface

Uploading a JavaScript Skill

To upload a JavaScript skill:

  1. Make sure your robot is powered on, fully-booted, and connected to the same Wi-Fi network as your computer.
  2. Open the Skill Runner web page and connect to your robot using the IP address provided by the Misty App.
  3. Select JavaScript from the Install section.
  4. Drag-and-drop your skill files onto the Install box, or click the box to find the files in your computer's file system.
  5. The Skill Runner web page displays a message when the upload is complete. You can then start, stop, or delete your skill from the Manage section.

Skill Runner install animation

Important! When you install a new skill on Misty, you must upload the JavaScript code file and the JSON meta file at the same time. You can upload image and audio assets associated with a skill by including these asset files when you upload the skill.

To update the code for an existing skill, or to associate new image and audio assets with that skill, upload the new or changed files to Misty along with the JSON meta file for the skill. Misty uses the meta file to identify which existing skill the new files belong to.

Note: When updating an existing skill, make sure the JavaScript code file and the JSON meta file you upload use the same name as the original skill files.

Uploading a .NET Skill

To install a .NET skill using the Skill Runner web page, you must have access to the skill's app package. Follow these steps to create the app package. Then, use the instructions below to upload the app package to your robot.

  1. If you haven't done so already, compress the entire app package directory into a .zip file.
  2. Make sure your robot is powered on, fully-booted, and connected to the same Wi-Fi network as your computer.
  3. Open the Skill Runner web page and connect to your robot using the IP address provided by the Misty App.
  4. Select .NET from the Install section.
  5. Drag-and-drop the .zip file with the app package onto the Install box, or click the box to find the file in your computer's file system.
  6. When prompted, enter the credentials for accessing Misty's Windows Device Portal. These credentials are printed on the bottom of your robot, and are the same as the credentials used when connecting to Misty's file system.
  7. Wait for the skill to upload. For .NET skills, this can take several seconds.
  8. The Skill Runner web page displays a message when the upload is complete. You can then start, stop, or delete your skill from the Manage section.

Generating a JSON Meta File

You can use the Skill Runner to generate JSON meta files for your skills. The Skill Runner Generate interface automatically populates various fields in the meta file and associates a randomized 128 bit GUID with the UniqueID parameter. For more information about meta files, see JavaScript SDK Architecture.

Skill Runner Generate animation

To generate a meta template for your skill:

  1. Enter your skill's name.
  2. Choose Display to view the file's contents in a modal on the Skill Runner page, or choose Download to download the .json file to your computer.
  3. Click Generate JSON Meta Template.

Starting, Stopping, and Deleting Skills

Use the Manage interface to start, stop, and uninstall Misty's skills. The Manage section automatically populates with a list of the skills on your robot when you connect Misty to the Skill Runner page.

Skill Runner manage interface

Tip: In the Manage section, each skill installed on the connected robot is labeled with either JS or C#. This label indicates whether the skill was built with Misty's JavaScript SDK or her .NET SDK.

Starting a Skill

To start a skill, select the Start button next to the skill's name.

Start a skill

Stopping a Skill

When a skill is running, the Start button turns red and displays Stop. Click this button to stop the skill.

Stop a skill

Uninstalling a Skill

To uninstall a skill, select the Delete button next to the skill's name.

Uninstall a skill

Note: When you delete a .NET skill, the Skill Runner asks you for the credentials used to access Misty's Windows Device Portal. These credentials are printed on the bottom of your robot, and are the same as the credentials used when connecting to Misty's file system.

Advanced Options

To view the Advanced Options for a skill, select the Advanced Options button.

Advanced Options Button

You can use the advanced options interface to start a skill with additional parameters that aren't specified in the skill's meta file, or to send a user event with a specific payload to the skill.

Advanced Options Modal