Test with the Alexa Simulator
You can test your skill without a device by using the Alexa simulator in the Alexa developer console. The simulator maintains the skill session with your skill so that you can test the entire skill flow. You can use voice or text to interact with your custom or smart home skill. To preview your Alexa Presentation Language (APL) experiences across a variety of device shapes, use the simulator to render APL responses. You can save the simulator session to a file and reply the session at a later time.
For details about other simulation tools, see the following references:
Before you test a skill in the simulator, you must meet the following prerequisites:
- (For custom skills only) Build your interaction model without errors.
- Configure a valid endpoint and deploy your skill code to your endpoint.
- Enable your skill for testing.
- (For smart home and video skills) Before you start testing, enable the skill in the Alexa app and complete any required information.
Simulator testing options
The following simulator testing options are available:
- Skill I/O – (For custom skills only) To view the JSON request and response payloads Alexa sends for each turn of the interaction. Click a speech bubble to see the JSON related to that turn.
- Device Display – To see an approximation of how the skill displays on devices with screens. For details about testing APL skills in the simulator, see Test APL Skills in the Developer Console Simulator.
- Device Log – (For custom skills only) To see the events sent to Alexa and the directives sent to the device during the skill interactions. For details, see Intent Debugging.
- Personalization – For custom skills that include personalization features, to create user profiles to test different permission configurations and toggle consent.
- Alexa Smart Home (Beta) – (For smart home skills only) To see the
ChangeReportevents that the skill sends to the Alexa event gateway. For more details, see Debug Your Smart Home Skill.
Use the simulator in the developer console
The simulator is available on the Test page of the developer console. In the simulator pane, you can use voice or text to interact with your skill. In the viewing pane, you can see the results of the simulation based on the testing options that you select.
The following diagram shows a simulation with the Skill I/O and Device Display options selected.
Test your skill with the simulator
Complete the following steps to test your skill in the simulator. You can use voice or text to interact with your skill.
To open the developer console simulator
- Sign in to the Alexa developer console.
- From the skill list, locate your skill, and then, in the dropdown under ACTIONS, select Edit.
- Open the Test page.
- To test with voice, in the Will you allow developer.amazon.com to use your microphone? pop-up, select Allow.
- If you have already enabled testing, the console shows Skill testing is enabled in. From the drop-down list, select Development or Live for your skill testing stage.
- To display the simulator, click the Alexa Simulator tab.
- Enable the simulator options applicable to your skill type.
- To choose the language to test, in the drop down, select the language.
- In the simulator pane, type your test utterances.
Or, to use voice, click and hold the microphone, and then speak your test utterances.
- If you enabled Skill I/O, you can view the JSON input and output in the Skill Invocations pane.
- If you enabled Device Display, to see how the content looks on a device with a screen, scroll down past the Skill Invocations section.
To change the display size, select a device from the drop-down.
- If you enabled Device Log, to view the directives and events, scroll down to the Device Log pane.
When you test a custom skill with the simulator, the
context.System.device.supportedInterfaces property reflects the interfaces that you selected on the Custom > Interfaces page. For example, if you selected AudioPlayer and Alexa Presentation Language, a request sent to your skill from the simulator includes the following
context object that indicates the request came from a device that supports both interfaces:
The following limitations apply to voice and text testing in the simulator.
|Alexa simulator support
The simulator doesn't render the audio playback, but the Skill I/O section shows the
Because the playback doesn't occur, you can't test
When you type test utterances, don't use date abbreviations, such as "4/15/2019." Instead, write out the date as you would say it. For example, the following phrases generate a valid date in a date slot:
Typed values, such as "2019-04-15," "4/15/2019," and "4/15" don't resolve to dates.
For more examples of the spoken forms that
The Device Address API lets you request address information associated with a user device. When testing with the Alexa Simulator, your skill can call the Device Address API and get back a non-error response. You can also test the flow when the user has not provided the device address permission.
However, note that the address fields in the response are set to
The Test page cannot be configured as a full device in the Alexa app.
You can test skills that use the
The simulator doesn't support testing Flash Briefing skills.
With Location Services, your skill can request dynamic location information associated with the user's device. When testing with the Alexa Simulator, your skill can test the flow when the user has not provided location services permission.
However, the simulator cannot test the case where the customer has granted permission.
The Test page cannot be configured as a full device in the Alexa app.
Alexa sends these requests to a skill when a user interacts with controls, such as a remote control. You can't test these requests with the simulator.
The simulator plays the progressive response and the full response in the same audio stream when the full response is ready. This means that you hear the progressive response followed by the full response.
The simulator doesn't provide the reminders expected from the skill.
The simulator doesn't re-prompt the user after the interaction is over, as Alexa devices do.
In general, Alexa Settings API allows you to retrieve the time zone, distance measurement unit, and temperature measurement unit from the Alexa settings for a user. However, if you attempt to query the Alexa Settings API by using the
The smart home live debugger is in beta and is subject to change at any time without notice. For more details, see Debug Your Smart Home Skill.
The simulator doesn't render the video playback, but the Skill I/O section shows the
The simulator doesn't support testing the Alexa.Presentation.HTML interface and the Alexa Web API for Games.
Devices with character displays
You can test the skill, but the simulator doesn't show how the response looks on a character display, such as the Echo Dot with clock.
In the simulator, the Device Log shows the
consideredIntents returned in the JSON response to list the intents that Alexa considered and discarded. You can use this information to perform intent debugging and determine how to use additional samples to train your model to resolve utterances to their intended intents and slots.
- Test and Debug Your Skill
- Submit Skills for Certification in the Alexa Developer Console
- Certify and Publish Your Skill
Was this page helpful?
Last updated: Jan 26, 2024