Announcement: The Alexa Skills Community Is Moving To Stack Overflow

For improved usability and experience, Alexa skills related forum support will be transitioned to Stack Overflow. Effective January 10, 2024, the Amazon Developer Forums will no longer be available. For continued Alexa skills support you can reach out to us on Stack Overflow or via Contact Us.

question

aholmes0 avatar image
aholmes0 asked

Better debugging output and debug tooling

Unless I missed something, it appears we are limited to messages such as "There was a problem communicating with the requested application" when debugging our applications, and something goes awry. Are there plans to provide more detailed feedback about what specifically happened when communicating? Even a "raw" dump of data is better than "an error occurred." I can't imagine going through with publishing an app, only to end up in a situation where we can't debug any issues that may come up. How about debug and testing tooling? It would be quite convenient if we were able to "simulate" an Echo making requests, among other things.
alexa skills kit
10 |5000

Up to 2 attachments (including images) can be used with a maximum of 512.0 KiB each and 1.0 MiB total.

Jeff Capron avatar image
Jeff Capron answered
I agree. At least a way to get the raw output that the device is seeing.
10 |5000

Up to 2 attachments (including images) can be used with a maximum of 512.0 KiB each and 1.0 MiB total.

Noel Portugal avatar image
Noel Portugal answered
Hey guys I use runscope for this ( https://www.runscope.com/) Just plugin your endpoint and use runscope's url at your dev application endpoint. It works like a charm. You will be able to see Header/Body info from the request as well as your Response.
10 |5000

Up to 2 attachments (including images) can be used with a maximum of 512.0 KiB each and 1.0 MiB total.

rgr@amazon avatar image
rgr@amazon answered
Jeff, ahomes0 Thank you very much for your feedback, Our current debugging story includes, a message from the Echo Device as mention above, as well as, a publish GUI card in the companion application with some details about what went wrong, we are aware of the need for better debugging and is improving this story as we progress in making the Echo SDK better. Again, thank you very much for the feedback and please let us know how the GUI cards are working for you from a debugging standpoint.
10 |5000

Up to 2 attachments (including images) can be used with a maximum of 512.0 KiB each and 1.0 MiB total.

aholmes0 avatar image
aholmes0 answered
Hi, of course. Here's some follow-up information. In one problem example, I did not capitalize the "s" in "Simple" for a card response. Thankfully I saw this right away and corrected it, but the feedback I received from the Echo was quite limited, and I can imagine it may not always be so simple to debug. The spoken text I got back from the Echo was "There was a problem communicating with the requested application," and the card was "Unexpected Communication Issue - There was a problem communicating with the requested application." Really, these could mean anything. Did my application return a 500 error? Was Amazon able to reach my API endpoint? Did my application send a malformed response? Did the user request an intent that caused some odd problem? In the case of my "simple" versus "Simple" issue, a card that showed something like "Unexpected card type "simple" was specified. Valid card types are "Simple," "Standard," "Media"" Another card I've received is "Protocol Violation." It would help to know what, exactly, my application sent back that Amazon didn't expect. Protocol Violation The application response did conform to the specification. Please ensure that you are using the latest client library and that your responses comply with the Application Service Interface. Could be followed up by some information on what lines or strings in the JSON response were unexpected. While the suggestion by @Noel is something all of us should be capable of doing, it might still be helpful to include HTTP headers and bodies in the debugging cards by default anyway (or perhaps by sending a "debug:true" variable in the response).
10 |5000

Up to 2 attachments (including images) can be used with a maximum of 512.0 KiB each and 1.0 MiB total.

aholmes0 avatar image
aholmes0 answered
Oh, and just really quickly, to more directly answer how the cards are helping with my debugging - the answer is they aren't providing anymore information than telling me an error occurred. Something more is needed for sure. :)
10 |5000

Up to 2 attachments (including images) can be used with a maximum of 512.0 KiB each and 1.0 MiB total.

rgr@amazon avatar image
rgr@amazon answered
aholmes0, This is very very valuable feedback, those are great examples of ways we can improve the developer experience, Thank you very much for this feedback, we will incorporate your feedback as we progress on making improvements to the Echo SDK. Stay tuned!
10 |5000

Up to 2 attachments (including images) can be used with a maximum of 512.0 KiB each and 1.0 MiB total.