Skip to content

Commit 279b992

Browse files
committed
Add updated content to Japanese docs
1 parent 28debdc commit 279b992

10 files changed

+1033
-269
lines changed

docs/en/DEVELOPING_YOUR_FIRST_SKILL.rst

Lines changed: 27 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -54,8 +54,8 @@ The functionality of these is identical and you can use **either**.
5454
Exception handlers
5555
~~~~~~~~~~~~~~~~~~
5656

57-
Sometimes things go wrong, and your skill code needs a way to handle the problem
58-
gracefully. The ASK SDK for Python supports exception handling in a similar way
57+
Sometimes things go wrong, and your skill code needs a way to handle the problem
58+
gracefully. The ASK SDK for Python supports exception handling in a similar way
5959
to handling requests. You have a choice of using `classes <#option-1-implementation-using-classes>`_ or `decorators <#option-2-implementation-using-decorators>`_.
6060
The following implementation sections explore how to implement exception handling.
6161

@@ -189,7 +189,7 @@ previous handler.
189189
return handler_input.response_builder.response
190190
191191
Similar to the previous handler, this handler matches an IntentRequest with
192-
the expected intent name. Basic help instructions are returned, and ``.ask(speech_text)``
192+
the expected intent name. Basic help instructions are returned, and ``.ask(speech_text)``
193193
causes the user's microphone to open up for the user to respond.
194194

195195
CancelAndStopIntent handler
@@ -274,6 +274,19 @@ previous handler.
274274
Creating the Lambda handler
275275
~~~~~~~~~~~~~~~~~~~~~~~~~~~
276276

277+
.. note::
278+
279+
For a custom skill, you can host your service in AWS Lambda or
280+
as a web service hosted on your own endpoint.
281+
282+
Generally, hosting the skill code on AWS Lambda is the easiest way.
283+
The below sections provide information on how to achieve this.
284+
285+
However, if you wish to host it with any other cloud hosting provider,
286+
the SDK provides some support packages (``ask-sdk-webservice-support``,
287+
``flask-ask-sdk``, ``django-ask-sdk``). You can find more information
288+
on this configuration `here <WEBSERVICE_SUPPORT.html>`__.
289+
277290
The `Lambda handler <https://docs.aws.amazon.com/lambda/latest/dg/python-programming-model-handler-types.html>`_
278291
is the entry point for your AWS Lambda function. The following code example
279292
creates a Lambda handler function to route all inbound requests to your skill.
@@ -391,7 +404,7 @@ previous handler.
391404
return handler_input.response_builder.response
392405
393406
Similar to the previous handler, this handler matches an IntentRequest with
394-
the expected intent name. Basic help instructions are returned, and ``.ask(speech_text)``
407+
the expected intent name. Basic help instructions are returned, and ``.ask(speech_text)``
395408
causes the user's microphone to open up for the user to respond.
396409

397410

@@ -496,7 +509,7 @@ the previous handler.
496509
.. code-block:: python
497510
498511
handler = sb.lambda_handler()
499-
512+
500513
When using decorators, your request handlers and exception handlers are
501514
automatically recognized by the Skill Builder object instantiated at
502515
the top of the code.
@@ -658,15 +671,15 @@ the skill with Alexa.
658671

659672
* Next, configure the endpoint for the skill. To do this, follow these steps:
660673

661-
1. Under your skill, click the **Endpoint** tab, select AWS Lambda ARN,
674+
1. Under your skill, click the **Endpoint** tab, select AWS Lambda ARN,
662675
and copy the **Skill ID** of the skill you just created.
663676
2. Open the AWS Developer Console in a new tab.
664677
3. Navigate to the AWS Lambda function created in the previous step.
665-
4. From the **Designer** menu, add the **Alexa Skills Kit** trigger menu, and
666-
scroll down to paste the skill ID into the **Skill ID Verification** configuration.
678+
4. From the **Designer** menu, add the **Alexa Skills Kit** trigger menu, and
679+
scroll down to paste the skill ID into the **Skill ID Verification** configuration.
667680
Click **Add and save** once completed to update the AWS Lambda function.
668-
5. Copy the AWS Lambda function **ARN** from the top right corner of the page.
669-
An ARN is a unique resource number that helps Alexa service identify the
681+
5. Copy the AWS Lambda function **ARN** from the top right corner of the page.
682+
An ARN is a unique resource number that helps Alexa service identify the
670683
AWS Lambda function it needs to call during skill invocation.
671684
6. Navigate to the Alexa Skills Kit Developer Console, and click on your
672685
**HelloWorld** skill.
@@ -676,18 +689,18 @@ the skill with Alexa.
676689
Click **Save Endpoints**.
677690
9. Click **Invocation** tab, save and build the model.
678691

679-
* At this point you can test the skill. In the top navigation, click **Test**.
692+
* At this point you can test the skill. In the top navigation, click **Test**.
680693
Make sure that the **Test is enabled for this skill**
681694
option is enabled. You can use the Test page to simulate requests, in text
682695
and voice form.
683696

684-
* Use the invocation name along with one of the sample utterances as a guide.
697+
* Use the invocation name along with one of the sample utterances as a guide.
685698
For example, *tell greeter to say hello* should result
686699
in your skill responding with “Hello World” voice and "Hello World" card on
687-
devices with display. You can also open the Alexa app on your phone or at
700+
devices with display. You can also open the Alexa app on your phone or at
688701
https://alexa.amazon.com) and see your skill listed under **Your Skills**.
689702

690703
* Feel free to start experimenting with your intents as well as
691704
the corresponding request handlers in your skill's code. Once you're finished
692-
iterating, optionally move on to getting your skill certified and published
705+
iterating, optionally move on to getting your skill certified and published
693706
so it can be used by customers worldwide.

docs/en/models/ask_sdk_model.interfaces.alexa.presentation.apl.rst

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -190,6 +190,13 @@ ask\_sdk\_model.interfaces.alexa.presentation.apl.speak\_list\_command module
190190
:members:
191191
:show-inheritance:
192192

193+
ask\_sdk\_model.interfaces.alexa.presentation.apl.set\_value\_command module
194+
----------------------------------------------------------------------------
195+
196+
.. automodule:: ask_sdk_model.interfaces.alexa.presentation.apl.set_value_command
197+
:members:
198+
:show-inheritance:
199+
193200
ask\_sdk\_model.interfaces.alexa.presentation.apl.video\_source module
194201
----------------------------------------------------------------------
195202

0 commit comments

Comments
 (0)