Amazon Lex Model Building V2

2021/08/05 - Amazon Lex Model Building V2 - 6 updated api methods

Changes  Customers can now toggle the active field on prompts and responses.

CreateIntent (updated) Link ΒΆ
Changes (both)
{'intentClosingSetting': {'active': 'boolean'},
 'intentConfirmationSetting': {'active': 'boolean'}}

Creates an intent.

To define the interaction between the user and your bot, you define one or more intents. For example, for a pizza ordering bot you would create an OrderPizza intent.

When you create an intent, you must provide a name. You can optionally provide the following:

  • Sample utterances. For example, "I want to order a pizza" and "Can I order a pizza." You can't provide utterances for built-in intents.

  • Information to be gathered. You specify slots for the information that you bot requests from the user. You can specify standard slot types, such as date and time, or custom slot types for your application.

  • How the intent is fulfilled. You can provide a Lambda function or configure the intent to return the intent information to your client application. If you use a Lambda function, Amazon Lex invokes the function when all of the intent information is available.

  • A confirmation prompt to send to the user to confirm an intent. For example, "Shall I order your pizza?"

  • A conclusion statement to send to the user after the intent is fulfilled. For example, "I ordered your pizza."

  • A follow-up prompt that asks the user for additional activity. For example, "Do you want a drink with your pizza?"

See also: AWS API Documentation

Request Syntax

client.create_intent(
    intentName='string',
    description='string',
    parentIntentSignature='string',
    sampleUtterances=[
        {
            'utterance': 'string'
        },
    ],
    dialogCodeHook={
        'enabled': True|False
    },
    fulfillmentCodeHook={
        'enabled': True|False
    },
    intentConfirmationSetting={
        'promptSpecification': {
            'messageGroups': [
                {
                    'message': {
                        'plainTextMessage': {
                            'value': 'string'
                        },
                        'customPayload': {
                            'value': 'string'
                        },
                        'ssmlMessage': {
                            'value': 'string'
                        },
                        'imageResponseCard': {
                            'title': 'string',
                            'subtitle': 'string',
                            'imageUrl': 'string',
                            'buttons': [
                                {
                                    'text': 'string',
                                    'value': 'string'
                                },
                            ]
                        }
                    },
                    'variations': [
                        {
                            'plainTextMessage': {
                                'value': 'string'
                            },
                            'customPayload': {
                                'value': 'string'
                            },
                            'ssmlMessage': {
                                'value': 'string'
                            },
                            'imageResponseCard': {
                                'title': 'string',
                                'subtitle': 'string',
                                'imageUrl': 'string',
                                'buttons': [
                                    {
                                        'text': 'string',
                                        'value': 'string'
                                    },
                                ]
                            }
                        },
                    ]
                },
            ],
            'maxRetries': 123,
            'allowInterrupt': True|False
        },
        'declinationResponse': {
            'messageGroups': [
                {
                    'message': {
                        'plainTextMessage': {
                            'value': 'string'
                        },
                        'customPayload': {
                            'value': 'string'
                        },
                        'ssmlMessage': {
                            'value': 'string'
                        },
                        'imageResponseCard': {
                            'title': 'string',
                            'subtitle': 'string',
                            'imageUrl': 'string',
                            'buttons': [
                                {
                                    'text': 'string',
                                    'value': 'string'
                                },
                            ]
                        }
                    },
                    'variations': [
                        {
                            'plainTextMessage': {
                                'value': 'string'
                            },
                            'customPayload': {
                                'value': 'string'
                            },
                            'ssmlMessage': {
                                'value': 'string'
                            },
                            'imageResponseCard': {
                                'title': 'string',
                                'subtitle': 'string',
                                'imageUrl': 'string',
                                'buttons': [
                                    {
                                        'text': 'string',
                                        'value': 'string'
                                    },
                                ]
                            }
                        },
                    ]
                },
            ],
            'allowInterrupt': True|False
        },
        'active': True|False
    },
    intentClosingSetting={
        'closingResponse': {
            'messageGroups': [
                {
                    'message': {
                        'plainTextMessage': {
                            'value': 'string'
                        },
                        'customPayload': {
                            'value': 'string'
                        },
                        'ssmlMessage': {
                            'value': 'string'
                        },
                        'imageResponseCard': {
                            'title': 'string',
                            'subtitle': 'string',
                            'imageUrl': 'string',
                            'buttons': [
                                {
                                    'text': 'string',
                                    'value': 'string'
                                },
                            ]
                        }
                    },
                    'variations': [
                        {
                            'plainTextMessage': {
                                'value': 'string'
                            },
                            'customPayload': {
                                'value': 'string'
                            },
                            'ssmlMessage': {
                                'value': 'string'
                            },
                            'imageResponseCard': {
                                'title': 'string',
                                'subtitle': 'string',
                                'imageUrl': 'string',
                                'buttons': [
                                    {
                                        'text': 'string',
                                        'value': 'string'
                                    },
                                ]
                            }
                        },
                    ]
                },
            ],
            'allowInterrupt': True|False
        },
        'active': True|False
    },
    inputContexts=[
        {
            'name': 'string'
        },
    ],
    outputContexts=[
        {
            'name': 'string',
            'timeToLiveInSeconds': 123,
            'turnsToLive': 123
        },
    ],
    kendraConfiguration={
        'kendraIndex': 'string',
        'queryFilterStringEnabled': True|False,
        'queryFilterString': 'string'
    },
    botId='string',
    botVersion='string',
    localeId='string'
)
type intentName

string

param intentName

[REQUIRED]

The name of the intent. Intent names must be unique in the locale that contains the intent and cannot match the name of any built-in intent.

type description

string

param description

A description of the intent. Use the description to help identify the intent in lists.

type parentIntentSignature

string

param parentIntentSignature

A unique identifier for the built-in intent to base this intent on.

type sampleUtterances

list

param sampleUtterances

An array of strings that a user might say to signal the intent. For example, "I want a pizza", or "I want a {PizzaSize} pizza".

In an utterance, slot names are enclosed in curly braces ("{", "}") to indicate where they should be displayed in the utterance shown to the user..

  • (dict) --

    A sample utterance that invokes an intent or respond to a slot elicitation prompt.

    • utterance (string) -- [REQUIRED]

      The sample utterance that Amazon Lex uses to build its machine-learning model to recognize intents.

type dialogCodeHook

dict

param dialogCodeHook

Specifies that Amazon Lex invokes the alias Lambda function for each user input. You can invoke this Lambda function to personalize user interaction.

For example, suppose that your bot determines that the user's name is John. You Lambda function might retrieve John's information from a backend database and prepopulate some of the values. For example, if you find that John is gluten intolerant, you might set the corresponding intent slot, glutenIntolerant to true . You might find John's phone number and set the corresponding session attribute.

  • enabled (boolean) -- [REQUIRED]

    Enables the dialog code hook so that it processes user requests.

type fulfillmentCodeHook

dict

param fulfillmentCodeHook

Specifies that Amazon Lex invokes the alias Lambda function when the intent is ready for fulfillment. You can invoke this function to complete the bot's transaction with the user.

For example, in a pizza ordering bot, the Lambda function can look up the closest pizza restaurant to the customer's location and then place an order on the customer's behalf.

  • enabled (boolean) -- [REQUIRED]

    Indicates whether a Lambda function should be invoked to fulfill a specific intent.

type intentConfirmationSetting

dict

param intentConfirmationSetting

Provides prompts that Amazon Lex sends to the user to confirm the completion of an intent. If the user answers "no," the settings contain a statement that is sent to the user to end the intent.

  • promptSpecification (dict) -- [REQUIRED]

    Prompts the user to confirm the intent. This question should have a yes or no answer.

    Amazon Lex uses this prompt to ensure that the user acknowledges that the intent is ready for fulfillment. For example, with the OrderPizza intent, you might want to confirm that the order is correct before placing it. For other intents, such as intents that simply respond to user questions, you might not need to ask the user for confirmation before providing the information.

    • messageGroups (list) -- [REQUIRED]

      A collection of messages that Amazon Lex can send to the user. Amazon Lex chooses the actual message to send at runtime.

      • (dict) --

        Provides one or more messages that Amazon Lex should send to the user.

        • message (dict) -- [REQUIRED]

          The primary message that Amazon Lex should send to the user.

          • plainTextMessage (dict) --

            A message in plain text format.

            • value (string) -- [REQUIRED]

              The message to send to the user.

          • customPayload (dict) --

            A message in a custom format defined by the client application.

            • value (string) -- [REQUIRED]

              The string that is sent to your application.

          • ssmlMessage (dict) --

            A message in Speech Synthesis Markup Language (SSML).

            • value (string) -- [REQUIRED]

              The SSML text that defines the prompt.

          • imageResponseCard (dict) --

            A message that defines a response card that the client application can show to the user.

            • title (string) -- [REQUIRED]

              The title to display on the response card. The format of the title is determined by the platform displaying the response card.

            • subtitle (string) --

              The subtitle to display on the response card. The format of the subtitle is determined by the platform displaying the response card.

            • imageUrl (string) --

              The URL of an image to display on the response card. The image URL must be publicly available so that the platform displaying the response card has access to the image.

            • buttons (list) --

              A list of buttons that should be displayed on the response card. The arrangement of the buttons is determined by the platform that displays the button.

              • (dict) --

                Describes a button to use on a response card used to gather slot values from a user.

                • text (string) -- [REQUIRED]

                  The text that appears on the button. Use this to tell the user what value is returned when they choose this button.

                • value (string) -- [REQUIRED]

                  The value returned to Amazon Lex when the user chooses this button. This must be one of the slot values configured for the slot.

        • variations (list) --

          Message variations to send to the user. When variations are defined, Amazon Lex chooses the primary message or one of the variations to send to the user.

          • (dict) --

            The object that provides message text and it's type.

            • plainTextMessage (dict) --

              A message in plain text format.

              • value (string) -- [REQUIRED]

                The message to send to the user.

            • customPayload (dict) --

              A message in a custom format defined by the client application.

              • value (string) -- [REQUIRED]

                The string that is sent to your application.

            • ssmlMessage (dict) --

              A message in Speech Synthesis Markup Language (SSML).

              • value (string) -- [REQUIRED]

                The SSML text that defines the prompt.

            • imageResponseCard (dict) --

              A message that defines a response card that the client application can show to the user.

              • title (string) -- [REQUIRED]

                The title to display on the response card. The format of the title is determined by the platform displaying the response card.

              • subtitle (string) --

                The subtitle to display on the response card. The format of the subtitle is determined by the platform displaying the response card.

              • imageUrl (string) --

                The URL of an image to display on the response card. The image URL must be publicly available so that the platform displaying the response card has access to the image.

              • buttons (list) --

                A list of buttons that should be displayed on the response card. The arrangement of the buttons is determined by the platform that displays the button.

                • (dict) --

                  Describes a button to use on a response card used to gather slot values from a user.

                  • text (string) -- [REQUIRED]

                    The text that appears on the button. Use this to tell the user what value is returned when they choose this button.

                  • value (string) -- [REQUIRED]

                    The value returned to Amazon Lex when the user chooses this button. This must be one of the slot values configured for the slot.

    • maxRetries (integer) -- [REQUIRED]

      The maximum number of times the bot tries to elicit a resonse from the user using this prompt.

    • allowInterrupt (boolean) --

      Indicates whether the user can interrupt a speech prompt from the bot.

  • declinationResponse (dict) -- [REQUIRED]

    When the user answers "no" to the question defined in promptSpecification , Amazon Lex responds with this response to acknowledge that the intent was canceled.

    • messageGroups (list) -- [REQUIRED]

      A collection of responses that Amazon Lex can send to the user. Amazon Lex chooses the actual response to send at runtime.

      • (dict) --

        Provides one or more messages that Amazon Lex should send to the user.

        • message (dict) -- [REQUIRED]

          The primary message that Amazon Lex should send to the user.

          • plainTextMessage (dict) --

            A message in plain text format.

            • value (string) -- [REQUIRED]

              The message to send to the user.

          • customPayload (dict) --

            A message in a custom format defined by the client application.

            • value (string) -- [REQUIRED]

              The string that is sent to your application.

          • ssmlMessage (dict) --

            A message in Speech Synthesis Markup Language (SSML).

            • value (string) -- [REQUIRED]

              The SSML text that defines the prompt.

          • imageResponseCard (dict) --

            A message that defines a response card that the client application can show to the user.

            • title (string) -- [REQUIRED]

              The title to display on the response card. The format of the title is determined by the platform displaying the response card.

            • subtitle (string) --

              The subtitle to display on the response card. The format of the subtitle is determined by the platform displaying the response card.

            • imageUrl (string) --

              The URL of an image to display on the response card. The image URL must be publicly available so that the platform displaying the response card has access to the image.

            • buttons (list) --

              A list of buttons that should be displayed on the response card. The arrangement of the buttons is determined by the platform that displays the button.

              • (dict) --

                Describes a button to use on a response card used to gather slot values from a user.

                • text (string) -- [REQUIRED]

                  The text that appears on the button. Use this to tell the user what value is returned when they choose this button.

                • value (string) -- [REQUIRED]

                  The value returned to Amazon Lex when the user chooses this button. This must be one of the slot values configured for the slot.

        • variations (list) --

          Message variations to send to the user. When variations are defined, Amazon Lex chooses the primary message or one of the variations to send to the user.

          • (dict) --

            The object that provides message text and it's type.

            • plainTextMessage (dict) --

              A message in plain text format.

              • value (string) -- [REQUIRED]

                The message to send to the user.

            • customPayload (dict) --

              A message in a custom format defined by the client application.

              • value (string) -- [REQUIRED]

                The string that is sent to your application.

            • ssmlMessage (dict) --

              A message in Speech Synthesis Markup Language (SSML).

              • value (string) -- [REQUIRED]

                The SSML text that defines the prompt.

            • imageResponseCard (dict) --

              A message that defines a response card that the client application can show to the user.

              • title (string) -- [REQUIRED]

                The title to display on the response card. The format of the title is determined by the platform displaying the response card.

              • subtitle (string) --

                The subtitle to display on the response card. The format of the subtitle is determined by the platform displaying the response card.

              • imageUrl (string) --

                The URL of an image to display on the response card. The image URL must be publicly available so that the platform displaying the response card has access to the image.

              • buttons (list) --

                A list of buttons that should be displayed on the response card. The arrangement of the buttons is determined by the platform that displays the button.

                • (dict) --

                  Describes a button to use on a response card used to gather slot values from a user.

                  • text (string) -- [REQUIRED]

                    The text that appears on the button. Use this to tell the user what value is returned when they choose this button.

                  • value (string) -- [REQUIRED]

                    The value returned to Amazon Lex when the user chooses this button. This must be one of the slot values configured for the slot.

    • allowInterrupt (boolean) --

      Indicates whether the user can interrupt a speech response from Amazon Lex.

  • active (boolean) --

    Specifies whether the intent's confirmation is sent to the user. When this field is false, confirmation and declination responses aren't sent and processing continues as if the responses aren't present. If the active field isn't specified, the default is true.

type intentClosingSetting

dict

param intentClosingSetting

Sets the response that Amazon Lex sends to the user when the intent is closed.

  • closingResponse (dict) -- [REQUIRED]

    The response that Amazon Lex sends to the user when the intent is complete.

    • messageGroups (list) -- [REQUIRED]

      A collection of responses that Amazon Lex can send to the user. Amazon Lex chooses the actual response to send at runtime.

      • (dict) --

        Provides one or more messages that Amazon Lex should send to the user.

        • message (dict) -- [REQUIRED]

          The primary message that Amazon Lex should send to the user.

          • plainTextMessage (dict) --

            A message in plain text format.

            • value (string) -- [REQUIRED]

              The message to send to the user.

          • customPayload (dict) --

            A message in a custom format defined by the client application.

            • value (string) -- [REQUIRED]

              The string that is sent to your application.

          • ssmlMessage (dict) --

            A message in Speech Synthesis Markup Language (SSML).

            • value (string) -- [REQUIRED]

              The SSML text that defines the prompt.

          • imageResponseCard (dict) --

            A message that defines a response card that the client application can show to the user.

            • title (string) -- [REQUIRED]

              The title to display on the response card. The format of the title is determined by the platform displaying the response card.

            • subtitle (string) --

              The subtitle to display on the response card. The format of the subtitle is determined by the platform displaying the response card.

            • imageUrl (string) --

              The URL of an image to display on the response card. The image URL must be publicly available so that the platform displaying the response card has access to the image.

            • buttons (list) --

              A list of buttons that should be displayed on the response card. The arrangement of the buttons is determined by the platform that displays the button.

              • (dict) --

                Describes a button to use on a response card used to gather slot values from a user.

                • text (string) -- [REQUIRED]

                  The text that appears on the button. Use this to tell the user what value is returned when they choose this button.

                • value (string) -- [REQUIRED]

                  The value returned to Amazon Lex when the user chooses this button. This must be one of the slot values configured for the slot.

        • variations (list) --

          Message variations to send to the user. When variations are defined, Amazon Lex chooses the primary message or one of the variations to send to the user.

          • (dict) --

            The object that provides message text and it's type.

            • plainTextMessage (dict) --

              A message in plain text format.

              • value (string) -- [REQUIRED]

                The message to send to the user.

            • customPayload (dict) --

              A message in a custom format defined by the client application.

              • value (string) -- [REQUIRED]

                The string that is sent to your application.

            • ssmlMessage (dict) --

              A message in Speech Synthesis Markup Language (SSML).

              • value (string) -- [REQUIRED]

                The SSML text that defines the prompt.

            • imageResponseCard (dict) --

              A message that defines a response card that the client application can show to the user.

              • title (string) -- [REQUIRED]

                The title to display on the response card. The format of the title is determined by the platform displaying the response card.

              • subtitle (string) --

                The subtitle to display on the response card. The format of the subtitle is determined by the platform displaying the response card.

              • imageUrl (string) --

                The URL of an image to display on the response card. The image URL must be publicly available so that the platform displaying the response card has access to the image.

              • buttons (list) --

                A list of buttons that should be displayed on the response card. The arrangement of the buttons is determined by the platform that displays the button.

                • (dict) --

                  Describes a button to use on a response card used to gather slot values from a user.

                  • text (string) -- [REQUIRED]

                    The text that appears on the button. Use this to tell the user what value is returned when they choose this button.

                  • value (string) -- [REQUIRED]

                    The value returned to Amazon Lex when the user chooses this button. This must be one of the slot values configured for the slot.

    • allowInterrupt (boolean) --

      Indicates whether the user can interrupt a speech response from Amazon Lex.

  • active (boolean) --

    Specifies whether an intent's closing response is used. When this field is false, the closing response isn't sent to the user and no closing input from the user is used. If the active field isn't specified, the default is true.

type inputContexts

list

param inputContexts

A list of contexts that must be active for this intent to be considered by Amazon Lex.

When an intent has an input context list, Amazon Lex only considers using the intent in an interaction with the user when the specified contexts are included in the active context list for the session. If the contexts are not active, then Amazon Lex will not use the intent.

A context can be automatically activated using the outputContexts property or it can be set at runtime.

For example, if there are two intents with different input contexts that respond to the same utterances, only the intent with the active context will respond.

An intent may have up to 5 input contexts. If an intent has multiple input contexts, all of the contexts must be active to consider the intent.

  • (dict) --

    The name of a context that must be active for an intent to be selected by Amazon Lex.

    • name (string) -- [REQUIRED]

      The name of the context.

type outputContexts

list

param outputContexts

A lists of contexts that the intent activates when it is fulfilled.

You can use an output context to indicate the intents that Amazon Lex should consider for the next turn of the conversation with a customer.

When you use the outputContextsList property, all of the contexts specified in the list are activated when the intent is fulfilled. You can set up to 10 output contexts. You can also set the number of conversation turns that the context should be active, or the length of time that the context should be active.

  • (dict) --

    Describes a session context that is activated when an intent is fulfilled.

    • name (string) -- [REQUIRED]

      The name of the output context.

    • timeToLiveInSeconds (integer) -- [REQUIRED]

      The amount of time, in seconds, that the output context should remain active. The time is figured from the first time the context is sent to the user.

    • turnsToLive (integer) -- [REQUIRED]

      The number of conversation turns that the output context should remain active. The number of turns is counted from the first time that the context is sent to the user.

type kendraConfiguration

dict

param kendraConfiguration

Configuration information required to use the AMAZON.KendraSearchIntent intent to connect to an Amazon Kendra index. The AMAZON.KendraSearchIntent intent is called when Amazon Lex can't determine another intent to invoke.

  • kendraIndex (string) -- [REQUIRED]

    The Amazon Resource Name (ARN) of the Amazon Kendra index that you want the AMAZON.KendraSearchIntent intent to search. The index must be in the same account and Region as the Amazon Lex bot.

  • queryFilterStringEnabled (boolean) --

    Determines whether the AMAZON.KendraSearchIntent intent uses a custom query string to query the Amazon Kendra index.

  • queryFilterString (string) --

    A query filter that Amazon Lex sends to Amazon Kendra to filter the response from a query. The filter is in the format defined by Amazon Kendra. For more information, see Filtering queries.

type botId

string

param botId

[REQUIRED]

The identifier of the bot associated with this intent.

type botVersion

string

param botVersion

[REQUIRED]

The identifier of the version of the bot associated with this intent.

type localeId

string

param localeId

[REQUIRED]

The identifier of the language and locale where this intent is used. All of the bots, slot types, and slots used by the intent must have the same locale. For more information, see Supported languages.

rtype

dict

returns

Response Syntax

{
    'intentId': 'string',
    'intentName': 'string',
    'description': 'string',
    'parentIntentSignature': 'string',
    'sampleUtterances': [
        {
            'utterance': 'string'
        },
    ],
    'dialogCodeHook': {
        'enabled': True|False
    },
    'fulfillmentCodeHook': {
        'enabled': True|False
    },
    'intentConfirmationSetting': {
        'promptSpecification': {
            'messageGroups': [
                {
                    'message': {
                        'plainTextMessage': {
                            'value': 'string'
                        },
                        'customPayload': {
                            'value': 'string'
                        },
                        'ssmlMessage': {
                            'value': 'string'
                        },
                        'imageResponseCard': {
                            'title': 'string',
                            'subtitle': 'string',
                            'imageUrl': 'string',
                            'buttons': [
                                {
                                    'text': 'string',
                                    'value': 'string'
                                },
                            ]
                        }
                    },
                    'variations': [
                        {
                            'plainTextMessage': {
                                'value': 'string'
                            },
                            'customPayload': {
                                'value': 'string'
                            },
                            'ssmlMessage': {
                                'value': 'string'
                            },
                            'imageResponseCard': {
                                'title': 'string',
                                'subtitle': 'string',
                                'imageUrl': 'string',
                                'buttons': [
                                    {
                                        'text': 'string',
                                        'value': 'string'
                                    },
                                ]
                            }
                        },
                    ]
                },
            ],
            'maxRetries': 123,
            'allowInterrupt': True|False
        },
        'declinationResponse': {
            'messageGroups': [
                {
                    'message': {
                        'plainTextMessage': {
                            'value': 'string'
                        },
                        'customPayload': {
                            'value': 'string'
                        },
                        'ssmlMessage': {
                            'value': 'string'
                        },
                        'imageResponseCard': {
                            'title': 'string',
                            'subtitle': 'string',
                            'imageUrl': 'string',
                            'buttons': [
                                {
                                    'text': 'string',
                                    'value': 'string'
                                },
                            ]
                        }
                    },
                    'variations': [
                        {
                            'plainTextMessage': {
                                'value': 'string'
                            },
                            'customPayload': {
                                'value': 'string'
                            },
                            'ssmlMessage': {
                                'value': 'string'
                            },
                            'imageResponseCard': {
                                'title': 'string',
                                'subtitle': 'string',
                                'imageUrl': 'string',
                                'buttons': [
                                    {
                                        'text': 'string',
                                        'value': 'string'
                                    },
                                ]
                            }
                        },
                    ]
                },
            ],
            'allowInterrupt': True|False
        },
        'active': True|False
    },
    'intentClosingSetting': {
        'closingResponse': {
            'messageGroups': [
                {
                    'message': {
                        'plainTextMessage': {
                            'value': 'string'
                        },
                        'customPayload': {
                            'value': 'string'
                        },
                        'ssmlMessage': {
                            'value': 'string'
                        },
                        'imageResponseCard': {
                            'title': 'string',
                            'subtitle': 'string',
                            'imageUrl': 'string',
                            'buttons': [
                                {
                                    'text': 'string',
                                    'value': 'string'
                                },
                            ]
                        }
                    },
                    'variations': [
                        {
                            'plainTextMessage': {
                                'value': 'string'
                            },
                            'customPayload': {
                                'value': 'string'
                            },
                            'ssmlMessage': {
                                'value': 'string'
                            },
                            'imageResponseCard': {
                                'title': 'string',
                                'subtitle': 'string',
                                'imageUrl': 'string',
                                'buttons': [
                                    {
                                        'text': 'string',
                                        'value': 'string'
                                    },
                                ]
                            }
                        },
                    ]
                },
            ],
            'allowInterrupt': True|False
        },
        'active': True|False
    },
    'inputContexts': [
        {
            'name': 'string'
        },
    ],
    'outputContexts': [
        {
            'name': 'string',
            'timeToLiveInSeconds': 123,
            'turnsToLive': 123
        },
    ],
    'kendraConfiguration': {
        'kendraIndex': 'string',
        'queryFilterStringEnabled': True|False,
        'queryFilterString': 'string'
    },
    'botId': 'string',
    'botVersion': 'string',
    'localeId': 'string',
    'creationDateTime': datetime(2015, 1, 1)
}

Response Structure

  • (dict) --

    • intentId (string) --

      A unique identifier for the intent.

    • intentName (string) --

      The name specified for the intent.

    • description (string) --

      The description specified for the intent.

    • parentIntentSignature (string) --

      The signature of the parent intent specified for the intent.

    • sampleUtterances (list) --

      The sample utterances specified for the intent.

      • (dict) --

        A sample utterance that invokes an intent or respond to a slot elicitation prompt.

        • utterance (string) --

          The sample utterance that Amazon Lex uses to build its machine-learning model to recognize intents.

    • dialogCodeHook (dict) --

      The dialog Lambda function specified for the intent.

      • enabled (boolean) --

        Enables the dialog code hook so that it processes user requests.

    • fulfillmentCodeHook (dict) --

      The fulfillment Lambda function specified for the intent.

      • enabled (boolean) --

        Indicates whether a Lambda function should be invoked to fulfill a specific intent.

    • intentConfirmationSetting (dict) --

      The confirmation setting specified for the intent.

      • promptSpecification (dict) --

        Prompts the user to confirm the intent. This question should have a yes or no answer.

        Amazon Lex uses this prompt to ensure that the user acknowledges that the intent is ready for fulfillment. For example, with the OrderPizza intent, you might want to confirm that the order is correct before placing it. For other intents, such as intents that simply respond to user questions, you might not need to ask the user for confirmation before providing the information.

        • messageGroups (list) --

          A collection of messages that Amazon Lex can send to the user. Amazon Lex chooses the actual message to send at runtime.

          • (dict) --

            Provides one or more messages that Amazon Lex should send to the user.

            • message (dict) --

              The primary message that Amazon Lex should send to the user.

              • plainTextMessage (dict) --

                A message in plain text format.

                • value (string) --

                  The message to send to the user.

              • customPayload (dict) --

                A message in a custom format defined by the client application.

                • value (string) --

                  The string that is sent to your application.

              • ssmlMessage (dict) --

                A message in Speech Synthesis Markup Language (SSML).

                • value (string) --

                  The SSML text that defines the prompt.

              • imageResponseCard (dict) --

                A message that defines a response card that the client application can show to the user.

                • title (string) --

                  The title to display on the response card. The format of the title is determined by the platform displaying the response card.

                • subtitle (string) --

                  The subtitle to display on the response card. The format of the subtitle is determined by the platform displaying the response card.

                • imageUrl (string) --

                  The URL of an image to display on the response card. The image URL must be publicly available so that the platform displaying the response card has access to the image.

                • buttons (list) --

                  A list of buttons that should be displayed on the response card. The arrangement of the buttons is determined by the platform that displays the button.

                  • (dict) --

                    Describes a button to use on a response card used to gather slot values from a user.

                    • text (string) --

                      The text that appears on the button. Use this to tell the user what value is returned when they choose this button.

                    • value (string) --

                      The value returned to Amazon Lex when the user chooses this button. This must be one of the slot values configured for the slot.

            • variations (list) --

              Message variations to send to the user. When variations are defined, Amazon Lex chooses the primary message or one of the variations to send to the user.

              • (dict) --

                The object that provides message text and it's type.

                • plainTextMessage (dict) --

                  A message in plain text format.

                  • value (string) --

                    The message to send to the user.

                • customPayload (dict) --

                  A message in a custom format defined by the client application.

                  • value (string) --

                    The string that is sent to your application.

                • ssmlMessage (dict) --

                  A message in Speech Synthesis Markup Language (SSML).

                  • value (string) --

                    The SSML text that defines the prompt.

                • imageResponseCard (dict) --

                  A message that defines a response card that the client application can show to the user.

                  • title (string) --

                    The title to display on the response card. The format of the title is determined by the platform displaying the response card.

                  • subtitle (string) --

                    The subtitle to display on the response card. The format of the subtitle is determined by the platform displaying the response card.

                  • imageUrl (string) --

                    The URL of an image to display on the response card. The image URL must be publicly available so that the platform displaying the response card has access to the image.

                  • buttons (list) --

                    A list of buttons that should be displayed on the response card. The arrangement of the buttons is determined by the platform that displays the button.

                    • (dict) --

                      Describes a button to use on a response card used to gather slot values from a user.

                      • text (string) --

                        The text that appears on the button. Use this to tell the user what value is returned when they choose this button.

                      • value (string) --

                        The value returned to Amazon Lex when the user chooses this button. This must be one of the slot values configured for the slot.

        • maxRetries (integer) --

          The maximum number of times the bot tries to elicit a resonse from the user using this prompt.

        • allowInterrupt (boolean) --

          Indicates whether the user can interrupt a speech prompt from the bot.

      • declinationResponse (dict) --

        When the user answers "no" to the question defined in promptSpecification , Amazon Lex responds with this response to acknowledge that the intent was canceled.

        • messageGroups (list) --

          A collection of responses that Amazon Lex can send to the user. Amazon Lex chooses the actual response to send at runtime.

          • (dict) --

            Provides one or more messages that Amazon Lex should send to the user.

            • message (dict) --

              The primary message that Amazon Lex should send to the user.

              • plainTextMessage (dict) --

                A message in plain text format.

                • value (string) --

                  The message to send to the user.

              • customPayload (dict) --

                A message in a custom format defined by the client application.

                • value (string) --

                  The string that is sent to your application.

              • ssmlMessage (dict) --

                A message in Speech Synthesis Markup Language (SSML).

                • value (string) --

                  The SSML text that defines the prompt.

              • imageResponseCard (dict) --

                A message that defines a response card that the client application can show to the user.

                • title (string) --

                  The title to display on the response card. The format of the title is determined by the platform displaying the response card.

                • subtitle (string) --

                  The subtitle to display on the response card. The format of the subtitle is determined by the platform displaying the response card.

                • imageUrl (string) --

                  The URL of an image to display on the response card. The image URL must be publicly available so that the platform displaying the response card has access to the image.

                • buttons (list) --

                  A list of buttons that should be displayed on the response card. The arrangement of the buttons is determined by the platform that displays the button.

                  • (dict) --

                    Describes a button to use on a response card used to gather slot values from a user.

                    • text (string) --

                      The text that appears on the button. Use this to tell the user what value is returned when they choose this button.

                    • value (string) --

                      The value returned to Amazon Lex when the user chooses this button. This must be one of the slot values configured for the slot.

            • variations (list) --

              Message variations to send to the user. When variations are defined, Amazon Lex chooses the primary message or one of the variations to send to the user.

              • (dict) --

                The object that provides message text and it's type.

                • plainTextMessage (dict) --

                  A message in plain text format.

                  • value (string) --

                    The message to send to the user.

                • customPayload (dict) --

                  A message in a custom format defined by the client application.

                  • value (string) --

                    The string that is sent to your application.

                • ssmlMessage (dict) --

                  A message in Speech Synthesis Markup Language (SSML).

                  • value (string) --

                    The SSML text that defines the prompt.

                • imageResponseCard (dict) --

                  A message that defines a response card that the client application can show to the user.

                  • title (string) --

                    The title to display on the response card. The format of the title is determined by the platform displaying the response card.

                  • subtitle (string) --

                    The subtitle to display on the response card. The format of the subtitle is determined by the platform displaying the response card.

                  • imageUrl (string) --

                    The URL of an image to display on the response card. The image URL must be publicly available so that the platform displaying the response card has access to the image.

                  • buttons (list) --

                    A list of buttons that should be displayed on the response card. The arrangement of the buttons is determined by the platform that displays the button.

                    • (dict) --

                      Describes a button to use on a response card used to gather slot values from a user.

                      • text (string) --

                        The text that appears on the button. Use this to tell the user what value is returned when they choose this button.

                      • value (string) --

                        The value returned to Amazon Lex when the user chooses this button. This must be one of the slot values configured for the slot.

        • allowInterrupt (boolean) --

          Indicates whether the user can interrupt a speech response from Amazon Lex.

      • active (boolean) --

        Specifies whether the intent's confirmation is sent to the user. When this field is false, confirmation and declination responses aren't sent and processing continues as if the responses aren't present. If the active field isn't specified, the default is true.

    • intentClosingSetting (dict) --

      The closing setting specified for the intent.

      • closingResponse (dict) --

        The response that Amazon Lex sends to the user when the intent is complete.

        • messageGroups (list) --

          A collection of responses that Amazon Lex can send to the user. Amazon Lex chooses the actual response to send at runtime.

          • (dict) --

            Provides one or more messages that Amazon Lex should send to the user.

            • message (dict) --

              The primary message that Amazon Lex should send to the user.

              • plainTextMessage (dict) --

                A message in plain text format.

                • value (string) --

                  The message to send to the user.

              • customPayload (dict) --

                A message in a custom format defined by the client application.

                • value (string) --

                  The string that is sent to your application.

              • ssmlMessage (dict) --

                A message in Speech Synthesis Markup Language (SSML).

                • value (string) --

                  The SSML text that defines the prompt.

              • imageResponseCard (dict) --

                A message that defines a response card that the client application can show to the user.

                • title (string) --

                  The title to display on the response card. The format of the title is determined by the platform displaying the response card.

                • subtitle (string) --

                  The subtitle to display on the response card. The format of the subtitle is determined by the platform displaying the response card.

                • imageUrl (string) --

                  The URL of an image to display on the response card. The image URL must be publicly available so that the platform displaying the response card has access to the image.

                • buttons (list) --

                  A list of buttons that should be displayed on the response card. The arrangement of the buttons is determined by the platform that displays the button.

                  • (dict) --

                    Describes a button to use on a response card used to gather slot values from a user.

                    • text (string) --

                      The text that appears on the button. Use this to tell the user what value is returned when they choose this button.

                    • value (string) --

                      The value returned to Amazon Lex when the user chooses this button. This must be one of the slot values configured for the slot.

            • variations (list) --

              Message variations to send to the user. When variations are defined, Amazon Lex chooses the primary message or one of the variations to send to the user.

              • (dict) --

                The object that provides message text and it's type.

                • plainTextMessage (dict) --

                  A message in plain text format.

                  • value (string) --

                    The message to send to the user.

                • customPayload (dict) --

                  A message in a custom format defined by the client application.

                  • value (string) --

                    The string that is sent to your application.

                • ssmlMessage (dict) --

                  A message in Speech Synthesis Markup Language (SSML).

                  • value (string) --

                    The SSML text that defines the prompt.

                • imageResponseCard (dict) --

                  A message that defines a response card that the client application can show to the user.

                  • title (string) --

                    The title to display on the response card. The format of the title is determined by the platform displaying the response card.

                  • subtitle (string) --

                    The subtitle to display on the response card. The format of the subtitle is determined by the platform displaying the response card.

                  • imageUrl (string) --

                    The URL of an image to display on the response card. The image URL must be publicly available so that the platform displaying the response card has access to the image.

                  • buttons (list) --

                    A list of buttons that should be displayed on the response card. The arrangement of the buttons is determined by the platform that displays the button.

                    • (dict) --

                      Describes a button to use on a response card used to gather slot values from a user.

                      • text (string) --

                        The text that appears on the button. Use this to tell the user what value is returned when they choose this button.

                      • value (string) --

                        The value returned to Amazon Lex when the user chooses this button. This must be one of the slot values configured for the slot.

        • allowInterrupt (boolean) --

          Indicates whether the user can interrupt a speech response from Amazon Lex.

      • active (boolean) --

        Specifies whether an intent's closing response is used. When this field is false, the closing response isn't sent to the user and no closing input from the user is used. If the active field isn't specified, the default is true.

    • inputContexts (list) --

      The list of input contexts specified for the intent.

      • (dict) --

        The name of a context that must be active for an intent to be selected by Amazon Lex.

        • name (string) --

          The name of the context.

    • outputContexts (list) --

      The list of output contexts specified for the intent.

      • (dict) --

        Describes a session context that is activated when an intent is fulfilled.

        • name (string) --

          The name of the output context.

        • timeToLiveInSeconds (integer) --

          The amount of time, in seconds, that the output context should remain active. The time is figured from the first time the context is sent to the user.

        • turnsToLive (integer) --

          The number of conversation turns that the output context should remain active. The number of turns is counted from the first time that the context is sent to the user.

    • kendraConfiguration (dict) --

      Configuration for searching a Amazon Kendra index specified for the intent.

      • kendraIndex (string) --

        The Amazon Resource Name (ARN) of the Amazon Kendra index that you want the AMAZON.KendraSearchIntent intent to search. The index must be in the same account and Region as the Amazon Lex bot.

      • queryFilterStringEnabled (boolean) --

        Determines whether the AMAZON.KendraSearchIntent intent uses a custom query string to query the Amazon Kendra index.

      • queryFilterString (string) --

        A query filter that Amazon Lex sends to Amazon Kendra to filter the response from a query. The filter is in the format defined by Amazon Kendra. For more information, see Filtering queries.

    • botId (string) --

      The identifier of the bot associated with the intent.

    • botVersion (string) --

      The identifier of the version of the bot associated with the intent.

    • localeId (string) --

      The locale that the intent is specified to use.

    • creationDateTime (datetime) --

      A timestamp of the date and time that the intent was created.

CreateSlot (updated) Link ΒΆ
Changes (both)
{'valueElicitationSetting': {'waitAndContinueSpecification': {'active': 'boolean'}}}

Creates a slot in an intent. A slot is a variable needed to fulfill an intent. For example, an OrderPizza intent might need slots for size, crust, and number of pizzas. For each slot, you define one or more utterances that Amazon Lex uses to elicit a response from the user.

See also: AWS API Documentation

Request Syntax

client.create_slot(
    slotName='string',
    description='string',
    slotTypeId='string',
    valueElicitationSetting={
        'defaultValueSpecification': {
            'defaultValueList': [
                {
                    'defaultValue': 'string'
                },
            ]
        },
        'slotConstraint': 'Required'|'Optional',
        'promptSpecification': {
            'messageGroups': [
                {
                    'message': {
                        'plainTextMessage': {
                            'value': 'string'
                        },
                        'customPayload': {
                            'value': 'string'
                        },
                        'ssmlMessage': {
                            'value': 'string'
                        },
                        'imageResponseCard': {
                            'title': 'string',
                            'subtitle': 'string',
                            'imageUrl': 'string',
                            'buttons': [
                                {
                                    'text': 'string',
                                    'value': 'string'
                                },
                            ]
                        }
                    },
                    'variations': [
                        {
                            'plainTextMessage': {
                                'value': 'string'
                            },
                            'customPayload': {
                                'value': 'string'
                            },
                            'ssmlMessage': {
                                'value': 'string'
                            },
                            'imageResponseCard': {
                                'title': 'string',
                                'subtitle': 'string',
                                'imageUrl': 'string',
                                'buttons': [
                                    {
                                        'text': 'string',
                                        'value': 'string'
                                    },
                                ]
                            }
                        },
                    ]
                },
            ],
            'maxRetries': 123,
            'allowInterrupt': True|False
        },
        'sampleUtterances': [
            {
                'utterance': 'string'
            },
        ],
        'waitAndContinueSpecification': {
            'waitingResponse': {
                'messageGroups': [
                    {
                        'message': {
                            'plainTextMessage': {
                                'value': 'string'
                            },
                            'customPayload': {
                                'value': 'string'
                            },
                            'ssmlMessage': {
                                'value': 'string'
                            },
                            'imageResponseCard': {
                                'title': 'string',
                                'subtitle': 'string',
                                'imageUrl': 'string',
                                'buttons': [
                                    {
                                        'text': 'string',
                                        'value': 'string'
                                    },
                                ]
                            }
                        },
                        'variations': [
                            {
                                'plainTextMessage': {
                                    'value': 'string'
                                },
                                'customPayload': {
                                    'value': 'string'
                                },
                                'ssmlMessage': {
                                    'value': 'string'
                                },
                                'imageResponseCard': {
                                    'title': 'string',
                                    'subtitle': 'string',
                                    'imageUrl': 'string',
                                    'buttons': [
                                        {
                                            'text': 'string',
                                            'value': 'string'
                                        },
                                    ]
                                }
                            },
                        ]
                    },
                ],
                'allowInterrupt': True|False
            },
            'continueResponse': {
                'messageGroups': [
                    {
                        'message': {
                            'plainTextMessage': {
                                'value': 'string'
                            },
                            'customPayload': {
                                'value': 'string'
                            },
                            'ssmlMessage': {
                                'value': 'string'
                            },
                            'imageResponseCard': {
                                'title': 'string',
                                'subtitle': 'string',
                                'imageUrl': 'string',
                                'buttons': [
                                    {
                                        'text': 'string',
                                        'value': 'string'
                                    },
                                ]
                            }
                        },
                        'variations': [
                            {
                                'plainTextMessage': {
                                    'value': 'string'
                                },
                                'customPayload': {
                                    'value': 'string'
                                },
                                'ssmlMessage': {
                                    'value': 'string'
                                },
                                'imageResponseCard': {
                                    'title': 'string',
                                    'subtitle': 'string',
                                    'imageUrl': 'string',
                                    'buttons': [
                                        {
                                            'text': 'string',
                                            'value': 'string'
                                        },
                                    ]
                                }
                            },
                        ]
                    },
                ],
                'allowInterrupt': True|False
            },
            'stillWaitingResponse': {
                'messageGroups': [
                    {
                        'message': {
                            'plainTextMessage': {
                                'value': 'string'
                            },
                            'customPayload': {
                                'value': 'string'
                            },
                            'ssmlMessage': {
                                'value': 'string'
                            },
                            'imageResponseCard': {
                                'title': 'string',
                                'subtitle': 'string',
                                'imageUrl': 'string',
                                'buttons': [
                                    {
                                        'text': 'string',
                                        'value': 'string'
                                    },
                                ]
                            }
                        },
                        'variations': [
                            {
                                'plainTextMessage': {
                                    'value': 'string'
                                },
                                'customPayload': {
                                    'value': 'string'
                                },
                                'ssmlMessage': {
                                    'value': 'string'
                                },
                                'imageResponseCard': {
                                    'title': 'string',
                                    'subtitle': 'string',
                                    'imageUrl': 'string',
                                    'buttons': [
                                        {
                                            'text': 'string',
                                            'value': 'string'
                                        },
                                    ]
                                }
                            },
                        ]
                    },
                ],
                'frequencyInSeconds': 123,
                'timeoutInSeconds': 123,
                'allowInterrupt': True|False
            },
            'active': True|False
        }
    },
    obfuscationSetting={
        'obfuscationSettingType': 'None'|'DefaultObfuscation'
    },
    botId='string',
    botVersion='string',
    localeId='string',
    intentId='string',
    multipleValuesSetting={
        'allowMultipleValues': True|False
    }
)
type slotName

string

param slotName

[REQUIRED]

The name of the slot. Slot names must be unique within the bot that contains the slot.

type description

string

param description

A description of the slot. Use this to help identify the slot in lists.

type slotTypeId

string

param slotTypeId

[REQUIRED]

The unique identifier for the slot type associated with this slot. The slot type determines the values that can be entered into the slot.

type valueElicitationSetting

dict

param valueElicitationSetting

[REQUIRED]

Specifies prompts that Amazon Lex sends to the user to elicit a response that provides the value for the slot.

  • defaultValueSpecification (dict) --

    A list of default values for a slot. Default values are used when Amazon Lex hasn't determined a value for a slot. You can specify default values from context variables, sesion attributes, and defined values.

    • defaultValueList (list) -- [REQUIRED]

      A list of default values. Amazon Lex chooses the default value to use in the order that they are presented in the list.

      • (dict) --

        Specifies the default value to use when a user doesn't provide a value for a slot.

        • defaultValue (string) -- [REQUIRED]

          The default value to use when a user doesn't provide a value for a slot.

  • slotConstraint (string) -- [REQUIRED]

    Specifies whether the slot is required or optional.

  • promptSpecification (dict) --

    The prompt that Amazon Lex uses to elicit the slot value from the user.

    • messageGroups (list) -- [REQUIRED]

      A collection of messages that Amazon Lex can send to the user. Amazon Lex chooses the actual message to send at runtime.

      • (dict) --

        Provides one or more messages that Amazon Lex should send to the user.

        • message (dict) -- [REQUIRED]

          The primary message that Amazon Lex should send to the user.

          • plainTextMessage (dict) --

            A message in plain text format.

            • value (string) -- [REQUIRED]

              The message to send to the user.

          • customPayload (dict) --

            A message in a custom format defined by the client application.

            • value (string) -- [REQUIRED]

              The string that is sent to your application.

          • ssmlMessage (dict) --

            A message in Speech Synthesis Markup Language (SSML).

            • value (string) -- [REQUIRED]

              The SSML text that defines the prompt.

          • imageResponseCard (dict) --

            A message that defines a response card that the client application can show to the user.

            • title (string) -- [REQUIRED]

              The title to display on the response card. The format of the title is determined by the platform displaying the response card.

            • subtitle (string) --

              The subtitle to display on the response card. The format of the subtitle is determined by the platform displaying the response card.

            • imageUrl (string) --

              The URL of an image to display on the response card. The image URL must be publicly available so that the platform displaying the response card has access to the image.

            • buttons (list) --

              A list of buttons that should be displayed on the response card. The arrangement of the buttons is determined by the platform that displays the button.

              • (dict) --

                Describes a button to use on a response card used to gather slot values from a user.

                • text (string) -- [REQUIRED]

                  The text that appears on the button. Use this to tell the user what value is returned when they choose this button.

                • value (string) -- [REQUIRED]

                  The value returned to Amazon Lex when the user chooses this button. This must be one of the slot values configured for the slot.

        • variations (list) --

          Message variations to send to the user. When variations are defined, Amazon Lex chooses the primary message or one of the variations to send to the user.

          • (dict) --

            The object that provides message text and it's type.

            • plainTextMessage (dict) --

              A message in plain text format.

              • value (string) -- [REQUIRED]

                The message to send to the user.

            • customPayload (dict) --

              A message in a custom format defined by the client application.

              • value (string) -- [REQUIRED]

                The string that is sent to your application.

            • ssmlMessage (dict) --

              A message in Speech Synthesis Markup Language (SSML).

              • value (string) -- [REQUIRED]

                The SSML text that defines the prompt.

            • imageResponseCard (dict) --

              A message that defines a response card that the client application can show to the user.

              • title (string) -- [REQUIRED]

                The title to display on the response card. The format of the title is determined by the platform displaying the response card.

              • subtitle (string) --

                The subtitle to display on the response card. The format of the subtitle is determined by the platform displaying the response card.

              • imageUrl (string) --

                The URL of an image to display on the response card. The image URL must be publicly available so that the platform displaying the response card has access to the image.

              • buttons (list) --

                A list of buttons that should be displayed on the response card. The arrangement of the buttons is determined by the platform that displays the button.

                • (dict) --

                  Describes a button to use on a response card used to gather slot values from a user.

                  • text (string) -- [REQUIRED]

                    The text that appears on the button. Use this to tell the user what value is returned when they choose this button.

                  • value (string) -- [REQUIRED]

                    The value returned to Amazon Lex when the user chooses this button. This must be one of the slot values configured for the slot.

    • maxRetries (integer) -- [REQUIRED]

      The maximum number of times the bot tries to elicit a resonse from the user using this prompt.

    • allowInterrupt (boolean) --

      Indicates whether the user can interrupt a speech prompt from the bot.

  • sampleUtterances (list) --

    If you know a specific pattern that users might respond to an Amazon Lex request for a slot value, you can provide those utterances to improve accuracy. This is optional. In most cases, Amazon Lex is capable of understanding user utterances.

    • (dict) --

      A sample utterance that invokes an intent or respond to a slot elicitation prompt.

      • utterance (string) -- [REQUIRED]

        The sample utterance that Amazon Lex uses to build its machine-learning model to recognize intents.

  • waitAndContinueSpecification (dict) --

    Specifies the prompts that Amazon Lex uses while a bot is waiting for customer input.

    • waitingResponse (dict) -- [REQUIRED]

      The response that Amazon Lex sends to indicate that the bot is waiting for the conversation to continue.

      • messageGroups (list) -- [REQUIRED]

        A collection of responses that Amazon Lex can send to the user. Amazon Lex chooses the actual response to send at runtime.

        • (dict) --

          Provides one or more messages that Amazon Lex should send to the user.

          • message (dict) -- [REQUIRED]

            The primary message that Amazon Lex should send to the user.

            • plainTextMessage (dict) --

              A message in plain text format.

              • value (string) -- [REQUIRED]

                The message to send to the user.

            • customPayload (dict) --

              A message in a custom format defined by the client application.

              • value (string) -- [REQUIRED]

                The string that is sent to your application.

            • ssmlMessage (dict) --

              A message in Speech Synthesis Markup Language (SSML).

              • value (string) -- [REQUIRED]

                The SSML text that defines the prompt.

            • imageResponseCard (dict) --

              A message that defines a response card that the client application can show to the user.

              • title (string) -- [REQUIRED]

                The title to display on the response card. The format of the title is determined by the platform displaying the response card.

              • subtitle (string) --

                The subtitle to display on the response card. The format of the subtitle is determined by the platform displaying the response card.

              • imageUrl (string) --

                The URL of an image to display on the response card. The image URL must be publicly available so that the platform displaying the response card has access to the image.

              • buttons (list) --

                A list of buttons that should be displayed on the response card. The arrangement of the buttons is determined by the platform that displays the button.

                • (dict) --

                  Describes a button to use on a response card used to gather slot values from a user.

                  • text (string) -- [REQUIRED]

                    The text that appears on the button. Use this to tell the user what value is returned when they choose this button.

                  • value (string) -- [REQUIRED]

                    The value returned to Amazon Lex when the user chooses this button. This must be one of the slot values configured for the slot.

          • variations (list) --

            Message variations to send to the user. When variations are defined, Amazon Lex chooses the primary message or one of the variations to send to the user.

            • (dict) --

              The object that provides message text and it's type.

              • plainTextMessage (dict) --

                A message in plain text format.

                • value (string) -- [REQUIRED]

                  The message to send to the user.

              • customPayload (dict) --

                A message in a custom format defined by the client application.

                • value (string) -- [REQUIRED]

                  The string that is sent to your application.

              • ssmlMessage (dict) --

                A message in Speech Synthesis Markup Language (SSML).

                • value (string) -- [REQUIRED]

                  The SSML text that defines the prompt.

              • imageResponseCard (dict) --

                A message that defines a response card that the client application can show to the user.

                • title (string) -- [REQUIRED]

                  The title to display on the response card. The format of the title is determined by the platform displaying the response card.

                • subtitle (string) --

                  The subtitle to display on the response card. The format of the subtitle is determined by the platform displaying the response card.

                • imageUrl (string) --

                  The URL of an image to display on the response card. The image URL must be publicly available so that the platform displaying the response card has access to the image.

                • buttons (list) --

                  A list of buttons that should be displayed on the response card. The arrangement of the buttons is determined by the platform that displays the button.

                  • (dict) --

                    Describes a button to use on a response card used to gather slot values from a user.

                    • text (string) -- [REQUIRED]

                      The text that appears on the button. Use this to tell the user what value is returned when they choose this button.

                    • value (string) -- [REQUIRED]

                      The value returned to Amazon Lex when the user chooses this button. This must be one of the slot values configured for the slot.

      • allowInterrupt (boolean) --

        Indicates whether the user can interrupt a speech response from Amazon Lex.

    • continueResponse (dict) -- [REQUIRED]

      The response that Amazon Lex sends to indicate that the bot is ready to continue the conversation.

      • messageGroups (list) -- [REQUIRED]

        A collection of responses that Amazon Lex can send to the user. Amazon Lex chooses the actual response to send at runtime.

        • (dict) --

          Provides one or more messages that Amazon Lex should send to the user.

          • message (dict) -- [REQUIRED]

            The primary message that Amazon Lex should send to the user.

            • plainTextMessage (dict) --

              A message in plain text format.

              • value (string) -- [REQUIRED]

                The message to send to the user.

            • customPayload (dict) --

              A message in a custom format defined by the client application.

              • value (string) -- [REQUIRED]

                The string that is sent to your application.

            • ssmlMessage (dict) --

              A message in Speech Synthesis Markup Language (SSML).

              • value (string) -- [REQUIRED]

                The SSML text that defines the prompt.

            • imageResponseCard (dict) --

              A message that defines a response card that the client application can show to the user.

              • title (string) -- [REQUIRED]

                The title to display on the response card. The format of the title is determined by the platform displaying the response card.

              • subtitle (string) --

                The subtitle to display on the response card. The format of the subtitle is determined by the platform displaying the response card.

              • imageUrl (string) --

                The URL of an image to display on the response card. The image URL must be publicly available so that the platform displaying the response card has access to the image.

              • buttons (list) --

                A list of buttons that should be displayed on the response card. The arrangement of the buttons is determined by the platform that displays the button.

                • (dict) --

                  Describes a button to use on a response card used to gather slot values from a user.

                  • text (string) -- [REQUIRED]

                    The text that appears on the button. Use this to tell the user what value is returned when they choose this button.

                  • value (string) -- [REQUIRED]

                    The value returned to Amazon Lex when the user chooses this button. This must be one of the slot values configured for the slot.

          • variations (list) --

            Message variations to send to the user. When variations are defined, Amazon Lex chooses the primary message or one of the variations to send to the user.

            • (dict) --

              The object that provides message text and it's type.

              • plainTextMessage (dict) --

                A message in plain text format.

                • value (string) -- [REQUIRED]

                  The message to send to the user.

              • customPayload (dict) --

                A message in a custom format defined by the client application.

                • value (string) -- [REQUIRED]

                  The string that is sent to your application.

              • ssmlMessage (dict) --

                A message in Speech Synthesis Markup Language (SSML).

                • value (string) -- [REQUIRED]

                  The SSML text that defines the prompt.

              • imageResponseCard (dict) --

                A message that defines a response card that the client application can show to the user.

                • title (string) -- [REQUIRED]

                  The title to display on the response card. The format of the title is determined by the platform displaying the response card.

                • subtitle (string) --

                  The subtitle to display on the response card. The format of the subtitle is determined by the platform displaying the response card.

                • imageUrl (string) --

                  The URL of an image to display on the response card. The image URL must be publicly available so that the platform displaying the response card has access to the image.

                • buttons (list) --

                  A list of buttons that should be displayed on the response card. The arrangement of the buttons is determined by the platform that displays the button.

                  • (dict) --

                    Describes a button to use on a response card used to gather slot values from a user.

                    • text (string) -- [REQUIRED]

                      The text that appears on the button. Use this to tell the user what value is returned when they choose this button.

                    • value (string) -- [REQUIRED]

                      The value returned to Amazon Lex when the user chooses this button. This must be one of the slot values configured for the slot.

      • allowInterrupt (boolean) --

        Indicates whether the user can interrupt a speech response from Amazon Lex.

    • stillWaitingResponse (dict) --

      A response that Amazon Lex sends periodically to the user to indicate that the bot is still waiting for input from the user.

      • messageGroups (list) -- [REQUIRED]

        One or more message groups, each containing one or more messages, that define the prompts that Amazon Lex sends to the user.

        • (dict) --

          Provides one or more messages that Amazon Lex should send to the user.

          • message (dict) -- [REQUIRED]

            The primary message that Amazon Lex should send to the user.

            • plainTextMessage (dict) --

              A message in plain text format.

              • value (string) -- [REQUIRED]

                The message to send to the user.

            • customPayload (dict) --

              A message in a custom format defined by the client application.

              • value (string) -- [REQUIRED]

                The string that is sent to your application.

            • ssmlMessage (dict) --

              A message in Speech Synthesis Markup Language (SSML).

              • value (string) -- [REQUIRED]

                The SSML text that defines the prompt.

            • imageResponseCard (dict) --

              A message that defines a response card that the client application can show to the user.

              • title (string) -- [REQUIRED]

                The title to display on the response card. The format of the title is determined by the platform displaying the response card.

              • subtitle (string) --

                The subtitle to display on the response card. The format of the subtitle is determined by the platform displaying the response card.

              • imageUrl (string) --

                The URL of an image to display on the response card. The image URL must be publicly available so that the platform displaying the response card has access to the image.

              • buttons (list) --

                A list of buttons that should be displayed on the response card. The arrangement of the buttons is determined by the platform that displays the button.

                • (dict) --

                  Describes a button to use on a response card used to gather slot values from a user.

                  • text (string) -- [REQUIRED]

                    The text that appears on the button. Use this to tell the user what value is returned when they choose this button.

                  • value (string) -- [REQUIRED]

                    The value returned to Amazon Lex when the user chooses this button. This must be one of the slot values configured for the slot.

          • variations (list) --

            Message variations to send to the user. When variations are defined, Amazon Lex chooses the primary message or one of the variations to send to the user.

            • (dict) --

              The object that provides message text and it's type.

              • plainTextMessage (dict) --

                A message in plain text format.

                • value (string) -- [REQUIRED]

                  The message to send to the user.

              • customPayload (dict) --

                A message in a custom format defined by the client application.

                • value (string) -- [REQUIRED]

                  The string that is sent to your application.

              • ssmlMessage (dict) --

                A message in Speech Synthesis Markup Language (SSML).

                • value (string) -- [REQUIRED]

                  The SSML text that defines the prompt.

              • imageResponseCard (dict) --

                A message that defines a response card that the client application can show to the user.

                • title (string) -- [REQUIRED]

                  The title to display on the response card. The format of the title is determined by the platform displaying the response card.

                • subtitle (string) --

                  The subtitle to display on the response card. The format of the subtitle is determined by the platform displaying the response card.

                • imageUrl (string) --

                  The URL of an image to display on the response card. The image URL must be publicly available so that the platform displaying the response card has access to the image.

                • buttons (list) --

                  A list of buttons that should be displayed on the response card. The arrangement of the buttons is determined by the platform that displays the button.

                  • (dict) --

                    Describes a button to use on a response card used to gather slot values from a user.

                    • text (string) -- [REQUIRED]

                      The text that appears on the button. Use this to tell the user what value is returned when they choose this button.

                    • value (string) -- [REQUIRED]

                      The value returned to Amazon Lex when the user chooses this button. This must be one of the slot values configured for the slot.

      • frequencyInSeconds (integer) -- [REQUIRED]

        How often a message should be sent to the user. Minimum of 1 second, maximum of 5 minutes.

      • timeoutInSeconds (integer) -- [REQUIRED]

        If Amazon Lex waits longer than this length of time for a response, it will stop sending messages.

      • allowInterrupt (boolean) --

        Indicates that the user can interrupt the response by speaking while the message is being played.

    • active (boolean) --

      Specifies whether the bot will wait for a user to respond. When this field is false, wait and continue responses for a slot aren't used and the bot expects an appropriate response within the configured timeout. If the active field isn't specified, the default is true.

type obfuscationSetting

dict

param obfuscationSetting

Determines how slot values are used in Amazon CloudWatch logs. If the value of the obfuscationSetting parameter is DefaultObfuscation , slot values are obfuscated in the log output. If the value is None , the actual value is present in the log output.

The default is to obfuscate values in the CloudWatch logs.

  • obfuscationSettingType (string) -- [REQUIRED]

    Value that determines whether Amazon Lex obscures slot values in conversation logs. The default is to obscure the values.

type botId

string

param botId

[REQUIRED]

The identifier of the bot associated with the slot.

type botVersion

string

param botVersion

[REQUIRED]

The version of the bot associated with the slot.

type localeId

string

param localeId

[REQUIRED]

The identifier of the language and locale that the slot will be used in. The string must match one of the supported locales. All of the bots, intents, slot types used by the slot must have the same locale. For more information, see Supported languages.

type intentId

string

param intentId

[REQUIRED]

The identifier of the intent that contains the slot.

type multipleValuesSetting

dict

param multipleValuesSetting

Indicates whether the slot returns multiple values in one response. Multi-value slots are only available in the en-US locale. If you set this value to true in any other locale, Amazon Lex throws a ValidationException .

If the multipleValuesSetting is not set, the default value is false .

  • allowMultipleValues (boolean) --

    Indicates whether a slot can return multiple values. When true , the slot may return more than one value in a response. When false , the slot returns only a single value.

    Multi-value slots are only available in the en-US locale. If you set this value to true in any other locale, Amazon Lex throws a ValidationException .

    If the allowMutlipleValues is not set, the default value is false .

rtype

dict

returns

Response Syntax

{
    'slotId': 'string',
    'slotName': 'string',
    'description': 'string',
    'slotTypeId': 'string',
    'valueElicitationSetting': {
        'defaultValueSpecification': {
            'defaultValueList': [
                {
                    'defaultValue': 'string'
                },
            ]
        },
        'slotConstraint': 'Required'|'Optional',
        'promptSpecification': {
            'messageGroups': [
                {
                    'message': {
                        'plainTextMessage': {
                            'value': 'string'
                        },
                        'customPayload': {
                            'value': 'string'
                        },
                        'ssmlMessage': {
                            'value': 'string'
                        },
                        'imageResponseCard': {
                            'title': 'string',
                            'subtitle': 'string',
                            'imageUrl': 'string',
                            'buttons': [
                                {
                                    'text': 'string',
                                    'value': 'string'
                                },
                            ]
                        }
                    },
                    'variations': [
                        {
                            'plainTextMessage': {
                                'value': 'string'
                            },
                            'customPayload': {
                                'value': 'string'
                            },
                            'ssmlMessage': {
                                'value': 'string'
                            },
                            'imageResponseCard': {
                                'title': 'string',
                                'subtitle': 'string',
                                'imageUrl': 'string',
                                'buttons': [
                                    {
                                        'text': 'string',
                                        'value': 'string'
                                    },
                                ]
                            }
                        },
                    ]
                },
            ],
            'maxRetries': 123,
            'allowInterrupt': True|False
        },
        'sampleUtterances': [
            {
                'utterance': 'string'
            },
        ],
        'waitAndContinueSpecification': {
            'waitingResponse': {
                'messageGroups': [
                    {
                        'message': {
                            'plainTextMessage': {
                                'value': 'string'
                            },
                            'customPayload': {
                                'value': 'string'
                            },
                            'ssmlMessage': {
                                'value': 'string'
                            },
                            'imageResponseCard': {
                                'title': 'string',
                                'subtitle': 'string',
                                'imageUrl': 'string',
                                'buttons': [
                                    {
                                        'text': 'string',
                                        'value': 'string'
                                    },
                                ]
                            }
                        },
                        'variations': [
                            {
                                'plainTextMessage': {
                                    'value': 'string'
                                },
                                'customPayload': {
                                    'value': 'string'
                                },
                                'ssmlMessage': {
                                    'value': 'string'
                                },
                                'imageResponseCard': {
                                    'title': 'string',
                                    'subtitle': 'string',
                                    'imageUrl': 'string',
                                    'buttons': [
                                        {
                                            'text': 'string',
                                            'value': 'string'
                                        },
                                    ]
                                }
                            },
                        ]
                    },
                ],
                'allowInterrupt': True|False
            },
            'continueResponse': {
                'messageGroups': [
                    {
                        'message': {
                            'plainTextMessage': {
                                'value': 'string'
                            },
                            'customPayload': {
                                'value': 'string'
                            },
                            'ssmlMessage': {
                                'value': 'string'
                            },
                            'imageResponseCard': {
                                'title': 'string',
                                'subtitle': 'string',
                                'imageUrl': 'string',
                                'buttons': [
                                    {
                                        'text': 'string',
                                        'value': 'string'
                                    },
                                ]
                            }
                        },
                        'variations': [
                            {
                                'plainTextMessage': {
                                    'value': 'string'
                                },
                                'customPayload': {
                                    'value': 'string'
                                },
                                'ssmlMessage': {
                                    'value': 'string'
                                },
                                'imageResponseCard': {
                                    'title': 'string',
                                    'subtitle': 'string',
                                    'imageUrl': 'string',
                                    'buttons': [
                                        {
                                            'text': 'string',
                                            'value': 'string'
                                        },
                                    ]
                                }
                            },
                        ]
                    },
                ],
                'allowInterrupt': True|False
            },
            'stillWaitingResponse': {
                'messageGroups': [
                    {
                        'message': {
                            'plainTextMessage': {
                                'value': 'string'
                            },
                            'customPayload': {
                                'value': 'string'
                            },
                            'ssmlMessage': {
                                'value': 'string'
                            },
                            'imageResponseCard': {
                                'title': 'string',
                                'subtitle': 'string',
                                'imageUrl': 'string',
                                'buttons': [
                                    {
                                        'text': 'string',
                                        'value': 'string'
                                    },
                                ]
                            }
                        },
                        'variations': [
                            {
                                'plainTextMessage': {
                                    'value': 'string'
                                },
                                'customPayload': {
                                    'value': 'string'
                                },
                                'ssmlMessage': {
                                    'value': 'string'
                                },
                                'imageResponseCard': {
                                    'title': 'string',
                                    'subtitle': 'string',
                                    'imageUrl': 'string',
                                    'buttons': [
                                        {
                                            'text': 'string',
                                            'value': 'string'
                                        },
                                    ]
                                }
                            },
                        ]
                    },
                ],
                'frequencyInSeconds': 123,
                'timeoutInSeconds': 123,
                'allowInterrupt': True|False
            },
            'active': True|False
        }
    },
    'obfuscationSetting': {
        'obfuscationSettingType': 'None'|'DefaultObfuscation'
    },
    'botId': 'string',
    'botVersion': 'string',
    'localeId': 'string',
    'intentId': 'string',
    'creationDateTime': datetime(2015, 1, 1),
    'multipleValuesSetting': {
        'allowMultipleValues': True|False
    }
}

Response Structure

  • (dict) --

    • slotId (string) --

      The unique identifier associated with the slot. Use this to identify the slot when you update or delete it.

    • slotName (string) --

      The name specified for the slot.

    • description (string) --

      The description associated with the slot.

    • slotTypeId (string) --

      The unique identifier of the slot type associated with this slot.

    • valueElicitationSetting (dict) --

      The value elicitation settings specified for the slot.

      • defaultValueSpecification (dict) --

        A list of default values for a slot. Default values are used when Amazon Lex hasn't determined a value for a slot. You can specify default values from context variables, sesion attributes, and defined values.

        • defaultValueList (list) --

          A list of default values. Amazon Lex chooses the default value to use in the order that they are presented in the list.

          • (dict) --

            Specifies the default value to use when a user doesn't provide a value for a slot.

            • defaultValue (string) --

              The default value to use when a user doesn't provide a value for a slot.

      • slotConstraint (string) --

        Specifies whether the slot is required or optional.

      • promptSpecification (dict) --

        The prompt that Amazon Lex uses to elicit the slot value from the user.

        • messageGroups (list) --

          A collection of messages that Amazon Lex can send to the user. Amazon Lex chooses the actual message to send at runtime.

          • (dict) --

            Provides one or more messages that Amazon Lex should send to the user.

            • message (dict) --

              The primary message that Amazon Lex should send to the user.

              • plainTextMessage (dict) --

                A message in plain text format.

                • value (string) --

                  The message to send to the user.

              • customPayload (dict) --

                A message in a custom format defined by the client application.

                • value (string) --

                  The string that is sent to your application.

              • ssmlMessage (dict) --

                A message in Speech Synthesis Markup Language (SSML).

                • value (string) --

                  The SSML text that defines the prompt.

              • imageResponseCard (dict) --

                A message that defines a response card that the client application can show to the user.

                • title (string) --

                  The title to display on the response card. The format of the title is determined by the platform displaying the response card.

                • subtitle (string) --

                  The subtitle to display on the response card. The format of the subtitle is determined by the platform displaying the response card.

                • imageUrl (string) --

                  The URL of an image to display on the response card. The image URL must be publicly available so that the platform displaying the response card has access to the image.

                • buttons (list) --

                  A list of buttons that should be displayed on the response card. The arrangement of the buttons is determined by the platform that displays the button.

                  • (dict) --

                    Describes a button to use on a response card used to gather slot values from a user.

                    • text (string) --

                      The text that appears on the button. Use this to tell the user what value is returned when they choose this button.

                    • value (string) --

                      The value returned to Amazon Lex when the user chooses this button. This must be one of the slot values configured for the slot.

            • variations (list) --

              Message variations to send to the user. When variations are defined, Amazon Lex chooses the primary message or one of the variations to send to the user.

              • (dict) --

                The object that provides message text and it's type.

                • plainTextMessage (dict) --

                  A message in plain text format.

                  • value (string) --

                    The message to send to the user.

                • customPayload (dict) --

                  A message in a custom format defined by the client application.

                  • value (string) --

                    The string that is sent to your application.

                • ssmlMessage (dict) --

                  A message in Speech Synthesis Markup Language (SSML).

                  • value (string) --

                    The SSML text that defines the prompt.

                • imageResponseCard (dict) --

                  A message that defines a response card that the client application can show to the user.

                  • title (string) --

                    The title to display on the response card. The format of the title is determined by the platform displaying the response card.

                  • subtitle (string) --

                    The subtitle to display on the response card. The format of the subtitle is determined by the platform displaying the response card.

                  • imageUrl (string) --

                    The URL of an image to display on the response card. The image URL must be publicly available so that the platform displaying the response card has access to the image.

                  • buttons (list) --

                    A list of buttons that should be displayed on the response card. The arrangement of the buttons is determined by the platform that displays the button.

                    • (dict) --

                      Describes a button to use on a response card used to gather slot values from a user.

                      • text (string) --

                        The text that appears on the button. Use this to tell the user what value is returned when they choose this button.

                      • value (string) --

                        The value returned to Amazon Lex when the user chooses this button. This must be one of the slot values configured for the slot.

        • maxRetries (integer) --

          The maximum number of times the bot tries to elicit a resonse from the user using this prompt.

        • allowInterrupt (boolean) --

          Indicates whether the user can interrupt a speech prompt from the bot.

      • sampleUtterances (list) --

        If you know a specific pattern that users might respond to an Amazon Lex request for a slot value, you can provide those utterances to improve accuracy. This is optional. In most cases, Amazon Lex is capable of understanding user utterances.

        • (dict) --

          A sample utterance that invokes an intent or respond to a slot elicitation prompt.

          • utterance (string) --

            The sample utterance that Amazon Lex uses to build its machine-learning model to recognize intents.

      • waitAndContinueSpecification (dict) --

        Specifies the prompts that Amazon Lex uses while a bot is waiting for customer input.

        • waitingResponse (dict) --

          The response that Amazon Lex sends to indicate that the bot is waiting for the conversation to continue.

          • messageGroups (list) --

            A collection of responses that Amazon Lex can send to the user. Amazon Lex chooses the actual response to send at runtime.

            • (dict) --

              Provides one or more messages that Amazon Lex should send to the user.

              • message (dict) --

                The primary message that Amazon Lex should send to the user.

                • plainTextMessage (dict) --

                  A message in plain text format.

                  • value (string) --

                    The message to send to the user.

                • customPayload (dict) --

                  A message in a custom format defined by the client application.

                  • value (string) --

                    The string that is sent to your application.

                • ssmlMessage (dict) --

                  A message in Speech Synthesis Markup Language (SSML).

                  • value (string) --

                    The SSML text that defines the prompt.

                • imageResponseCard (dict) --

                  A message that defines a response card that the client application can show to the user.

                  • title (string) --

                    The title to display on the response card. The format of the title is determined by the platform displaying the response card.

                  • subtitle (string) --

                    The subtitle to display on the response card. The format of the subtitle is determined by the platform displaying the response card.

                  • imageUrl (string) --

                    The URL of an image to display on the response card. The image URL must be publicly available so that the platform displaying the response card has access to the image.

                  • buttons (list) --

                    A list of buttons that should be displayed on the response card. The arrangement of the buttons is determined by the platform that displays the button.

                    • (dict) --

                      Describes a button to use on a response card used to gather slot values from a user.

                      • text (string) --

                        The text that appears on the button. Use this to tell the user what value is returned when they choose this button.

                      • value (string) --

                        The value returned to Amazon Lex when the user chooses this button. This must be one of the slot values configured for the slot.

              • variations (list) --

                Message variations to send to the user. When variations are defined, Amazon Lex chooses the primary message or one of the variations to send to the user.

                • (dict) --

                  The object that provides message text and it's type.

                  • plainTextMessage (dict) --

                    A message in plain text format.

                    • value (string) --

                      The message to send to the user.

                  • customPayload (dict) --

                    A message in a custom format defined by the client application.

                    • value (string) --

                      The string that is sent to your application.

                  • ssmlMessage (dict) --

                    A message in Speech Synthesis Markup Language (SSML).

                    • value (string) --

                      The SSML text that defines the prompt.

                  • imageResponseCard (dict) --

                    A message that defines a response card that the client application can show to the user.

                    • title (string) --

                      The title to display on the response card. The format of the title is determined by the platform displaying the response card.

                    • subtitle (string) --

                      The subtitle to display on the response card. The format of the subtitle is determined by the platform displaying the response card.

                    • imageUrl (string) --

                      The URL of an image to display on the response card. The image URL must be publicly available so that the platform displaying the response card has access to the image.

                    • buttons (list) --

                      A list of buttons that should be displayed on the response card. The arrangement of the buttons is determined by the platform that displays the button.

                      • (dict) --

                        Describes a button to use on a response card used to gather slot values from a user.

                        • text (string) --

                          The text that appears on the button. Use this to tell the user what value is returned when they choose this button.

                        • value (string) --

                          The value returned to Amazon Lex when the user chooses this button. This must be one of the slot values configured for the slot.

          • allowInterrupt (boolean) --

            Indicates whether the user can interrupt a speech response from Amazon Lex.

        • continueResponse (dict) --

          The response that Amazon Lex sends to indicate that the bot is ready to continue the conversation.

          • messageGroups (list) --

            A collection of responses that Amazon Lex can send to the user. Amazon Lex chooses the actual response to send at runtime.

            • (dict) --

              Provides one or more messages that Amazon Lex should send to the user.

              • message (dict) --

                The primary message that Amazon Lex should send to the user.

                • plainTextMessage (dict) --

                  A message in plain text format.

                  • value (string) --

                    The message to send to the user.

                • customPayload (dict) --

                  A message in a custom format defined by the client application.

                  • value (string) --

                    The string that is sent to your application.

                • ssmlMessage (dict) --

                  A message in Speech Synthesis Markup Language (SSML).

                  • value (string) --

                    The SSML text that defines the prompt.

                • imageResponseCard (dict) --

                  A message that defines a response card that the client application can show to the user.

                  • title (string) --

                    The title to display on the response card. The format of the title is determined by the platform displaying the response card.

                  • subtitle (string) --

                    The subtitle to display on the response card. The format of the subtitle is determined by the platform displaying the response card.

                  • imageUrl (string) --

                    The URL of an image to display on the response card. The image URL must be publicly available so that the platform displaying the response card has access to the image.

                  • buttons (list) --

                    A list of buttons that should be displayed on the response card. The arrangement of the buttons is determined by the platform that displays the button.

                    • (dict) --

                      Describes a button to use on a response card used to gather slot values from a user.

                      • text (string) --

                        The text that appears on the button. Use this to tell the user what value is returned when they choose this button.

                      • value (string) --

                        The value returned to Amazon Lex when the user chooses this button. This must be one of the slot values configured for the slot.

              • variations (list) --

                Message variations to send to the user. When variations are defined, Amazon Lex chooses the primary message or one of the variations to send to the user.

                • (dict) --

                  The object that provides message text and it's type.

                  • plainTextMessage (dict) --

                    A message in plain text format.

                    • value (string) --

                      The message to send to the user.

                  • customPayload (dict) --

                    A message in a custom format defined by the client application.

                    • value (string) --

                      The string that is sent to your application.

                  • ssmlMessage (dict) --

                    A message in Speech Synthesis Markup Language (SSML).

                    • value (string) --

                      The SSML text that defines the prompt.

                  • imageResponseCard (dict) --

                    A message that defines a response card that the client application can show to the user.

                    • title (string) --

                      The title to display on the response card. The format of the title is determined by the platform displaying the response card.

                    • subtitle (string) --

                      The subtitle to display on the response card. The format of the subtitle is determined by the platform displaying the response card.

                    • imageUrl (string) --

                      The URL of an image to display on the response card. The image URL must be publicly available so that the platform displaying the response card has access to the image.

                    • buttons (list) --

                      A list of buttons that should be displayed on the response card. The arrangement of the buttons is determined by the platform that displays the button.

                      • (dict) --

                        Describes a button to use on a response card used to gather slot values from a user.

                        • text (string) --

                          The text that appears on the button. Use this to tell the user what value is returned when they choose this button.

                        • value (string) --

                          The value returned to Amazon Lex when the user chooses this button. This must be one of the slot values configured for the slot.

          • allowInterrupt (boolean) --

            Indicates whether the user can interrupt a speech response from Amazon Lex.

        • stillWaitingResponse (dict) --

          A response that Amazon Lex sends periodically to the user to indicate that the bot is still waiting for input from the user.

          • messageGroups (list) --

            One or more message groups, each containing one or more messages, that define the prompts that Amazon Lex sends to the user.

            • (dict) --

              Provides one or more messages that Amazon Lex should send to the user.

              • message (dict) --

                The primary message that Amazon Lex should send to the user.

                • plainTextMessage (dict) --

                  A message in plain text format.

                  • value (string) --

                    The message to send to the user.

                • customPayload (dict) --

                  A message in a custom format defined by the client application.

                  • value (string) --

                    The string that is sent to your application.

                • ssmlMessage (dict) --

                  A message in Speech Synthesis Markup Language (SSML).

                  • value (string) --

                    The SSML text that defines the prompt.

                • imageResponseCard (dict) --

                  A message that defines a response card that the client application can show to the user.

                  • title (string) --

                    The title to display on the response card. The format of the title is determined by the platform displaying the response card.

                  • subtitle (string) --

                    The subtitle to display on the response card. The format of the subtitle is determined by the platform displaying the response card.

                  • imageUrl (string) --

                    The URL of an image to display on the response card. The image URL must be publicly available so that the platform displaying the response card has access to the image.

                  • buttons (list) --

                    A list of buttons that should be displayed on the response card. The arrangement of the buttons is determined by the platform that displays the button.

                    • (dict) --

                      Describes a button to use on a response card used to gather slot values from a user.

                      • text (string) --

                        The text that appears on the button. Use this to tell the user what value is returned when they choose this button.

                      • value (string) --

                        The value returned to Amazon Lex when the user chooses this button. This must be one of the slot values configured for the slot.

              • variations (list) --

                Message variations to send to the user. When variations are defined, Amazon Lex chooses the primary message or one of the variations to send to the user.

                • (dict) --

                  The object that provides message text and it's type.

                  • plainTextMessage (dict) --

                    A message in plain text format.

                    • value (string) --

                      The message to send to the user.

                  • customPayload (dict) --

                    A message in a custom format defined by the client application.

                    • value (string) --

                      The string that is sent to your application.

                  • ssmlMessage (dict) --

                    A message in Speech Synthesis Markup Language (SSML).

                    • value (string) --

                      The SSML text that defines the prompt.

                  • imageResponseCard (dict) --

                    A message that defines a response card that the client application can show to the user.

                    • title (string) --

                      The title to display on the response card. The format of the title is determined by the platform displaying the response card.

                    • subtitle (string) --

                      The subtitle to display on the response card. The format of the subtitle is determined by the platform displaying the response card.

                    • imageUrl (string) --

                      The URL of an image to display on the response card. The image URL must be publicly available so that the platform displaying the response card has access to the image.

                    • buttons (list) --

                      A list of buttons that should be displayed on the response card. The arrangement of the buttons is determined by the platform that displays the button.

                      • (dict) --

                        Describes a button to use on a response card used to gather slot values from a user.

                        • text (string) --

                          The text that appears on the button. Use this to tell the user what value is returned when they choose this button.

                        • value (string) --

                          The value returned to Amazon Lex when the user chooses this button. This must be one of the slot values configured for the slot.

          • frequencyInSeconds (integer) --

            How often a message should be sent to the user. Minimum of 1 second, maximum of 5 minutes.

          • timeoutInSeconds (integer) --

            If Amazon Lex waits longer than this length of time for a response, it will stop sending messages.

          • allowInterrupt (boolean) --

            Indicates that the user can interrupt the response by speaking while the message is being played.

        • active (boolean) --

          Specifies whether the bot will wait for a user to respond. When this field is false, wait and continue responses for a slot aren't used and the bot expects an appropriate response within the configured timeout. If the active field isn't specified, the default is true.

    • obfuscationSetting (dict) --

      Indicates whether the slot is configured to obfuscate values in Amazon CloudWatch logs.

      • obfuscationSettingType (string) --

        Value that determines whether Amazon Lex obscures slot values in conversation logs. The default is to obscure the values.

    • botId (string) --

      The unique identifier of the bot associated with the slot.

    • botVersion (string) --

      The version of the bot associated with the slot.

    • localeId (string) --

      The language and local specified for the slot.

    • intentId (string) --

      The unique identifier of the intent associated with the slot.

    • creationDateTime (datetime) --

      The timestamp of the date and time that the slot was created.

    • multipleValuesSetting (dict) --

      Indicates whether the slot returns multiple values in one response.

      • allowMultipleValues (boolean) --

        Indicates whether a slot can return multiple values. When true , the slot may return more than one value in a response. When false , the slot returns only a single value.

        Multi-value slots are only available in the en-US locale. If you set this value to true in any other locale, Amazon Lex throws a ValidationException .

        If the allowMutlipleValues is not set, the default value is false .

DescribeIntent (updated) Link ΒΆ
Changes (response)
{'intentClosingSetting': {'active': 'boolean'},
 'intentConfirmationSetting': {'active': 'boolean'}}

Returns metadata about an intent.

See also: AWS API Documentation

Request Syntax

client.describe_intent(
    intentId='string',
    botId='string',
    botVersion='string',
    localeId='string'
)
type intentId

string

param intentId

[REQUIRED]

The identifier of the intent to describe.

type botId

string

param botId

[REQUIRED]

The identifier of the bot associated with the intent.

type botVersion

string

param botVersion

[REQUIRED]

The version of the bot associated with the intent.

type localeId

string

param localeId

[REQUIRED]

The identifier of the language and locale of the intent to describe. The string must match one of the supported locales. For more information, see Supported languages.

rtype

dict

returns

Response Syntax

{
    'intentId': 'string',
    'intentName': 'string',
    'description': 'string',
    'parentIntentSignature': 'string',
    'sampleUtterances': [
        {
            'utterance': 'string'
        },
    ],
    'dialogCodeHook': {
        'enabled': True|False
    },
    'fulfillmentCodeHook': {
        'enabled': True|False
    },
    'slotPriorities': [
        {
            'priority': 123,
            'slotId': 'string'
        },
    ],
    'intentConfirmationSetting': {
        'promptSpecification': {
            'messageGroups': [
                {
                    'message': {
                        'plainTextMessage': {
                            'value': 'string'
                        },
                        'customPayload': {
                            'value': 'string'
                        },
                        'ssmlMessage': {
                            'value': 'string'
                        },
                        'imageResponseCard': {
                            'title': 'string',
                            'subtitle': 'string',
                            'imageUrl': 'string',
                            'buttons': [
                                {
                                    'text': 'string',
                                    'value': 'string'
                                },
                            ]
                        }
                    },
                    'variations': [
                        {
                            'plainTextMessage': {
                                'value': 'string'
                            },
                            'customPayload': {
                                'value': 'string'
                            },
                            'ssmlMessage': {
                                'value': 'string'
                            },
                            'imageResponseCard': {
                                'title': 'string',
                                'subtitle': 'string',
                                'imageUrl': 'string',
                                'buttons': [
                                    {
                                        'text': 'string',
                                        'value': 'string'
                                    },
                                ]
                            }
                        },
                    ]
                },
            ],
            'maxRetries': 123,
            'allowInterrupt': True|False
        },
        'declinationResponse': {
            'messageGroups': [
                {
                    'message': {
                        'plainTextMessage': {
                            'value': 'string'
                        },
                        'customPayload': {
                            'value': 'string'
                        },
                        'ssmlMessage': {
                            'value': 'string'
                        },
                        'imageResponseCard': {
                            'title': 'string',
                            'subtitle': 'string',
                            'imageUrl': 'string',
                            'buttons': [
                                {
                                    'text': 'string',
                                    'value': 'string'
                                },
                            ]
                        }
                    },
                    'variations': [
                        {
                            'plainTextMessage': {
                                'value': 'string'
                            },
                            'customPayload': {
                                'value': 'string'
                            },
                            'ssmlMessage': {
                                'value': 'string'
                            },
                            'imageResponseCard': {
                                'title': 'string',
                                'subtitle': 'string',
                                'imageUrl': 'string',
                                'buttons': [
                                    {
                                        'text': 'string',
                                        'value': 'string'
                                    },
                                ]
                            }
                        },
                    ]
                },
            ],
            'allowInterrupt': True|False
        },
        'active': True|False
    },
    'intentClosingSetting': {
        'closingResponse': {
            'messageGroups': [
                {
                    'message': {
                        'plainTextMessage': {
                            'value': 'string'
                        },
                        'customPayload': {
                            'value': 'string'
                        },
                        'ssmlMessage': {
                            'value': 'string'
                        },
                        'imageResponseCard': {
                            'title': 'string',
                            'subtitle': 'string',
                            'imageUrl': 'string',
                            'buttons': [
                                {
                                    'text': 'string',
                                    'value': 'string'
                                },
                            ]
                        }
                    },
                    'variations': [
                        {
                            'plainTextMessage': {
                                'value': 'string'
                            },
                            'customPayload': {
                                'value': 'string'
                            },
                            'ssmlMessage': {
                                'value': 'string'
                            },
                            'imageResponseCard': {
                                'title': 'string',
                                'subtitle': 'string',
                                'imageUrl': 'string',
                                'buttons': [
                                    {
                                        'text': 'string',
                                        'value': 'string'
                                    },
                                ]
                            }
                        },
                    ]
                },
            ],
            'allowInterrupt': True|False
        },
        'active': True|False
    },
    'inputContexts': [
        {
            'name': 'string'
        },
    ],
    'outputContexts': [
        {
            'name': 'string',
            'timeToLiveInSeconds': 123,
            'turnsToLive': 123
        },
    ],
    'kendraConfiguration': {
        'kendraIndex': 'string',
        'queryFilterStringEnabled': True|False,
        'queryFilterString': 'string'
    },
    'botId': 'string',
    'botVersion': 'string',
    'localeId': 'string',
    'creationDateTime': datetime(2015, 1, 1),
    'lastUpdatedDateTime': datetime(2015, 1, 1)
}

Response Structure

  • (dict) --

    • intentId (string) --

      The unique identifier assigned to the intent when it was created.

    • intentName (string) --

      The name specified for the intent.

    • description (string) --

      The description of the intent.

    • parentIntentSignature (string) --

      The identifier of the built-in intent that this intent is derived from, if any.

    • sampleUtterances (list) --

      User utterances that trigger this intent.

      • (dict) --

        A sample utterance that invokes an intent or respond to a slot elicitation prompt.

        • utterance (string) --

          The sample utterance that Amazon Lex uses to build its machine-learning model to recognize intents.

    • dialogCodeHook (dict) --

      The Lambda function called during each turn of a conversation with the intent.

      • enabled (boolean) --

        Enables the dialog code hook so that it processes user requests.

    • fulfillmentCodeHook (dict) --

      The Lambda function called when the intent is complete and ready for fulfillment.

      • enabled (boolean) --

        Indicates whether a Lambda function should be invoked to fulfill a specific intent.

    • slotPriorities (list) --

      The list that determines the priority that slots should be elicited from the user.

      • (dict) --

        Sets the priority that Amazon Lex should use when eliciting slot values from a user.

        • priority (integer) --

          The priority that a slot should be elicited.

        • slotId (string) --

          The unique identifier of the slot.

    • intentConfirmationSetting (dict) --

      Prompts that Amazon Lex sends to the user to confirm completion of an intent.

      • promptSpecification (dict) --

        Prompts the user to confirm the intent. This question should have a yes or no answer.

        Amazon Lex uses this prompt to ensure that the user acknowledges that the intent is ready for fulfillment. For example, with the OrderPizza intent, you might want to confirm that the order is correct before placing it. For other intents, such as intents that simply respond to user questions, you might not need to ask the user for confirmation before providing the information.

        • messageGroups (list) --

          A collection of messages that Amazon Lex can send to the user. Amazon Lex chooses the actual message to send at runtime.

          • (dict) --

            Provides one or more messages that Amazon Lex should send to the user.

            • message (dict) --

              The primary message that Amazon Lex should send to the user.

              • plainTextMessage (dict) --

                A message in plain text format.

                • value (string) --

                  The message to send to the user.

              • customPayload (dict) --

                A message in a custom format defined by the client application.

                • value (string) --

                  The string that is sent to your application.

              • ssmlMessage (dict) --

                A message in Speech Synthesis Markup Language (SSML).

                • value (string) --

                  The SSML text that defines the prompt.

              • imageResponseCard (dict) --

                A message that defines a response card that the client application can show to the user.

                • title (string) --

                  The title to display on the response card. The format of the title is determined by the platform displaying the response card.

                • subtitle (string) --

                  The subtitle to display on the response card. The format of the subtitle is determined by the platform displaying the response card.

                • imageUrl (string) --

                  The URL of an image to display on the response card. The image URL must be publicly available so that the platform displaying the response card has access to the image.

                • buttons (list) --

                  A list of buttons that should be displayed on the response card. The arrangement of the buttons is determined by the platform that displays the button.

                  • (dict) --

                    Describes a button to use on a response card used to gather slot values from a user.

                    • text (string) --

                      The text that appears on the button. Use this to tell the user what value is returned when they choose this button.

                    • value (string) --

                      The value returned to Amazon Lex when the user chooses this button. This must be one of the slot values configured for the slot.

            • variations (list) --

              Message variations to send to the user. When variations are defined, Amazon Lex chooses the primary message or one of the variations to send to the user.

              • (dict) --

                The object that provides message text and it's type.

                • plainTextMessage (dict) --

                  A message in plain text format.

                  • value (string) --

                    The message to send to the user.

                • customPayload (dict) --

                  A message in a custom format defined by the client application.

                  • value (string) --

                    The string that is sent to your application.

                • ssmlMessage (dict) --

                  A message in Speech Synthesis Markup Language (SSML).

                  • value (string) --

                    The SSML text that defines the prompt.

                • imageResponseCard (dict) --

                  A message that defines a response card that the client application can show to the user.

                  • title (string) --

                    The title to display on the response card. The format of the title is determined by the platform displaying the response card.

                  • subtitle (string) --

                    The subtitle to display on the response card. The format of the subtitle is determined by the platform displaying the response card.

                  • imageUrl (string) --

                    The URL of an image to display on the response card. The image URL must be publicly available so that the platform displaying the response card has access to the image.

                  • buttons (list) --

                    A list of buttons that should be displayed on the response card. The arrangement of the buttons is determined by the platform that displays the button.

                    • (dict) --

                      Describes a button to use on a response card used to gather slot values from a user.

                      • text (string) --

                        The text that appears on the button. Use this to tell the user what value is returned when they choose this button.

                      • value (string) --

                        The value returned to Amazon Lex when the user chooses this button. This must be one of the slot values configured for the slot.

        • maxRetries (integer) --

          The maximum number of times the bot tries to elicit a resonse from the user using this prompt.

        • allowInterrupt (boolean) --

          Indicates whether the user can interrupt a speech prompt from the bot.

      • declinationResponse (dict) --

        When the user answers "no" to the question defined in promptSpecification , Amazon Lex responds with this response to acknowledge that the intent was canceled.

        • messageGroups (list) --

          A collection of responses that Amazon Lex can send to the user. Amazon Lex chooses the actual response to send at runtime.

          • (dict) --

            Provides one or more messages that Amazon Lex should send to the user.

            • message (dict) --

              The primary message that Amazon Lex should send to the user.

              • plainTextMessage (dict) --

                A message in plain text format.

                • value (string) --

                  The message to send to the user.

              • customPayload (dict) --

                A message in a custom format defined by the client application.

                • value (string) --

                  The string that is sent to your application.

              • ssmlMessage (dict) --

                A message in Speech Synthesis Markup Language (SSML).

                • value (string) --

                  The SSML text that defines the prompt.

              • imageResponseCard (dict) --

                A message that defines a response card that the client application can show to the user.

                • title (string) --

                  The title to display on the response card. The format of the title is determined by the platform displaying the response card.

                • subtitle (string) --

                  The subtitle to display on the response card. The format of the subtitle is determined by the platform displaying the response card.

                • imageUrl (string) --

                  The URL of an image to display on the response card. The image URL must be publicly available so that the platform displaying the response card has access to the image.

                • buttons (list) --

                  A list of buttons that should be displayed on the response card. The arrangement of the buttons is determined by the platform that displays the button.

                  • (dict) --

                    Describes a button to use on a response card used to gather slot values from a user.

                    • text (string) --

                      The text that appears on the button. Use this to tell the user what value is returned when they choose this button.

                    • value (string) --

                      The value returned to Amazon Lex when the user chooses this button. This must be one of the slot values configured for the slot.

            • variations (list) --

              Message variations to send to the user. When variations are defined, Amazon Lex chooses the primary message or one of the variations to send to the user.

              • (dict) --

                The object that provides message text and it's type.

                • plainTextMessage (dict) --

                  A message in plain text format.

                  • value (string) --

                    The message to send to the user.

                • customPayload (dict) --

                  A message in a custom format defined by the client application.

                  • value (string) --

                    The string that is sent to your application.

                • ssmlMessage (dict) --

                  A message in Speech Synthesis Markup Language (SSML).

                  • value (string) --

                    The SSML text that defines the prompt.

                • imageResponseCard (dict) --

                  A message that defines a response card that the client application can show to the user.

                  • title (string) --

                    The title to display on the response card. The format of the title is determined by the platform displaying the response card.

                  • subtitle (string) --

                    The subtitle to display on the response card. The format of the subtitle is determined by the platform displaying the response card.

                  • imageUrl (string) --

                    The URL of an image to display on the response card. The image URL must be publicly available so that the platform displaying the response card has access to the image.

                  • buttons (list) --

                    A list of buttons that should be displayed on the response card. The arrangement of the buttons is determined by the platform that displays the button.

                    • (dict) --

                      Describes a button to use on a response card used to gather slot values from a user.

                      • text (string) --

                        The text that appears on the button. Use this to tell the user what value is returned when they choose this button.

                      • value (string) --

                        The value returned to Amazon Lex when the user chooses this button. This must be one of the slot values configured for the slot.

        • allowInterrupt (boolean) --

          Indicates whether the user can interrupt a speech response from Amazon Lex.

      • active (boolean) --

        Specifies whether the intent's confirmation is sent to the user. When this field is false, confirmation and declination responses aren't sent and processing continues as if the responses aren't present. If the active field isn't specified, the default is true.

    • intentClosingSetting (dict) --

      The response that Amazon Lex sends to when the intent is closed.

      • closingResponse (dict) --

        The response that Amazon Lex sends to the user when the intent is complete.

        • messageGroups (list) --

          A collection of responses that Amazon Lex can send to the user. Amazon Lex chooses the actual response to send at runtime.

          • (dict) --

            Provides one or more messages that Amazon Lex should send to the user.

            • message (dict) --

              The primary message that Amazon Lex should send to the user.

              • plainTextMessage (dict) --

                A message in plain text format.

                • value (string) --

                  The message to send to the user.

              • customPayload (dict) --

                A message in a custom format defined by the client application.

                • value (string) --

                  The string that is sent to your application.

              • ssmlMessage (dict) --

                A message in Speech Synthesis Markup Language (SSML).

                • value (string) --

                  The SSML text that defines the prompt.

              • imageResponseCard (dict) --

                A message that defines a response card that the client application can show to the user.

                • title (string) --

                  The title to display on the response card. The format of the title is determined by the platform displaying the response card.

                • subtitle (string) --

                  The subtitle to display on the response card. The format of the subtitle is determined by the platform displaying the response card.

                • imageUrl (string) --

                  The URL of an image to display on the response card. The image URL must be publicly available so that the platform displaying the response card has access to the image.

                • buttons (list) --

                  A list of buttons that should be displayed on the response card. The arrangement of the buttons is determined by the platform that displays the button.

                  • (dict) --

                    Describes a button to use on a response card used to gather slot values from a user.

                    • text (string) --

                      The text that appears on the button. Use this to tell the user what value is returned when they choose this button.

                    • value (string) --

                      The value returned to Amazon Lex when the user chooses this button. This must be one of the slot values configured for the slot.

            • variations (list) --

              Message variations to send to the user. When variations are defined, Amazon Lex chooses the primary message or one of the variations to send to the user.

              • (dict) --

                The object that provides message text and it's type.

                • plainTextMessage (dict) --

                  A message in plain text format.

                  • value (string) --

                    The message to send to the user.

                • customPayload (dict) --

                  A message in a custom format defined by the client application.

                  • value (string) --

                    The string that is sent to your application.

                • ssmlMessage (dict) --

                  A message in Speech Synthesis Markup Language (SSML).

                  • value (string) --

                    The SSML text that defines the prompt.

                • imageResponseCard (dict) --

                  A message that defines a response card that the client application can show to the user.

                  • title (string) --

                    The title to display on the response card. The format of the title is determined by the platform displaying the response card.

                  • subtitle (string) --

                    The subtitle to display on the response card. The format of the subtitle is determined by the platform displaying the response card.

                  • imageUrl (string) --

                    The URL of an image to display on the response card. The image URL must be publicly available so that the platform displaying the response card has access to the image.

                  • buttons (list) --

                    A list of buttons that should be displayed on the response card. The arrangement of the buttons is determined by the platform that displays the button.

                    • (dict) --

                      Describes a button to use on a response card used to gather slot values from a user.

                      • text (string) --

                        The text that appears on the button. Use this to tell the user what value is returned when they choose this button.

                      • value (string) --

                        The value returned to Amazon Lex when the user chooses this button. This must be one of the slot values configured for the slot.

        • allowInterrupt (boolean) --

          Indicates whether the user can interrupt a speech response from Amazon Lex.

      • active (boolean) --

        Specifies whether an intent's closing response is used. When this field is false, the closing response isn't sent to the user and no closing input from the user is used. If the active field isn't specified, the default is true.

    • inputContexts (list) --

      A list of contexts that must be active for the intent to be considered for sending to the user.

      • (dict) --

        The name of a context that must be active for an intent to be selected by Amazon Lex.

        • name (string) --

          The name of the context.

    • outputContexts (list) --

      A list of contexts that are activated when the intent is fulfilled.

      • (dict) --

        Describes a session context that is activated when an intent is fulfilled.

        • name (string) --

          The name of the output context.

        • timeToLiveInSeconds (integer) --

          The amount of time, in seconds, that the output context should remain active. The time is figured from the first time the context is sent to the user.

        • turnsToLive (integer) --

          The number of conversation turns that the output context should remain active. The number of turns is counted from the first time that the context is sent to the user.

    • kendraConfiguration (dict) --

      Configuration information required to use the AMAZON.KendraSearchIntent intent.

      • kendraIndex (string) --

        The Amazon Resource Name (ARN) of the Amazon Kendra index that you want the AMAZON.KendraSearchIntent intent to search. The index must be in the same account and Region as the Amazon Lex bot.

      • queryFilterStringEnabled (boolean) --

        Determines whether the AMAZON.KendraSearchIntent intent uses a custom query string to query the Amazon Kendra index.

      • queryFilterString (string) --

        A query filter that Amazon Lex sends to Amazon Kendra to filter the response from a query. The filter is in the format defined by Amazon Kendra. For more information, see Filtering queries.

    • botId (string) --

      The identifier of the bot associated with the intent.

    • botVersion (string) --

      The version of the bot associated with the intent.

    • localeId (string) --

      The language and locale specified for the intent.

    • creationDateTime (datetime) --

      A timestamp of the date and time that the intent was created.

    • lastUpdatedDateTime (datetime) --

      A timestamp of the date and time that the intent was last updated.

DescribeSlot (updated) Link ΒΆ
Changes (response)
{'valueElicitationSetting': {'waitAndContinueSpecification': {'active': 'boolean'}}}

Gets metadata information about a slot.

See also: AWS API Documentation

Request Syntax

client.describe_slot(
    slotId='string',
    botId='string',
    botVersion='string',
    localeId='string',
    intentId='string'
)
type slotId

string

param slotId

[REQUIRED]

The unique identifier for the slot.

type botId

string

param botId

[REQUIRED]

The identifier of the bot associated with the slot.

type botVersion

string

param botVersion

[REQUIRED]

The version of the bot associated with the slot.

type localeId

string

param localeId

[REQUIRED]

The identifier of the language and locale of the slot to describe. The string must match one of the supported locales. For more information, see Supported languages.

type intentId

string

param intentId

[REQUIRED]

The identifier of the intent that contains the slot.

rtype

dict

returns

Response Syntax

{
    'slotId': 'string',
    'slotName': 'string',
    'description': 'string',
    'slotTypeId': 'string',
    'valueElicitationSetting': {
        'defaultValueSpecification': {
            'defaultValueList': [
                {
                    'defaultValue': 'string'
                },
            ]
        },
        'slotConstraint': 'Required'|'Optional',
        'promptSpecification': {
            'messageGroups': [
                {
                    'message': {
                        'plainTextMessage': {
                            'value': 'string'
                        },
                        'customPayload': {
                            'value': 'string'
                        },
                        'ssmlMessage': {
                            'value': 'string'
                        },
                        'imageResponseCard': {
                            'title': 'string',
                            'subtitle': 'string',
                            'imageUrl': 'string',
                            'buttons': [
                                {
                                    'text': 'string',
                                    'value': 'string'
                                },
                            ]
                        }
                    },
                    'variations': [
                        {
                            'plainTextMessage': {
                                'value': 'string'
                            },
                            'customPayload': {
                                'value': 'string'
                            },
                            'ssmlMessage': {
                                'value': 'string'
                            },
                            'imageResponseCard': {
                                'title': 'string',
                                'subtitle': 'string',
                                'imageUrl': 'string',
                                'buttons': [
                                    {
                                        'text': 'string',
                                        'value': 'string'
                                    },
                                ]
                            }
                        },
                    ]
                },
            ],
            'maxRetries': 123,
            'allowInterrupt': True|False
        },
        'sampleUtterances': [
            {
                'utterance': 'string'
            },
        ],
        'waitAndContinueSpecification': {
            'waitingResponse': {
                'messageGroups': [
                    {
                        'message': {
                            'plainTextMessage': {
                                'value': 'string'
                            },
                            'customPayload': {
                                'value': 'string'
                            },
                            'ssmlMessage': {
                                'value': 'string'
                            },
                            'imageResponseCard': {
                                'title': 'string',
                                'subtitle': 'string',
                                'imageUrl': 'string',
                                'buttons': [
                                    {
                                        'text': 'string',
                                        'value': 'string'
                                    },
                                ]
                            }
                        },
                        'variations': [
                            {
                                'plainTextMessage': {
                                    'value': 'string'
                                },
                                'customPayload': {
                                    'value': 'string'
                                },
                                'ssmlMessage': {
                                    'value': 'string'
                                },
                                'imageResponseCard': {
                                    'title': 'string',
                                    'subtitle': 'string',
                                    'imageUrl': 'string',
                                    'buttons': [
                                        {
                                            'text': 'string',
                                            'value': 'string'
                                        },
                                    ]
                                }
                            },
                        ]
                    },
                ],
                'allowInterrupt': True|False
            },
            'continueResponse': {
                'messageGroups': [
                    {
                        'message': {
                            'plainTextMessage': {
                                'value': 'string'
                            },
                            'customPayload': {
                                'value': 'string'
                            },
                            'ssmlMessage': {
                                'value': 'string'
                            },
                            'imageResponseCard': {
                                'title': 'string',
                                'subtitle': 'string',
                                'imageUrl': 'string',
                                'buttons': [
                                    {
                                        'text': 'string',
                                        'value': 'string'
                                    },
                                ]
                            }
                        },
                        'variations': [
                            {
                                'plainTextMessage': {
                                    'value': 'string'
                                },
                                'customPayload': {
                                    'value': 'string'
                                },
                                'ssmlMessage': {
                                    'value': 'string'
                                },
                                'imageResponseCard': {
                                    'title': 'string',
                                    'subtitle': 'string',
                                    'imageUrl': 'string',
                                    'buttons': [
                                        {
                                            'text': 'string',
                                            'value': 'string'
                                        },
                                    ]
                                }
                            },
                        ]
                    },
                ],
                'allowInterrupt': True|False
            },
            'stillWaitingResponse': {
                'messageGroups': [
                    {
                        'message': {
                            'plainTextMessage': {
                                'value': 'string'
                            },
                            'customPayload': {
                                'value': 'string'
                            },
                            'ssmlMessage': {
                                'value': 'string'
                            },
                            'imageResponseCard': {
                                'title': 'string',
                                'subtitle': 'string',
                                'imageUrl': 'string',
                                'buttons': [
                                    {
                                        'text': 'string',
                                        'value': 'string'
                                    },
                                ]
                            }
                        },
                        'variations': [
                            {
                                'plainTextMessage': {
                                    'value': 'string'
                                },
                                'customPayload': {
                                    'value': 'string'
                                },
                                'ssmlMessage': {
                                    'value': 'string'
                                },
                                'imageResponseCard': {
                                    'title': 'string',
                                    'subtitle': 'string',
                                    'imageUrl': 'string',
                                    'buttons': [
                                        {
                                            'text': 'string',
                                            'value': 'string'
                                        },
                                    ]
                                }
                            },
                        ]
                    },
                ],
                'frequencyInSeconds': 123,
                'timeoutInSeconds': 123,
                'allowInterrupt': True|False
            },
            'active': True|False
        }
    },
    'obfuscationSetting': {
        'obfuscationSettingType': 'None'|'DefaultObfuscation'
    },
    'botId': 'string',
    'botVersion': 'string',
    'localeId': 'string',
    'intentId': 'string',
    'creationDateTime': datetime(2015, 1, 1),
    'lastUpdatedDateTime': datetime(2015, 1, 1),
    'multipleValuesSetting': {
        'allowMultipleValues': True|False
    }
}

Response Structure

  • (dict) --

    • slotId (string) --

      The unique identifier generated for the slot.

    • slotName (string) --

      The name specified for the slot.

    • description (string) --

      The description specified for the slot.

    • slotTypeId (string) --

      The identifier of the slot type that determines the values entered into the slot.

    • valueElicitationSetting (dict) --

      Prompts that Amazon Lex uses to elicit a value for the slot.

      • defaultValueSpecification (dict) --

        A list of default values for a slot. Default values are used when Amazon Lex hasn't determined a value for a slot. You can specify default values from context variables, sesion attributes, and defined values.

        • defaultValueList (list) --

          A list of default values. Amazon Lex chooses the default value to use in the order that they are presented in the list.

          • (dict) --

            Specifies the default value to use when a user doesn't provide a value for a slot.

            • defaultValue (string) --

              The default value to use when a user doesn't provide a value for a slot.

      • slotConstraint (string) --

        Specifies whether the slot is required or optional.

      • promptSpecification (dict) --

        The prompt that Amazon Lex uses to elicit the slot value from the user.

        • messageGroups (list) --

          A collection of messages that Amazon Lex can send to the user. Amazon Lex chooses the actual message to send at runtime.

          • (dict) --

            Provides one or more messages that Amazon Lex should send to the user.

            • message (dict) --

              The primary message that Amazon Lex should send to the user.

              • plainTextMessage (dict) --

                A message in plain text format.

                • value (string) --

                  The message to send to the user.

              • customPayload (dict) --

                A message in a custom format defined by the client application.

                • value (string) --

                  The string that is sent to your application.

              • ssmlMessage (dict) --

                A message in Speech Synthesis Markup Language (SSML).

                • value (string) --

                  The SSML text that defines the prompt.

              • imageResponseCard (dict) --

                A message that defines a response card that the client application can show to the user.

                • title (string) --

                  The title to display on the response card. The format of the title is determined by the platform displaying the response card.

                • subtitle (string) --

                  The subtitle to display on the response card. The format of the subtitle is determined by the platform displaying the response card.

                • imageUrl (string) --

                  The URL of an image to display on the response card. The image URL must be publicly available so that the platform displaying the response card has access to the image.

                • buttons (list) --

                  A list of buttons that should be displayed on the response card. The arrangement of the buttons is determined by the platform that displays the button.

                  • (dict) --

                    Describes a button to use on a response card used to gather slot values from a user.

                    • text (string) --

                      The text that appears on the button. Use this to tell the user what value is returned when they choose this button.

                    • value (string) --

                      The value returned to Amazon Lex when the user chooses this button. This must be one of the slot values configured for the slot.

            • variations (list) --

              Message variations to send to the user. When variations are defined, Amazon Lex chooses the primary message or one of the variations to send to the user.

              • (dict) --

                The object that provides message text and it's type.

                • plainTextMessage (dict) --

                  A message in plain text format.

                  • value (string) --

                    The message to send to the user.

                • customPayload (dict) --

                  A message in a custom format defined by the client application.

                  • value (string) --

                    The string that is sent to your application.

                • ssmlMessage (dict) --

                  A message in Speech Synthesis Markup Language (SSML).

                  • value (string) --

                    The SSML text that defines the prompt.

                • imageResponseCard (dict) --

                  A message that defines a response card that the client application can show to the user.

                  • title (string) --

                    The title to display on the response card. The format of the title is determined by the platform displaying the response card.

                  • subtitle (string) --

                    The subtitle to display on the response card. The format of the subtitle is determined by the platform displaying the response card.

                  • imageUrl (string) --

                    The URL of an image to display on the response card. The image URL must be publicly available so that the platform displaying the response card has access to the image.

                  • buttons (list) --

                    A list of buttons that should be displayed on the response card. The arrangement of the buttons is determined by the platform that displays the button.

                    • (dict) --

                      Describes a button to use on a response card used to gather slot values from a user.

                      • text (string) --

                        The text that appears on the button. Use this to tell the user what value is returned when they choose this button.

                      • value (string) --

                        The value returned to Amazon Lex when the user chooses this button. This must be one of the slot values configured for the slot.

        • maxRetries (integer) --

          The maximum number of times the bot tries to elicit a resonse from the user using this prompt.

        • allowInterrupt (boolean) --

          Indicates whether the user can interrupt a speech prompt from the bot.

      • sampleUtterances (list) --

        If you know a specific pattern that users might respond to an Amazon Lex request for a slot value, you can provide those utterances to improve accuracy. This is optional. In most cases, Amazon Lex is capable of understanding user utterances.

        • (dict) --

          A sample utterance that invokes an intent or respond to a slot elicitation prompt.

          • utterance (string) --

            The sample utterance that Amazon Lex uses to build its machine-learning model to recognize intents.

      • waitAndContinueSpecification (dict) --

        Specifies the prompts that Amazon Lex uses while a bot is waiting for customer input.

        • waitingResponse (dict) --

          The response that Amazon Lex sends to indicate that the bot is waiting for the conversation to continue.

          • messageGroups (list) --

            A collection of responses that Amazon Lex can send to the user. Amazon Lex chooses the actual response to send at runtime.

            • (dict) --

              Provides one or more messages that Amazon Lex should send to the user.

              • message (dict) --

                The primary message that Amazon Lex should send to the user.

                • plainTextMessage (dict) --

                  A message in plain text format.

                  • value (string) --

                    The message to send to the user.

                • customPayload (dict) --

                  A message in a custom format defined by the client application.

                  • value (string) --

                    The string that is sent to your application.

                • ssmlMessage (dict) --

                  A message in Speech Synthesis Markup Language (SSML).

                  • value (string) --

                    The SSML text that defines the prompt.

                • imageResponseCard (dict) --

                  A message that defines a response card that the client application can show to the user.

                  • title (string) --

                    The title to display on the response card. The format of the title is determined by the platform displaying the response card.

                  • subtitle (string) --

                    The subtitle to display on the response card. The format of the subtitle is determined by the platform displaying the response card.

                  • imageUrl (string) --

                    The URL of an image to display on the response card. The image URL must be publicly available so that the platform displaying the response card has access to the image.

                  • buttons (list) --

                    A list of buttons that should be displayed on the response card. The arrangement of the buttons is determined by the platform that displays the button.

                    • (dict) --

                      Describes a button to use on a response card used to gather slot values from a user.

                      • text (string) --

                        The text that appears on the button. Use this to tell the user what value is returned when they choose this button.

                      • value (string) --

                        The value returned to Amazon Lex when the user chooses this button. This must be one of the slot values configured for the slot.

              • variations (list) --

                Message variations to send to the user. When variations are defined, Amazon Lex chooses the primary message or one of the variations to send to the user.

                • (dict) --

                  The object that provides message text and it's type.

                  • plainTextMessage (dict) --

                    A message in plain text format.

                    • value (string) --

                      The message to send to the user.

                  • customPayload (dict) --

                    A message in a custom format defined by the client application.

                    • value (string) --

                      The string that is sent to your application.

                  • ssmlMessage (dict) --

                    A message in Speech Synthesis Markup Language (SSML).

                    • value (string) --

                      The SSML text that defines the prompt.

                  • imageResponseCard (dict) --

                    A message that defines a response card that the client application can show to the user.

                    • title (string) --

                      The title to display on the response card. The format of the title is determined by the platform displaying the response card.

                    • subtitle (string) --

                      The subtitle to display on the response card. The format of the subtitle is determined by the platform displaying the response card.

                    • imageUrl (string) --

                      The URL of an image to display on the response card. The image URL must be publicly available so that the platform displaying the response card has access to the image.

                    • buttons (list) --

                      A list of buttons that should be displayed on the response card. The arrangement of the buttons is determined by the platform that displays the button.

                      • (dict) --

                        Describes a button to use on a response card used to gather slot values from a user.

                        • text (string) --

                          The text that appears on the button. Use this to tell the user what value is returned when they choose this button.

                        • value (string) --

                          The value returned to Amazon Lex when the user chooses this button. This must be one of the slot values configured for the slot.

          • allowInterrupt (boolean) --

            Indicates whether the user can interrupt a speech response from Amazon Lex.

        • continueResponse (dict) --

          The response that Amazon Lex sends to indicate that the bot is ready to continue the conversation.

          • messageGroups (list) --

            A collection of responses that Amazon Lex can send to the user. Amazon Lex chooses the actual response to send at runtime.

            • (dict) --

              Provides one or more messages that Amazon Lex should send to the user.

              • message (dict) --

                The primary message that Amazon Lex should send to the user.

                • plainTextMessage (dict) --

                  A message in plain text format.

                  • value (string) --

                    The message to send to the user.

                • customPayload (dict) --

                  A message in a custom format defined by the client application.

                  • value (string) --

                    The string that is sent to your application.

                • ssmlMessage (dict) --

                  A message in Speech Synthesis Markup Language (SSML).

                  • value (string) --

                    The SSML text that defines the prompt.

                • imageResponseCard (dict) --

                  A message that defines a response card that the client application can show to the user.

                  • title (string) --

                    The title to display on the response card. The format of the title is determined by the platform displaying the response card.

                  • subtitle (string) --

                    The subtitle to display on the response card. The format of the subtitle is determined by the platform displaying the response card.

                  • imageUrl (string) --

                    The URL of an image to display on the response card. The image URL must be publicly available so that the platform displaying the response card has access to the image.

                  • buttons (list) --

                    A list of buttons that should be displayed on the response card. The arrangement of the buttons is determined by the platform that displays the button.

                    • (dict) --

                      Describes a button to use on a response card used to gather slot values from a user.

                      • text (string) --

                        The text that appears on the button. Use this to tell the user what value is returned when they choose this button.

                      • value (string) --

                        The value returned to Amazon Lex when the user chooses this button. This must be one of the slot values configured for the slot.

              • variations (list) --

                Message variations to send to the user. When variations are defined, Amazon Lex chooses the primary message or one of the variations to send to the user.

                • (dict) --

                  The object that provides message text and it's type.

                  • plainTextMessage (dict) --

                    A message in plain text format.

                    • value (string) --

                      The message to send to the user.

                  • customPayload (dict) --

                    A message in a custom format defined by the client application.

                    • value (string) --

                      The string that is sent to your application.

                  • ssmlMessage (dict) --

                    A message in Speech Synthesis Markup Language (SSML).

                    • value (string) --

                      The SSML text that defines the prompt.

                  • imageResponseCard (dict) --

                    A message that defines a response card that the client application can show to the user.

                    • title (string) --

                      The title to display on the response card. The format of the title is determined by the platform displaying the response card.

                    • subtitle (string) --

                      The subtitle to display on the response card. The format of the subtitle is determined by the platform displaying the response card.

                    • imageUrl (string) --

                      The URL of an image to display on the response card. The image URL must be publicly available so that the platform displaying the response card has access to the image.

                    • buttons (list) --

                      A list of buttons that should be displayed on the response card. The arrangement of the buttons is determined by the platform that displays the button.

                      • (dict) --

                        Describes a button to use on a response card used to gather slot values from a user.

                        • text (string) --

                          The text that appears on the button. Use this to tell the user what value is returned when they choose this button.

                        • value (string) --

                          The value returned to Amazon Lex when the user chooses this button. This must be one of the slot values configured for the slot.

          • allowInterrupt (boolean) --

            Indicates whether the user can interrupt a speech response from Amazon Lex.

        • stillWaitingResponse (dict) --

          A response that Amazon Lex sends periodically to the user to indicate that the bot is still waiting for input from the user.

          • messageGroups (list) --

            One or more message groups, each containing one or more messages, that define the prompts that Amazon Lex sends to the user.

            • (dict) --

              Provides one or more messages that Amazon Lex should send to the user.

              • message (dict) --

                The primary message that Amazon Lex should send to the user.

                • plainTextMessage (dict) --

                  A message in plain text format.

                  • value (string) --

                    The message to send to the user.

                • customPayload (dict) --

                  A message in a custom format defined by the client application.

                  • value (string) --

                    The string that is sent to your application.

                • ssmlMessage (dict) --

                  A message in Speech Synthesis Markup Language (SSML).

                  • value (string) --

                    The SSML text that defines the prompt.

                • imageResponseCard (dict) --

                  A message that defines a response card that the client application can show to the user.

                  • title (string) --

                    The title to display on the response card. The format of the title is determined by the platform displaying the response card.

                  • subtitle (string) --

                    The subtitle to display on the response card. The format of the subtitle is determined by the platform displaying the response card.

                  • imageUrl (string) --

                    The URL of an image to display on the response card. The image URL must be publicly available so that the platform displaying the response card has access to the image.

                  • buttons (list) --

                    A list of buttons that should be displayed on the response card. The arrangement of the buttons is determined by the platform that displays the button.

                    • (dict) --

                      Describes a button to use on a response card used to gather slot values from a user.

                      • text (string) --

                        The text that appears on the button. Use this to tell the user what value is returned when they choose this button.

                      • value (string) --

                        The value returned to Amazon Lex when the user chooses this button. This must be one of the slot values configured for the slot.

              • variations (list) --

                Message variations to send to the user. When variations are defined, Amazon Lex chooses the primary message or one of the variations to send to the user.

                • (dict) --

                  The object that provides message text and it's type.

                  • plainTextMessage (dict) --

                    A message in plain text format.

                    • value (string) --

                      The message to send to the user.

                  • customPayload (dict) --

                    A message in a custom format defined by the client application.

                    • value (string) --

                      The string that is sent to your application.

                  • ssmlMessage (dict) --

                    A message in Speech Synthesis Markup Language (SSML).

                    • value (string) --

                      The SSML text that defines the prompt.

                  • imageResponseCard (dict) --

                    A message that defines a response card that the client application can show to the user.

                    • title (string) --

                      The title to display on the response card. The format of the title is determined by the platform displaying the response card.

                    • subtitle (string) --

                      The subtitle to display on the response card. The format of the subtitle is determined by the platform displaying the response card.

                    • imageUrl (string) --

                      The URL of an image to display on the response card. The image URL must be publicly available so that the platform displaying the response card has access to the image.

                    • buttons (list) --

                      A list of buttons that should be displayed on the response card. The arrangement of the buttons is determined by the platform that displays the button.

                      • (dict) --

                        Describes a button to use on a response card used to gather slot values from a user.

                        • text (string) --

                          The text that appears on the button. Use this to tell the user what value is returned when they choose this button.

                        • value (string) --

                          The value returned to Amazon Lex when the user chooses this button. This must be one of the slot values configured for the slot.

          • frequencyInSeconds (integer) --

            How often a message should be sent to the user. Minimum of 1 second, maximum of 5 minutes.

          • timeoutInSeconds (integer) --

            If Amazon Lex waits longer than this length of time for a response, it will stop sending messages.

          • allowInterrupt (boolean) --

            Indicates that the user can interrupt the response by speaking while the message is being played.

        • active (boolean) --

          Specifies whether the bot will wait for a user to respond. When this field is false, wait and continue responses for a slot aren't used and the bot expects an appropriate response within the configured timeout. If the active field isn't specified, the default is true.

    • obfuscationSetting (dict) --

      Whether slot values are shown in Amazon CloudWatch logs. If the value is None , the actual value of the slot is shown in logs.

      • obfuscationSettingType (string) --

        Value that determines whether Amazon Lex obscures slot values in conversation logs. The default is to obscure the values.

    • botId (string) --

      The identifier of the bot associated with the slot.

    • botVersion (string) --

      The version of the bot associated with the slot.

    • localeId (string) --

      The language and locale specified for the slot.

    • intentId (string) --

      The identifier of the intent associated with the slot.

    • creationDateTime (datetime) --

      A timestamp of the date and time that the slot was created.

    • lastUpdatedDateTime (datetime) --

      A timestamp of the date and time that the slot was last updated.

    • multipleValuesSetting (dict) --

      Indicates whether the slot accepts multiple values in a single utterance.

      If the multipleValuesSetting is not set, the default value is false .

      • allowMultipleValues (boolean) --

        Indicates whether a slot can return multiple values. When true , the slot may return more than one value in a response. When false , the slot returns only a single value.

        Multi-value slots are only available in the en-US locale. If you set this value to true in any other locale, Amazon Lex throws a ValidationException .

        If the allowMutlipleValues is not set, the default value is false .

UpdateIntent (updated) Link ΒΆ
Changes (both)
{'intentClosingSetting': {'active': 'boolean'},
 'intentConfirmationSetting': {'active': 'boolean'}}

Updates the settings for an intent.

See also: AWS API Documentation

Request Syntax

client.update_intent(
    intentId='string',
    intentName='string',
    description='string',
    parentIntentSignature='string',
    sampleUtterances=[
        {
            'utterance': 'string'
        },
    ],
    dialogCodeHook={
        'enabled': True|False
    },
    fulfillmentCodeHook={
        'enabled': True|False
    },
    slotPriorities=[
        {
            'priority': 123,
            'slotId': 'string'
        },
    ],
    intentConfirmationSetting={
        'promptSpecification': {
            'messageGroups': [
                {
                    'message': {
                        'plainTextMessage': {
                            'value': 'string'
                        },
                        'customPayload': {
                            'value': 'string'
                        },
                        'ssmlMessage': {
                            'value': 'string'
                        },
                        'imageResponseCard': {
                            'title': 'string',
                            'subtitle': 'string',
                            'imageUrl': 'string',
                            'buttons': [
                                {
                                    'text': 'string',
                                    'value': 'string'
                                },
                            ]
                        }
                    },
                    'variations': [
                        {
                            'plainTextMessage': {
                                'value': 'string'
                            },
                            'customPayload': {
                                'value': 'string'
                            },
                            'ssmlMessage': {
                                'value': 'string'
                            },
                            'imageResponseCard': {
                                'title': 'string',
                                'subtitle': 'string',
                                'imageUrl': 'string',
                                'buttons': [
                                    {
                                        'text': 'string',
                                        'value': 'string'
                                    },
                                ]
                            }
                        },
                    ]
                },
            ],
            'maxRetries': 123,
            'allowInterrupt': True|False
        },
        'declinationResponse': {
            'messageGroups': [
                {
                    'message': {
                        'plainTextMessage': {
                            'value': 'string'
                        },
                        'customPayload': {
                            'value': 'string'
                        },
                        'ssmlMessage': {
                            'value': 'string'
                        },
                        'imageResponseCard': {
                            'title': 'string',
                            'subtitle': 'string',
                            'imageUrl': 'string',
                            'buttons': [
                                {
                                    'text': 'string',
                                    'value': 'string'
                                },
                            ]
                        }
                    },
                    'variations': [
                        {
                            'plainTextMessage': {
                                'value': 'string'
                            },
                            'customPayload': {
                                'value': 'string'
                            },
                            'ssmlMessage': {
                                'value': 'string'
                            },
                            'imageResponseCard': {
                                'title': 'string',
                                'subtitle': 'string',
                                'imageUrl': 'string',
                                'buttons': [
                                    {
                                        'text': 'string',
                                        'value': 'string'
                                    },
                                ]
                            }
                        },
                    ]
                },
            ],
            'allowInterrupt': True|False
        },
        'active': True|False
    },
    intentClosingSetting={
        'closingResponse': {
            'messageGroups': [
                {
                    'message': {
                        'plainTextMessage': {
                            'value': 'string'
                        },
                        'customPayload': {
                            'value': 'string'
                        },
                        'ssmlMessage': {
                            'value': 'string'
                        },
                        'imageResponseCard': {
                            'title': 'string',
                            'subtitle': 'string',
                            'imageUrl': 'string',
                            'buttons': [
                                {
                                    'text': 'string',
                                    'value': 'string'
                                },
                            ]
                        }
                    },
                    'variations': [
                        {
                            'plainTextMessage': {
                                'value': 'string'
                            },
                            'customPayload': {
                                'value': 'string'
                            },
                            'ssmlMessage': {
                                'value': 'string'
                            },
                            'imageResponseCard': {
                                'title': 'string',
                                'subtitle': 'string',
                                'imageUrl': 'string',
                                'buttons': [
                                    {
                                        'text': 'string',
                                        'value': 'string'
                                    },
                                ]
                            }
                        },
                    ]
                },
            ],
            'allowInterrupt': True|False
        },
        'active': True|False
    },
    inputContexts=[
        {
            'name': 'string'
        },
    ],
    outputContexts=[
        {
            'name': 'string',
            'timeToLiveInSeconds': 123,
            'turnsToLive': 123
        },
    ],
    kendraConfiguration={
        'kendraIndex': 'string',
        'queryFilterStringEnabled': True|False,
        'queryFilterString': 'string'
    },
    botId='string',
    botVersion='string',
    localeId='string'
)
type intentId

string

param intentId

[REQUIRED]

The unique identifier of the intent to update.

type intentName

string

param intentName

[REQUIRED]

The new name for the intent.

type description

string

param description

The new description of the intent.

type parentIntentSignature

string

param parentIntentSignature

The signature of the new built-in intent to use as the parent of this intent.

type sampleUtterances

list

param sampleUtterances

New utterances used to invoke the intent.

  • (dict) --

    A sample utterance that invokes an intent or respond to a slot elicitation prompt.

    • utterance (string) -- [REQUIRED]

      The sample utterance that Amazon Lex uses to build its machine-learning model to recognize intents.

type dialogCodeHook

dict

param dialogCodeHook

The new Lambda function to use between each turn of the conversation with the bot.

  • enabled (boolean) -- [REQUIRED]

    Enables the dialog code hook so that it processes user requests.

type fulfillmentCodeHook

dict

param fulfillmentCodeHook

The new Lambda function to call when all of the intents required slots are provided and the intent is ready for fulfillment.

  • enabled (boolean) -- [REQUIRED]

    Indicates whether a Lambda function should be invoked to fulfill a specific intent.

type slotPriorities

list

param slotPriorities

A new list of slots and their priorities that are contained by the intent.

  • (dict) --

    Sets the priority that Amazon Lex should use when eliciting slot values from a user.

    • priority (integer) -- [REQUIRED]

      The priority that a slot should be elicited.

    • slotId (string) -- [REQUIRED]

      The unique identifier of the slot.

type intentConfirmationSetting

dict

param intentConfirmationSetting

New prompts that Amazon Lex sends to the user to confirm the completion of an intent.

  • promptSpecification (dict) -- [REQUIRED]

    Prompts the user to confirm the intent. This question should have a yes or no answer.

    Amazon Lex uses this prompt to ensure that the user acknowledges that the intent is ready for fulfillment. For example, with the OrderPizza intent, you might want to confirm that the order is correct before placing it. For other intents, such as intents that simply respond to user questions, you might not need to ask the user for confirmation before providing the information.

    • messageGroups (list) -- [REQUIRED]

      A collection of messages that Amazon Lex can send to the user. Amazon Lex chooses the actual message to send at runtime.

      • (dict) --

        Provides one or more messages that Amazon Lex should send to the user.

        • message (dict) -- [REQUIRED]

          The primary message that Amazon Lex should send to the user.

          • plainTextMessage (dict) --

            A message in plain text format.

            • value (string) -- [REQUIRED]

              The message to send to the user.

          • customPayload (dict) --

            A message in a custom format defined by the client application.

            • value (string) -- [REQUIRED]

              The string that is sent to your application.

          • ssmlMessage (dict) --

            A message in Speech Synthesis Markup Language (SSML).

            • value (string) -- [REQUIRED]

              The SSML text that defines the prompt.

          • imageResponseCard (dict) --

            A message that defines a response card that the client application can show to the user.

            • title (string) -- [REQUIRED]

              The title to display on the response card. The format of the title is determined by the platform displaying the response card.

            • subtitle (string) --

              The subtitle to display on the response card. The format of the subtitle is determined by the platform displaying the response card.

            • imageUrl (string) --

              The URL of an image to display on the response card. The image URL must be publicly available so that the platform displaying the response card has access to the image.

            • buttons (list) --

              A list of buttons that should be displayed on the response card. The arrangement of the buttons is determined by the platform that displays the button.

              • (dict) --

                Describes a button to use on a response card used to gather slot values from a user.

                • text (string) -- [REQUIRED]

                  The text that appears on the button. Use this to tell the user what value is returned when they choose this button.

                • value (string) -- [REQUIRED]

                  The value returned to Amazon Lex when the user chooses this button. This must be one of the slot values configured for the slot.

        • variations (list) --

          Message variations to send to the user. When variations are defined, Amazon Lex chooses the primary message or one of the variations to send to the user.

          • (dict) --

            The object that provides message text and it's type.

            • plainTextMessage (dict) --

              A message in plain text format.

              • value (string) -- [REQUIRED]

                The message to send to the user.

            • customPayload (dict) --

              A message in a custom format defined by the client application.

              • value (string) -- [REQUIRED]

                The string that is sent to your application.

            • ssmlMessage (dict) --

              A message in Speech Synthesis Markup Language (SSML).

              • value (string) -- [REQUIRED]

                The SSML text that defines the prompt.

            • imageResponseCard (dict) --

              A message that defines a response card that the client application can show to the user.

              • title (string) -- [REQUIRED]

                The title to display on the response card. The format of the title is determined by the platform displaying the response card.

              • subtitle (string) --

                The subtitle to display on the response card. The format of the subtitle is determined by the platform displaying the response card.

              • imageUrl (string) --

                The URL of an image to display on the response card. The image URL must be publicly available so that the platform displaying the response card has access to the image.

              • buttons (list) --

                A list of buttons that should be displayed on the response card. The arrangement of the buttons is determined by the platform that displays the button.

                • (dict) --

                  Describes a button to use on a response card used to gather slot values from a user.

                  • text (string) -- [REQUIRED]

                    The text that appears on the button. Use this to tell the user what value is returned when they choose this button.

                  • value (string) -- [REQUIRED]

                    The value returned to Amazon Lex when the user chooses this button. This must be one of the slot values configured for the slot.

    • maxRetries (integer) -- [REQUIRED]

      The maximum number of times the bot tries to elicit a resonse from the user using this prompt.

    • allowInterrupt (boolean) --

      Indicates whether the user can interrupt a speech prompt from the bot.

  • declinationResponse (dict) -- [REQUIRED]

    When the user answers "no" to the question defined in promptSpecification , Amazon Lex responds with this response to acknowledge that the intent was canceled.

    • messageGroups (list) -- [REQUIRED]

      A collection of responses that Amazon Lex can send to the user. Amazon Lex chooses the actual response to send at runtime.

      • (dict) --

        Provides one or more messages that Amazon Lex should send to the user.

        • message (dict) -- [REQUIRED]

          The primary message that Amazon Lex should send to the user.

          • plainTextMessage (dict) --

            A message in plain text format.

            • value (string) -- [REQUIRED]

              The message to send to the user.

          • customPayload (dict) --

            A message in a custom format defined by the client application.

            • value (string) -- [REQUIRED]

              The string that is sent to your application.

          • ssmlMessage (dict) --

            A message in Speech Synthesis Markup Language (SSML).

            • value (string) -- [REQUIRED]

              The SSML text that defines the prompt.

          • imageResponseCard (dict) --

            A message that defines a response card that the client application can show to the user.

            • title (string) -- [REQUIRED]

              The title to display on the response card. The format of the title is determined by the platform displaying the response card.

            • subtitle (string) --

              The subtitle to display on the response card. The format of the subtitle is determined by the platform displaying the response card.

            • imageUrl (string) --

              The URL of an image to display on the response card. The image URL must be publicly available so that the platform displaying the response card has access to the image.

            • buttons (list) --

              A list of buttons that should be displayed on the response card. The arrangement of the buttons is determined by the platform that displays the button.

              • (dict) --

                Describes a button to use on a response card used to gather slot values from a user.

                • text (string) -- [REQUIRED]

                  The text that appears on the button. Use this to tell the user what value is returned when they choose this button.

                • value (string) -- [REQUIRED]

                  The value returned to Amazon Lex when the user chooses this button. This must be one of the slot values configured for the slot.

        • variations (list) --

          Message variations to send to the user. When variations are defined, Amazon Lex chooses the primary message or one of the variations to send to the user.

          • (dict) --

            The object that provides message text and it's type.

            • plainTextMessage (dict) --

              A message in plain text format.

              • value (string) -- [REQUIRED]

                The message to send to the user.

            • customPayload (dict) --

              A message in a custom format defined by the client application.

              • value (string) -- [REQUIRED]

                The string that is sent to your application.

            • ssmlMessage (dict) --

              A message in Speech Synthesis Markup Language (SSML).

              • value (string) -- [REQUIRED]

                The SSML text that defines the prompt.

            • imageResponseCard (dict) --

              A message that defines a response card that the client application can show to the user.

              • title (string) -- [REQUIRED]

                The title to display on the response card. The format of the title is determined by the platform displaying the response card.

              • subtitle (string) --

                The subtitle to display on the response card. The format of the subtitle is determined by the platform displaying the response card.

              • imageUrl (string) --

                The URL of an image to display on the response card. The image URL must be publicly available so that the platform displaying the response card has access to the image.

              • buttons (list) --

                A list of buttons that should be displayed on the response card. The arrangement of the buttons is determined by the platform that displays the button.

                • (dict) --

                  Describes a button to use on a response card used to gather slot values from a user.

                  • text (string) -- [REQUIRED]

                    The text that appears on the button. Use this to tell the user what value is returned when they choose this button.

                  • value (string) -- [REQUIRED]

                    The value returned to Amazon Lex when the user chooses this button. This must be one of the slot values configured for the slot.

    • allowInterrupt (boolean) --

      Indicates whether the user can interrupt a speech response from Amazon Lex.

  • active (boolean) --

    Specifies whether the intent's confirmation is sent to the user. When this field is false, confirmation and declination responses aren't sent and processing continues as if the responses aren't present. If the active field isn't specified, the default is true.

type intentClosingSetting

dict

param intentClosingSetting

The new response that Amazon Lex sends the user when the intent is closed.

  • closingResponse (dict) -- [REQUIRED]

    The response that Amazon Lex sends to the user when the intent is complete.

    • messageGroups (list) -- [REQUIRED]

      A collection of responses that Amazon Lex can send to the user. Amazon Lex chooses the actual response to send at runtime.

      • (dict) --

        Provides one or more messages that Amazon Lex should send to the user.

        • message (dict) -- [REQUIRED]

          The primary message that Amazon Lex should send to the user.

          • plainTextMessage (dict) --

            A message in plain text format.

            • value (string) -- [REQUIRED]

              The message to send to the user.

          • customPayload (dict) --

            A message in a custom format defined by the client application.

            • value (string) -- [REQUIRED]

              The string that is sent to your application.

          • ssmlMessage (dict) --

            A message in Speech Synthesis Markup Language (SSML).

            • value (string) -- [REQUIRED]

              The SSML text that defines the prompt.

          • imageResponseCard (dict) --

            A message that defines a response card that the client application can show to the user.

            • title (string) -- [REQUIRED]

              The title to display on the response card. The format of the title is determined by the platform displaying the response card.

            • subtitle (string) --

              The subtitle to display on the response card. The format of the subtitle is determined by the platform displaying the response card.

            • imageUrl (string) --

              The URL of an image to display on the response card. The image URL must be publicly available so that the platform displaying the response card has access to the image.

            • buttons (list) --

              A list of buttons that should be displayed on the response card. The arrangement of the buttons is determined by the platform that displays the button.

              • (dict) --

                Describes a button to use on a response card used to gather slot values from a user.

                • text (string) -- [REQUIRED]

                  The text that appears on the button. Use this to tell the user what value is returned when they choose this button.

                • value (string) -- [REQUIRED]

                  The value returned to Amazon Lex when the user chooses this button. This must be one of the slot values configured for the slot.

        • variations (list) --

          Message variations to send to the user. When variations are defined, Amazon Lex chooses the primary message or one of the variations to send to the user.

          • (dict) --

            The object that provides message text and it's type.

            • plainTextMessage (dict) --

              A message in plain text format.

              • value (string) -- [REQUIRED]

                The message to send to the user.

            • customPayload (dict) --

              A message in a custom format defined by the client application.

              • value (string) -- [REQUIRED]

                The string that is sent to your application.

            • ssmlMessage (dict) --

              A message in Speech Synthesis Markup Language (SSML).

              • value (string) -- [REQUIRED]

                The SSML text that defines the prompt.

            • imageResponseCard (dict) --

              A message that defines a response card that the client application can show to the user.

              • title (string) -- [REQUIRED]

                The title to display on the response card. The format of the title is determined by the platform displaying the response card.

              • subtitle (string) --

                The subtitle to display on the response card. The format of the subtitle is determined by the platform displaying the response card.

              • imageUrl (string) --

                The URL of an image to display on the response card. The image URL must be publicly available so that the platform displaying the response card has access to the image.

              • buttons (list) --

                A list of buttons that should be displayed on the response card. The arrangement of the buttons is determined by the platform that displays the button.

                • (dict) --

                  Describes a button to use on a response card used to gather slot values from a user.

                  • text (string) -- [REQUIRED]

                    The text that appears on the button. Use this to tell the user what value is returned when they choose this button.

                  • value (string) -- [REQUIRED]

                    The value returned to Amazon Lex when the user chooses this button. This must be one of the slot values configured for the slot.

    • allowInterrupt (boolean) --

      Indicates whether the user can interrupt a speech response from Amazon Lex.

  • active (boolean) --

    Specifies whether an intent's closing response is used. When this field is false, the closing response isn't sent to the user and no closing input from the user is used. If the active field isn't specified, the default is true.

type inputContexts

list

param inputContexts

A new list of contexts that must be active in order for Amazon Lex to consider the intent.

  • (dict) --

    The name of a context that must be active for an intent to be selected by Amazon Lex.

    • name (string) -- [REQUIRED]

      The name of the context.

type outputContexts

list

param outputContexts

A new list of contexts that Amazon Lex activates when the intent is fulfilled.

  • (dict) --

    Describes a session context that is activated when an intent is fulfilled.

    • name (string) -- [REQUIRED]

      The name of the output context.

    • timeToLiveInSeconds (integer) -- [REQUIRED]

      The amount of time, in seconds, that the output context should remain active. The time is figured from the first time the context is sent to the user.

    • turnsToLive (integer) -- [REQUIRED]

      The number of conversation turns that the output context should remain active. The number of turns is counted from the first time that the context is sent to the user.

type kendraConfiguration

dict

param kendraConfiguration

New configuration settings for connecting to an Amazon Kendra index.

  • kendraIndex (string) -- [REQUIRED]

    The Amazon Resource Name (ARN) of the Amazon Kendra index that you want the AMAZON.KendraSearchIntent intent to search. The index must be in the same account and Region as the Amazon Lex bot.

  • queryFilterStringEnabled (boolean) --

    Determines whether the AMAZON.KendraSearchIntent intent uses a custom query string to query the Amazon Kendra index.

  • queryFilterString (string) --

    A query filter that Amazon Lex sends to Amazon Kendra to filter the response from a query. The filter is in the format defined by Amazon Kendra. For more information, see Filtering queries.

type botId

string

param botId

[REQUIRED]

The identifier of the bot that contains the intent.

type botVersion

string

param botVersion

[REQUIRED]

The version of the bot that contains the intent. Must be DRAFT .

type localeId

string

param localeId

[REQUIRED]

The identifier of the language and locale where this intent is used. The string must match one of the supported locales. For more information, see Supported languages.

rtype

dict

returns

Response Syntax

{
    'intentId': 'string',
    'intentName': 'string',
    'description': 'string',
    'parentIntentSignature': 'string',
    'sampleUtterances': [
        {
            'utterance': 'string'
        },
    ],
    'dialogCodeHook': {
        'enabled': True|False
    },
    'fulfillmentCodeHook': {
        'enabled': True|False
    },
    'slotPriorities': [
        {
            'priority': 123,
            'slotId': 'string'
        },
    ],
    'intentConfirmationSetting': {
        'promptSpecification': {
            'messageGroups': [
                {
                    'message': {
                        'plainTextMessage': {
                            'value': 'string'
                        },
                        'customPayload': {
                            'value': 'string'
                        },
                        'ssmlMessage': {
                            'value': 'string'
                        },
                        'imageResponseCard': {
                            'title': 'string',
                            'subtitle': 'string',
                            'imageUrl': 'string',
                            'buttons': [
                                {
                                    'text': 'string',
                                    'value': 'string'
                                },
                            ]
                        }
                    },
                    'variations': [
                        {
                            'plainTextMessage': {
                                'value': 'string'
                            },
                            'customPayload': {
                                'value': 'string'
                            },
                            'ssmlMessage': {
                                'value': 'string'
                            },
                            'imageResponseCard': {
                                'title': 'string',
                                'subtitle': 'string',
                                'imageUrl': 'string',
                                'buttons': [
                                    {
                                        'text': 'string',
                                        'value': 'string'
                                    },
                                ]
                            }
                        },
                    ]
                },
            ],
            'maxRetries': 123,
            'allowInterrupt': True|False
        },
        'declinationResponse': {
            'messageGroups': [
                {
                    'message': {
                        'plainTextMessage': {
                            'value': 'string'
                        },
                        'customPayload': {
                            'value': 'string'
                        },
                        'ssmlMessage': {
                            'value': 'string'
                        },
                        'imageResponseCard': {
                            'title': 'string',
                            'subtitle': 'string',
                            'imageUrl': 'string',
                            'buttons': [
                                {
                                    'text': 'string',
                                    'value': 'string'
                                },
                            ]
                        }
                    },
                    'variations': [
                        {
                            'plainTextMessage': {
                                'value': 'string'
                            },
                            'customPayload': {
                                'value': 'string'
                            },
                            'ssmlMessage': {
                                'value': 'string'
                            },
                            'imageResponseCard': {
                                'title': 'string',
                                'subtitle': 'string',
                                'imageUrl': 'string',
                                'buttons': [
                                    {
                                        'text': 'string',
                                        'value': 'string'
                                    },
                                ]
                            }
                        },
                    ]
                },
            ],
            'allowInterrupt': True|False
        },
        'active': True|False
    },
    'intentClosingSetting': {
        'closingResponse': {
            'messageGroups': [
                {
                    'message': {
                        'plainTextMessage': {
                            'value': 'string'
                        },
                        'customPayload': {
                            'value': 'string'
                        },
                        'ssmlMessage': {
                            'value': 'string'
                        },
                        'imageResponseCard': {
                            'title': 'string',
                            'subtitle': 'string',
                            'imageUrl': 'string',
                            'buttons': [
                                {
                                    'text': 'string',
                                    'value': 'string'
                                },
                            ]
                        }
                    },
                    'variations': [
                        {
                            'plainTextMessage': {
                                'value': 'string'
                            },
                            'customPayload': {
                                'value': 'string'
                            },
                            'ssmlMessage': {
                                'value': 'string'
                            },
                            'imageResponseCard': {
                                'title': 'string',
                                'subtitle': 'string',
                                'imageUrl': 'string',
                                'buttons': [
                                    {
                                        'text': 'string',
                                        'value': 'string'
                                    },
                                ]
                            }
                        },
                    ]
                },
            ],
            'allowInterrupt': True|False
        },
        'active': True|False
    },
    'inputContexts': [
        {
            'name': 'string'
        },
    ],
    'outputContexts': [
        {
            'name': 'string',
            'timeToLiveInSeconds': 123,
            'turnsToLive': 123
        },
    ],
    'kendraConfiguration': {
        'kendraIndex': 'string',
        'queryFilterStringEnabled': True|False,
        'queryFilterString': 'string'
    },
    'botId': 'string',
    'botVersion': 'string',
    'localeId': 'string',
    'creationDateTime': datetime(2015, 1, 1),
    'lastUpdatedDateTime': datetime(2015, 1, 1)
}

Response Structure

  • (dict) --

    • intentId (string) --

      The identifier of the intent that was updated.

    • intentName (string) --

      The updated name of the intent.

    • description (string) --

      The updated description of the intent.

    • parentIntentSignature (string) --

      The updated built-in intent that is the parent of this intent.

    • sampleUtterances (list) --

      The updated list of sample utterances for the intent.

      • (dict) --

        A sample utterance that invokes an intent or respond to a slot elicitation prompt.

        • utterance (string) --

          The sample utterance that Amazon Lex uses to build its machine-learning model to recognize intents.

    • dialogCodeHook (dict) --

      The updated Lambda function called during each turn of the conversation with the user.

      • enabled (boolean) --

        Enables the dialog code hook so that it processes user requests.

    • fulfillmentCodeHook (dict) --

      The updated Lambda function called when the intent is ready for fulfillment.

      • enabled (boolean) --

        Indicates whether a Lambda function should be invoked to fulfill a specific intent.

    • slotPriorities (list) --

      The updated list of slots and their priorities that are elicited from the user for the intent.

      • (dict) --

        Sets the priority that Amazon Lex should use when eliciting slot values from a user.

        • priority (integer) --

          The priority that a slot should be elicited.

        • slotId (string) --

          The unique identifier of the slot.

    • intentConfirmationSetting (dict) --

      The updated prompts that Amazon Lex sends to the user to confirm the completion of an intent.

      • promptSpecification (dict) --

        Prompts the user to confirm the intent. This question should have a yes or no answer.

        Amazon Lex uses this prompt to ensure that the user acknowledges that the intent is ready for fulfillment. For example, with the OrderPizza intent, you might want to confirm that the order is correct before placing it. For other intents, such as intents that simply respond to user questions, you might not need to ask the user for confirmation before providing the information.

        • messageGroups (list) --

          A collection of messages that Amazon Lex can send to the user. Amazon Lex chooses the actual message to send at runtime.

          • (dict) --

            Provides one or more messages that Amazon Lex should send to the user.

            • message (dict) --

              The primary message that Amazon Lex should send to the user.

              • plainTextMessage (dict) --

                A message in plain text format.

                • value (string) --

                  The message to send to the user.

              • customPayload (dict) --

                A message in a custom format defined by the client application.

                • value (string) --

                  The string that is sent to your application.

              • ssmlMessage (dict) --

                A message in Speech Synthesis Markup Language (SSML).

                • value (string) --

                  The SSML text that defines the prompt.

              • imageResponseCard (dict) --

                A message that defines a response card that the client application can show to the user.

                • title (string) --

                  The title to display on the response card. The format of the title is determined by the platform displaying the response card.

                • subtitle (string) --

                  The subtitle to display on the response card. The format of the subtitle is determined by the platform displaying the response card.

                • imageUrl (string) --

                  The URL of an image to display on the response card. The image URL must be publicly available so that the platform displaying the response card has access to the image.

                • buttons (list) --

                  A list of buttons that should be displayed on the response card. The arrangement of the buttons is determined by the platform that displays the button.

                  • (dict) --

                    Describes a button to use on a response card used to gather slot values from a user.

                    • text (string) --

                      The text that appears on the button. Use this to tell the user what value is returned when they choose this button.

                    • value (string) --

                      The value returned to Amazon Lex when the user chooses this button. This must be one of the slot values configured for the slot.

            • variations (list) --

              Message variations to send to the user. When variations are defined, Amazon Lex chooses the primary message or one of the variations to send to the user.

              • (dict) --

                The object that provides message text and it's type.

                • plainTextMessage (dict) --

                  A message in plain text format.

                  • value (string) --

                    The message to send to the user.

                • customPayload (dict) --

                  A message in a custom format defined by the client application.

                  • value (string) --

                    The string that is sent to your application.

                • ssmlMessage (dict) --

                  A message in Speech Synthesis Markup Language (SSML).

                  • value (string) --

                    The SSML text that defines the prompt.

                • imageResponseCard (dict) --

                  A message that defines a response card that the client application can show to the user.

                  • title (string) --

                    The title to display on the response card. The format of the title is determined by the platform displaying the response card.

                  • subtitle (string) --

                    The subtitle to display on the response card. The format of the subtitle is determined by the platform displaying the response card.

                  • imageUrl (string) --

                    The URL of an image to display on the response card. The image URL must be publicly available so that the platform displaying the response card has access to the image.

                  • buttons (list) --

                    A list of buttons that should be displayed on the response card. The arrangement of the buttons is determined by the platform that displays the button.

                    • (dict) --

                      Describes a button to use on a response card used to gather slot values from a user.

                      • text (string) --

                        The text that appears on the button. Use this to tell the user what value is returned when they choose this button.

                      • value (string) --

                        The value returned to Amazon Lex when the user chooses this button. This must be one of the slot values configured for the slot.

        • maxRetries (integer) --

          The maximum number of times the bot tries to elicit a resonse from the user using this prompt.

        • allowInterrupt (boolean) --

          Indicates whether the user can interrupt a speech prompt from the bot.

      • declinationResponse (dict) --

        When the user answers "no" to the question defined in promptSpecification , Amazon Lex responds with this response to acknowledge that the intent was canceled.

        • messageGroups (list) --

          A collection of responses that Amazon Lex can send to the user. Amazon Lex chooses the actual response to send at runtime.

          • (dict) --

            Provides one or more messages that Amazon Lex should send to the user.

            • message (dict) --

              The primary message that Amazon Lex should send to the user.

              • plainTextMessage (dict) --

                A message in plain text format.

                • value (string) --

                  The message to send to the user.

              • customPayload (dict) --

                A message in a custom format defined by the client application.

                • value (string) --

                  The string that is sent to your application.

              • ssmlMessage (dict) --

                A message in Speech Synthesis Markup Language (SSML).

                • value (string) --

                  The SSML text that defines the prompt.

              • imageResponseCard (dict) --

                A message that defines a response card that the client application can show to the user.

                • title (string) --

                  The title to display on the response card. The format of the title is determined by the platform displaying the response card.

                • subtitle (string) --

                  The subtitle to display on the response card. The format of the subtitle is determined by the platform displaying the response card.

                • imageUrl (string) --

                  The URL of an image to display on the response card. The image URL must be publicly available so that the platform displaying the response card has access to the image.

                • buttons (list) --

                  A list of buttons that should be displayed on the response card. The arrangement of the buttons is determined by the platform that displays the button.

                  • (dict) --

                    Describes a button to use on a response card used to gather slot values from a user.

                    • text (string) --

                      The text that appears on the button. Use this to tell the user what value is returned when they choose this button.

                    • value (string) --

                      The value returned to Amazon Lex when the user chooses this button. This must be one of the slot values configured for the slot.

            • variations (list) --

              Message variations to send to the user. When variations are defined, Amazon Lex chooses the primary message or one of the variations to send to the user.

              • (dict) --

                The object that provides message text and it's type.

                • plainTextMessage (dict) --

                  A message in plain text format.

                  • value (string) --

                    The message to send to the user.

                • customPayload (dict) --

                  A message in a custom format defined by the client application.

                  • value (string) --

                    The string that is sent to your application.

                • ssmlMessage (dict) --

                  A message in Speech Synthesis Markup Language (SSML).

                  • value (string) --

                    The SSML text that defines the prompt.

                • imageResponseCard (dict) --

                  A message that defines a response card that the client application can show to the user.

                  • title (string) --

                    The title to display on the response card. The format of the title is determined by the platform displaying the response card.

                  • subtitle (string) --

                    The subtitle to display on the response card. The format of the subtitle is determined by the platform displaying the response card.

                  • imageUrl (string) --

                    The URL of an image to display on the response card. The image URL must be publicly available so that the platform displaying the response card has access to the image.

                  • buttons (list) --

                    A list of buttons that should be displayed on the response card. The arrangement of the buttons is determined by the platform that displays the button.

                    • (dict) --

                      Describes a button to use on a response card used to gather slot values from a user.

                      • text (string) --

                        The text that appears on the button. Use this to tell the user what value is returned when they choose this button.

                      • value (string) --

                        The value returned to Amazon Lex when the user chooses this button. This must be one of the slot values configured for the slot.

        • allowInterrupt (boolean) --

          Indicates whether the user can interrupt a speech response from Amazon Lex.

      • active (boolean) --

        Specifies whether the intent's confirmation is sent to the user. When this field is false, confirmation and declination responses aren't sent and processing continues as if the responses aren't present. If the active field isn't specified, the default is true.

    • intentClosingSetting (dict) --

      The updated response that Amazon Lex sends the user when the intent is closed.

      • closingResponse (dict) --

        The response that Amazon Lex sends to the user when the intent is complete.

        • messageGroups (list) --

          A collection of responses that Amazon Lex can send to the user. Amazon Lex chooses the actual response to send at runtime.

          • (dict) --

            Provides one or more messages that Amazon Lex should send to the user.

            • message (dict) --

              The primary message that Amazon Lex should send to the user.

              • plainTextMessage (dict) --

                A message in plain text format.

                • value (string) --

                  The message to send to the user.

              • customPayload (dict) --

                A message in a custom format defined by the client application.

                • value (string) --

                  The string that is sent to your application.

              • ssmlMessage (dict) --

                A message in Speech Synthesis Markup Language (SSML).

                • value (string) --

                  The SSML text that defines the prompt.

              • imageResponseCard (dict) --

                A message that defines a response card that the client application can show to the user.

                • title (string) --

                  The title to display on the response card. The format of the title is determined by the platform displaying the response card.

                • subtitle (string) --

                  The subtitle to display on the response card. The format of the subtitle is determined by the platform displaying the response card.

                • imageUrl (string) --

                  The URL of an image to display on the response card. The image URL must be publicly available so that the platform displaying the response card has access to the image.

                • buttons (list) --

                  A list of buttons that should be displayed on the response card. The arrangement of the buttons is determined by the platform that displays the button.

                  • (dict) --

                    Describes a button to use on a response card used to gather slot values from a user.

                    • text (string) --

                      The text that appears on the button. Use this to tell the user what value is returned when they choose this button.

                    • value (string) --

                      The value returned to Amazon Lex when the user chooses this button. This must be one of the slot values configured for the slot.

            • variations (list) --

              Message variations to send to the user. When variations are defined, Amazon Lex chooses the primary message or one of the variations to send to the user.

              • (dict) --

                The object that provides message text and it's type.

                • plainTextMessage (dict) --

                  A message in plain text format.

                  • value (string) --

                    The message to send to the user.

                • customPayload (dict) --

                  A message in a custom format defined by the client application.

                  • value (string) --

                    The string that is sent to your application.

                • ssmlMessage (dict) --

                  A message in Speech Synthesis Markup Language (SSML).

                  • value (string) --

                    The SSML text that defines the prompt.

                • imageResponseCard (dict) --

                  A message that defines a response card that the client application can show to the user.

                  • title (string) --

                    The title to display on the response card. The format of the title is determined by the platform displaying the response card.

                  • subtitle (string) --

                    The subtitle to display on the response card. The format of the subtitle is determined by the platform displaying the response card.

                  • imageUrl (string) --

                    The URL of an image to display on the response card. The image URL must be publicly available so that the platform displaying the response card has access to the image.

                  • buttons (list) --

                    A list of buttons that should be displayed on the response card. The arrangement of the buttons is determined by the platform that displays the button.

                    • (dict) --

                      Describes a button to use on a response card used to gather slot values from a user.

                      • text (string) --

                        The text that appears on the button. Use this to tell the user what value is returned when they choose this button.

                      • value (string) --

                        The value returned to Amazon Lex when the user chooses this button. This must be one of the slot values configured for the slot.

        • allowInterrupt (boolean) --

          Indicates whether the user can interrupt a speech response from Amazon Lex.

      • active (boolean) --

        Specifies whether an intent's closing response is used. When this field is false, the closing response isn't sent to the user and no closing input from the user is used. If the active field isn't specified, the default is true.

    • inputContexts (list) --

      The updated list of contexts that must be active for the intent to be considered by Amazon Lex.

      • (dict) --

        The name of a context that must be active for an intent to be selected by Amazon Lex.

        • name (string) --

          The name of the context.

    • outputContexts (list) --

      The updated list of contexts that Amazon Lex activates when the intent is fulfilled.

      • (dict) --

        Describes a session context that is activated when an intent is fulfilled.

        • name (string) --

          The name of the output context.

        • timeToLiveInSeconds (integer) --

          The amount of time, in seconds, that the output context should remain active. The time is figured from the first time the context is sent to the user.

        • turnsToLive (integer) --

          The number of conversation turns that the output context should remain active. The number of turns is counted from the first time that the context is sent to the user.

    • kendraConfiguration (dict) --

      The updated configuration for connecting to an Amazon Kendra index with the AMAZON.KendraSearchIntent intent.

      • kendraIndex (string) --

        The Amazon Resource Name (ARN) of the Amazon Kendra index that you want the AMAZON.KendraSearchIntent intent to search. The index must be in the same account and Region as the Amazon Lex bot.

      • queryFilterStringEnabled (boolean) --

        Determines whether the AMAZON.KendraSearchIntent intent uses a custom query string to query the Amazon Kendra index.

      • queryFilterString (string) --

        A query filter that Amazon Lex sends to Amazon Kendra to filter the response from a query. The filter is in the format defined by Amazon Kendra. For more information, see Filtering queries.

    • botId (string) --

      The identifier of the bot that contains the intent.

    • botVersion (string) --

      The version of the bot that contains the intent. Will always be DRAFT .

    • localeId (string) --

      The updated language and locale of the intent.

    • creationDateTime (datetime) --

      A timestamp of when the intent was created.

    • lastUpdatedDateTime (datetime) --

      A timestamp of the last time that the intent was modified.

UpdateSlot (updated) Link ΒΆ
Changes (both)
{'valueElicitationSetting': {'waitAndContinueSpecification': {'active': 'boolean'}}}

Updates the settings for a slot.

See also: AWS API Documentation

Request Syntax

client.update_slot(
    slotId='string',
    slotName='string',
    description='string',
    slotTypeId='string',
    valueElicitationSetting={
        'defaultValueSpecification': {
            'defaultValueList': [
                {
                    'defaultValue': 'string'
                },
            ]
        },
        'slotConstraint': 'Required'|'Optional',
        'promptSpecification': {
            'messageGroups': [
                {
                    'message': {
                        'plainTextMessage': {
                            'value': 'string'
                        },
                        'customPayload': {
                            'value': 'string'
                        },
                        'ssmlMessage': {
                            'value': 'string'
                        },
                        'imageResponseCard': {
                            'title': 'string',
                            'subtitle': 'string',
                            'imageUrl': 'string',
                            'buttons': [
                                {
                                    'text': 'string',
                                    'value': 'string'
                                },
                            ]
                        }
                    },
                    'variations': [
                        {
                            'plainTextMessage': {
                                'value': 'string'
                            },
                            'customPayload': {
                                'value': 'string'
                            },
                            'ssmlMessage': {
                                'value': 'string'
                            },
                            'imageResponseCard': {
                                'title': 'string',
                                'subtitle': 'string',
                                'imageUrl': 'string',
                                'buttons': [
                                    {
                                        'text': 'string',
                                        'value': 'string'
                                    },
                                ]
                            }
                        },
                    ]
                },
            ],
            'maxRetries': 123,
            'allowInterrupt': True|False
        },
        'sampleUtterances': [
            {
                'utterance': 'string'
            },
        ],
        'waitAndContinueSpecification': {
            'waitingResponse': {
                'messageGroups': [
                    {
                        'message': {
                            'plainTextMessage': {
                                'value': 'string'
                            },
                            'customPayload': {
                                'value': 'string'
                            },
                            'ssmlMessage': {
                                'value': 'string'
                            },
                            'imageResponseCard': {
                                'title': 'string',
                                'subtitle': 'string',
                                'imageUrl': 'string',
                                'buttons': [
                                    {
                                        'text': 'string',
                                        'value': 'string'
                                    },
                                ]
                            }
                        },
                        'variations': [
                            {
                                'plainTextMessage': {
                                    'value': 'string'
                                },
                                'customPayload': {
                                    'value': 'string'
                                },
                                'ssmlMessage': {
                                    'value': 'string'
                                },
                                'imageResponseCard': {
                                    'title': 'string',
                                    'subtitle': 'string',
                                    'imageUrl': 'string',
                                    'buttons': [
                                        {
                                            'text': 'string',
                                            'value': 'string'
                                        },
                                    ]
                                }
                            },
                        ]
                    },
                ],
                'allowInterrupt': True|False
            },
            'continueResponse': {
                'messageGroups': [
                    {
                        'message': {
                            'plainTextMessage': {
                                'value': 'string'
                            },
                            'customPayload': {
                                'value': 'string'
                            },
                            'ssmlMessage': {
                                'value': 'string'
                            },
                            'imageResponseCard': {
                                'title': 'string',
                                'subtitle': 'string',
                                'imageUrl': 'string',
                                'buttons': [
                                    {
                                        'text': 'string',
                                        'value': 'string'
                                    },
                                ]
                            }
                        },
                        'variations': [
                            {
                                'plainTextMessage': {
                                    'value': 'string'
                                },
                                'customPayload': {
                                    'value': 'string'
                                },
                                'ssmlMessage': {
                                    'value': 'string'
                                },
                                'imageResponseCard': {
                                    'title': 'string',
                                    'subtitle': 'string',
                                    'imageUrl': 'string',
                                    'buttons': [
                                        {
                                            'text': 'string',
                                            'value': 'string'
                                        },
                                    ]
                                }
                            },
                        ]
                    },
                ],
                'allowInterrupt': True|False
            },
            'stillWaitingResponse': {
                'messageGroups': [
                    {
                        'message': {
                            'plainTextMessage': {
                                'value': 'string'
                            },
                            'customPayload': {
                                'value': 'string'
                            },
                            'ssmlMessage': {
                                'value': 'string'
                            },
                            'imageResponseCard': {
                                'title': 'string',
                                'subtitle': 'string',
                                'imageUrl': 'string',
                                'buttons': [
                                    {
                                        'text': 'string',
                                        'value': 'string'
                                    },
                                ]
                            }
                        },
                        'variations': [
                            {
                                'plainTextMessage': {
                                    'value': 'string'
                                },
                                'customPayload': {
                                    'value': 'string'
                                },
                                'ssmlMessage': {
                                    'value': 'string'
                                },
                                'imageResponseCard': {
                                    'title': 'string',
                                    'subtitle': 'string',
                                    'imageUrl': 'string',
                                    'buttons': [
                                        {
                                            'text': 'string',
                                            'value': 'string'
                                        },
                                    ]
                                }
                            },
                        ]
                    },
                ],
                'frequencyInSeconds': 123,
                'timeoutInSeconds': 123,
                'allowInterrupt': True|False
            },
            'active': True|False
        }
    },
    obfuscationSetting={
        'obfuscationSettingType': 'None'|'DefaultObfuscation'
    },
    botId='string',
    botVersion='string',
    localeId='string',
    intentId='string',
    multipleValuesSetting={
        'allowMultipleValues': True|False
    }
)
type slotId

string

param slotId

[REQUIRED]

The unique identifier for the slot to update.

type slotName

string

param slotName

[REQUIRED]

The new name for the slot.

type description

string

param description

The new description for the slot.

type slotTypeId

string

param slotTypeId

[REQUIRED]

The unique identifier of the new slot type to associate with this slot.

type valueElicitationSetting

dict

param valueElicitationSetting

[REQUIRED]

A new set of prompts that Amazon Lex sends to the user to elicit a response the provides a value for the slot.

  • defaultValueSpecification (dict) --

    A list of default values for a slot. Default values are used when Amazon Lex hasn't determined a value for a slot. You can specify default values from context variables, sesion attributes, and defined values.

    • defaultValueList (list) -- [REQUIRED]

      A list of default values. Amazon Lex chooses the default value to use in the order that they are presented in the list.

      • (dict) --

        Specifies the default value to use when a user doesn't provide a value for a slot.

        • defaultValue (string) -- [REQUIRED]

          The default value to use when a user doesn't provide a value for a slot.

  • slotConstraint (string) -- [REQUIRED]

    Specifies whether the slot is required or optional.

  • promptSpecification (dict) --

    The prompt that Amazon Lex uses to elicit the slot value from the user.

    • messageGroups (list) -- [REQUIRED]

      A collection of messages that Amazon Lex can send to the user. Amazon Lex chooses the actual message to send at runtime.

      • (dict) --

        Provides one or more messages that Amazon Lex should send to the user.

        • message (dict) -- [REQUIRED]

          The primary message that Amazon Lex should send to the user.

          • plainTextMessage (dict) --

            A message in plain text format.

            • value (string) -- [REQUIRED]

              The message to send to the user.

          • customPayload (dict) --

            A message in a custom format defined by the client application.

            • value (string) -- [REQUIRED]

              The string that is sent to your application.

          • ssmlMessage (dict) --

            A message in Speech Synthesis Markup Language (SSML).

            • value (string) -- [REQUIRED]

              The SSML text that defines the prompt.

          • imageResponseCard (dict) --

            A message that defines a response card that the client application can show to the user.

            • title (string) -- [REQUIRED]

              The title to display on the response card. The format of the title is determined by the platform displaying the response card.

            • subtitle (string) --

              The subtitle to display on the response card. The format of the subtitle is determined by the platform displaying the response card.

            • imageUrl (string) --

              The URL of an image to display on the response card. The image URL must be publicly available so that the platform displaying the response card has access to the image.

            • buttons (list) --

              A list of buttons that should be displayed on the response card. The arrangement of the buttons is determined by the platform that displays the button.

              • (dict) --

                Describes a button to use on a response card used to gather slot values from a user.

                • text (string) -- [REQUIRED]

                  The text that appears on the button. Use this to tell the user what value is returned when they choose this button.

                • value (string) -- [REQUIRED]

                  The value returned to Amazon Lex when the user chooses this button. This must be one of the slot values configured for the slot.

        • variations (list) --

          Message variations to send to the user. When variations are defined, Amazon Lex chooses the primary message or one of the variations to send to the user.

          • (dict) --

            The object that provides message text and it's type.

            • plainTextMessage (dict) --

              A message in plain text format.

              • value (string) -- [REQUIRED]

                The message to send to the user.

            • customPayload (dict) --

              A message in a custom format defined by the client application.

              • value (string) -- [REQUIRED]

                The string that is sent to your application.

            • ssmlMessage (dict) --

              A message in Speech Synthesis Markup Language (SSML).

              • value (string) -- [REQUIRED]

                The SSML text that defines the prompt.

            • imageResponseCard (dict) --

              A message that defines a response card that the client application can show to the user.

              • title (string) -- [REQUIRED]

                The title to display on the response card. The format of the title is determined by the platform displaying the response card.

              • subtitle (string) --

                The subtitle to display on the response card. The format of the subtitle is determined by the platform displaying the response card.

              • imageUrl (string) --

                The URL of an image to display on the response card. The image URL must be publicly available so that the platform displaying the response card has access to the image.

              • buttons (list) --

                A list of buttons that should be displayed on the response card. The arrangement of the buttons is determined by the platform that displays the button.

                • (dict) --

                  Describes a button to use on a response card used to gather slot values from a user.

                  • text (string) -- [REQUIRED]

                    The text that appears on the button. Use this to tell the user what value is returned when they choose this button.

                  • value (string) -- [REQUIRED]

                    The value returned to Amazon Lex when the user chooses this button. This must be one of the slot values configured for the slot.

    • maxRetries (integer) -- [REQUIRED]

      The maximum number of times the bot tries to elicit a resonse from the user using this prompt.

    • allowInterrupt (boolean) --

      Indicates whether the user can interrupt a speech prompt from the bot.

  • sampleUtterances (list) --

    If you know a specific pattern that users might respond to an Amazon Lex request for a slot value, you can provide those utterances to improve accuracy. This is optional. In most cases, Amazon Lex is capable of understanding user utterances.

    • (dict) --

      A sample utterance that invokes an intent or respond to a slot elicitation prompt.

      • utterance (string) -- [REQUIRED]

        The sample utterance that Amazon Lex uses to build its machine-learning model to recognize intents.

  • waitAndContinueSpecification (dict) --

    Specifies the prompts that Amazon Lex uses while a bot is waiting for customer input.

    • waitingResponse (dict) -- [REQUIRED]

      The response that Amazon Lex sends to indicate that the bot is waiting for the conversation to continue.

      • messageGroups (list) -- [REQUIRED]

        A collection of responses that Amazon Lex can send to the user. Amazon Lex chooses the actual response to send at runtime.

        • (dict) --

          Provides one or more messages that Amazon Lex should send to the user.

          • message (dict) -- [REQUIRED]

            The primary message that Amazon Lex should send to the user.

            • plainTextMessage (dict) --

              A message in plain text format.

              • value (string) -- [REQUIRED]

                The message to send to the user.

            • customPayload (dict) --

              A message in a custom format defined by the client application.

              • value (string) -- [REQUIRED]

                The string that is sent to your application.

            • ssmlMessage (dict) --

              A message in Speech Synthesis Markup Language (SSML).

              • value (string) -- [REQUIRED]

                The SSML text that defines the prompt.

            • imageResponseCard (dict) --

              A message that defines a response card that the client application can show to the user.

              • title (string) -- [REQUIRED]

                The title to display on the response card. The format of the title is determined by the platform displaying the response card.

              • subtitle (string) --

                The subtitle to display on the response card. The format of the subtitle is determined by the platform displaying the response card.

              • imageUrl (string) --

                The URL of an image to display on the response card. The image URL must be publicly available so that the platform displaying the response card has access to the image.

              • buttons (list) --

                A list of buttons that should be displayed on the response card. The arrangement of the buttons is determined by the platform that displays the button.

                • (dict) --

                  Describes a button to use on a response card used to gather slot values from a user.

                  • text (string) -- [REQUIRED]

                    The text that appears on the button. Use this to tell the user what value is returned when they choose this button.

                  • value (string) -- [REQUIRED]

                    The value returned to Amazon Lex when the user chooses this button. This must be one of the slot values configured for the slot.

          • variations (list) --

            Message variations to send to the user. When variations are defined, Amazon Lex chooses the primary message or one of the variations to send to the user.

            • (dict) --

              The object that provides message text and it's type.

              • plainTextMessage (dict) --

                A message in plain text format.

                • value (string) -- [REQUIRED]

                  The message to send to the user.

              • customPayload (dict) --

                A message in a custom format defined by the client application.

                • value (string) -- [REQUIRED]

                  The string that is sent to your application.

              • ssmlMessage (dict) --

                A message in Speech Synthesis Markup Language (SSML).

                • value (string) -- [REQUIRED]

                  The SSML text that defines the prompt.

              • imageResponseCard (dict) --

                A message that defines a response card that the client application can show to the user.

                • title (string) -- [REQUIRED]

                  The title to display on the response card. The format of the title is determined by the platform displaying the response card.

                • subtitle (string) --

                  The subtitle to display on the response card. The format of the subtitle is determined by the platform displaying the response card.

                • imageUrl (string) --

                  The URL of an image to display on the response card. The image URL must be publicly available so that the platform displaying the response card has access to the image.

                • buttons (list) --

                  A list of buttons that should be displayed on the response card. The arrangement of the buttons is determined by the platform that displays the button.

                  • (dict) --

                    Describes a button to use on a response card used to gather slot values from a user.

                    • text (string) -- [REQUIRED]

                      The text that appears on the button. Use this to tell the user what value is returned when they choose this button.

                    • value (string) -- [REQUIRED]

                      The value returned to Amazon Lex when the user chooses this button. This must be one of the slot values configured for the slot.

      • allowInterrupt (boolean) --

        Indicates whether the user can interrupt a speech response from Amazon Lex.

    • continueResponse (dict) -- [REQUIRED]

      The response that Amazon Lex sends to indicate that the bot is ready to continue the conversation.

      • messageGroups (list) -- [REQUIRED]

        A collection of responses that Amazon Lex can send to the user. Amazon Lex chooses the actual response to send at runtime.

        • (dict) --

          Provides one or more messages that Amazon Lex should send to the user.

          • message (dict) -- [REQUIRED]

            The primary message that Amazon Lex should send to the user.

            • plainTextMessage (dict) --

              A message in plain text format.

              • value (string) -- [REQUIRED]

                The message to send to the user.

            • customPayload (dict) --

              A message in a custom format defined by the client application.

              • value (string) -- [REQUIRED]

                The string that is sent to your application.

            • ssmlMessage (dict) --

              A message in Speech Synthesis Markup Language (SSML).

              • value (string) -- [REQUIRED]

                The SSML text that defines the prompt.

            • imageResponseCard (dict) --

              A message that defines a response card that the client application can show to the user.

              • title (string) -- [REQUIRED]

                The title to display on the response card. The format of the title is determined by the platform displaying the response card.

              • subtitle (string) --

                The subtitle to display on the response card. The format of the subtitle is determined by the platform displaying the response card.

              • imageUrl (string) --

                The URL of an image to display on the response card. The image URL must be publicly available so that the platform displaying the response card has access to the image.

              • buttons (list) --

                A list of buttons that should be displayed on the response card. The arrangement of the buttons is determined by the platform that displays the button.

                • (dict) --

                  Describes a button to use on a response card used to gather slot values from a user.

                  • text (string) -- [REQUIRED]

                    The text that appears on the button. Use this to tell the user what value is returned when they choose this button.

                  • value (string) -- [REQUIRED]

                    The value returned to Amazon Lex when the user chooses this button. This must be one of the slot values configured for the slot.

          • variations (list) --

            Message variations to send to the user. When variations are defined, Amazon Lex chooses the primary message or one of the variations to send to the user.

            • (dict) --

              The object that provides message text and it's type.

              • plainTextMessage (dict) --

                A message in plain text format.

                • value (string) -- [REQUIRED]

                  The message to send to the user.

              • customPayload (dict) --

                A message in a custom format defined by the client application.

                • value (string) -- [REQUIRED]

                  The string that is sent to your application.

              • ssmlMessage (dict) --

                A message in Speech Synthesis Markup Language (SSML).

                • value (string) -- [REQUIRED]

                  The SSML text that defines the prompt.

              • imageResponseCard (dict) --

                A message that defines a response card that the client application can show to the user.

                • title (string) -- [REQUIRED]

                  The title to display on the response card. The format of the title is determined by the platform displaying the response card.

                • subtitle (string) --

                  The subtitle to display on the response card. The format of the subtitle is determined by the platform displaying the response card.

                • imageUrl (string) --

                  The URL of an image to display on the response card. The image URL must be publicly available so that the platform displaying the response card has access to the image.

                • buttons (list) --

                  A list of buttons that should be displayed on the response card. The arrangement of the buttons is determined by the platform that displays the button.

                  • (dict) --

                    Describes a button to use on a response card used to gather slot values from a user.

                    • text (string) -- [REQUIRED]

                      The text that appears on the button. Use this to tell the user what value is returned when they choose this button.

                    • value (string) -- [REQUIRED]

                      The value returned to Amazon Lex when the user chooses this button. This must be one of the slot values configured for the slot.

      • allowInterrupt (boolean) --

        Indicates whether the user can interrupt a speech response from Amazon Lex.

    • stillWaitingResponse (dict) --

      A response that Amazon Lex sends periodically to the user to indicate that the bot is still waiting for input from the user.

      • messageGroups (list) -- [REQUIRED]

        One or more message groups, each containing one or more messages, that define the prompts that Amazon Lex sends to the user.

        • (dict) --

          Provides one or more messages that Amazon Lex should send to the user.

          • message (dict) -- [REQUIRED]

            The primary message that Amazon Lex should send to the user.

            • plainTextMessage (dict) --

              A message in plain text format.

              • value (string) -- [REQUIRED]

                The message to send to the user.

            • customPayload (dict) --

              A message in a custom format defined by the client application.

              • value (string) -- [REQUIRED]

                The string that is sent to your application.

            • ssmlMessage (dict) --

              A message in Speech Synthesis Markup Language (SSML).

              • value (string) -- [REQUIRED]

                The SSML text that defines the prompt.

            • imageResponseCard (dict) --

              A message that defines a response card that the client application can show to the user.

              • title (string) -- [REQUIRED]

                The title to display on the response card. The format of the title is determined by the platform displaying the response card.

              • subtitle (string) --

                The subtitle to display on the response card. The format of the subtitle is determined by the platform displaying the response card.

              • imageUrl (string) --

                The URL of an image to display on the response card. The image URL must be publicly available so that the platform displaying the response card has access to the image.

              • buttons (list) --

                A list of buttons that should be displayed on the response card. The arrangement of the buttons is determined by the platform that displays the button.

                • (dict) --

                  Describes a button to use on a response card used to gather slot values from a user.

                  • text (string) -- [REQUIRED]

                    The text that appears on the button. Use this to tell the user what value is returned when they choose this button.

                  • value (string) -- [REQUIRED]

                    The value returned to Amazon Lex when the user chooses this button. This must be one of the slot values configured for the slot.

          • variations (list) --

            Message variations to send to the user. When variations are defined, Amazon Lex chooses the primary message or one of the variations to send to the user.

            • (dict) --

              The object that provides message text and it's type.

              • plainTextMessage (dict) --

                A message in plain text format.

                • value (string) -- [REQUIRED]

                  The message to send to the user.

              • customPayload (dict) --

                A message in a custom format defined by the client application.

                • value (string) -- [REQUIRED]

                  The string that is sent to your application.

              • ssmlMessage (dict) --

                A message in Speech Synthesis Markup Language (SSML).

                • value (string) -- [REQUIRED]

                  The SSML text that defines the prompt.

              • imageResponseCard (dict) --

                A message that defines a response card that the client application can show to the user.

                • title (string) -- [REQUIRED]

                  The title to display on the response card. The format of the title is determined by the platform displaying the response card.

                • subtitle (string) --

                  The subtitle to display on the response card. The format of the subtitle is determined by the platform displaying the response card.

                • imageUrl (string) --

                  The URL of an image to display on the response card. The image URL must be publicly available so that the platform displaying the response card has access to the image.

                • buttons (list) --

                  A list of buttons that should be displayed on the response card. The arrangement of the buttons is determined by the platform that displays the button.

                  • (dict) --

                    Describes a button to use on a response card used to gather slot values from a user.

                    • text (string) -- [REQUIRED]

                      The text that appears on the button. Use this to tell the user what value is returned when they choose this button.

                    • value (string) -- [REQUIRED]

                      The value returned to Amazon Lex when the user chooses this button. This must be one of the slot values configured for the slot.

      • frequencyInSeconds (integer) -- [REQUIRED]

        How often a message should be sent to the user. Minimum of 1 second, maximum of 5 minutes.

      • timeoutInSeconds (integer) -- [REQUIRED]

        If Amazon Lex waits longer than this length of time for a response, it will stop sending messages.

      • allowInterrupt (boolean) --

        Indicates that the user can interrupt the response by speaking while the message is being played.

    • active (boolean) --

      Specifies whether the bot will wait for a user to respond. When this field is false, wait and continue responses for a slot aren't used and the bot expects an appropriate response within the configured timeout. If the active field isn't specified, the default is true.

type obfuscationSetting

dict

param obfuscationSetting

New settings that determine how slot values are formatted in Amazon CloudWatch logs.

  • obfuscationSettingType (string) -- [REQUIRED]

    Value that determines whether Amazon Lex obscures slot values in conversation logs. The default is to obscure the values.

type botId

string

param botId

[REQUIRED]

The unique identifier of the bot that contains the slot.

type botVersion

string

param botVersion

[REQUIRED]

The version of the bot that contains the slot. Must always be DRAFT .

type localeId

string

param localeId

[REQUIRED]

The identifier of the language and locale that contains the slot. The string must match one of the supported locales. For more information, see Supported languages.

type intentId

string

param intentId

[REQUIRED]

The identifier of the intent that contains the slot.

type multipleValuesSetting

dict

param multipleValuesSetting

Determines whether the slot accepts multiple values in one response. Multiple value slots are only available in the en-US locale. If you set this value to true in any other locale, Amazon Lex throws a ValidationException .

If the multipleValuesSetting is not set, the default value is false .

  • allowMultipleValues (boolean) --

    Indicates whether a slot can return multiple values. When true , the slot may return more than one value in a response. When false , the slot returns only a single value.

    Multi-value slots are only available in the en-US locale. If you set this value to true in any other locale, Amazon Lex throws a ValidationException .

    If the allowMutlipleValues is not set, the default value is false .

rtype

dict

returns

Response Syntax

{
    'slotId': 'string',
    'slotName': 'string',
    'description': 'string',
    'slotTypeId': 'string',
    'valueElicitationSetting': {
        'defaultValueSpecification': {
            'defaultValueList': [
                {
                    'defaultValue': 'string'
                },
            ]
        },
        'slotConstraint': 'Required'|'Optional',
        'promptSpecification': {
            'messageGroups': [
                {
                    'message': {
                        'plainTextMessage': {
                            'value': 'string'
                        },
                        'customPayload': {
                            'value': 'string'
                        },
                        'ssmlMessage': {
                            'value': 'string'
                        },
                        'imageResponseCard': {
                            'title': 'string',
                            'subtitle': 'string',
                            'imageUrl': 'string',
                            'buttons': [
                                {
                                    'text': 'string',
                                    'value': 'string'
                                },
                            ]
                        }
                    },
                    'variations': [
                        {
                            'plainTextMessage': {
                                'value': 'string'
                            },
                            'customPayload': {
                                'value': 'string'
                            },
                            'ssmlMessage': {
                                'value': 'string'
                            },
                            'imageResponseCard': {
                                'title': 'string',
                                'subtitle': 'string',
                                'imageUrl': 'string',
                                'buttons': [
                                    {
                                        'text': 'string',
                                        'value': 'string'
                                    },
                                ]
                            }
                        },
                    ]
                },
            ],
            'maxRetries': 123,
            'allowInterrupt': True|False
        },
        'sampleUtterances': [
            {
                'utterance': 'string'
            },
        ],
        'waitAndContinueSpecification': {
            'waitingResponse': {
                'messageGroups': [
                    {
                        'message': {
                            'plainTextMessage': {
                                'value': 'string'
                            },
                            'customPayload': {
                                'value': 'string'
                            },
                            'ssmlMessage': {
                                'value': 'string'
                            },
                            'imageResponseCard': {
                                'title': 'string',
                                'subtitle': 'string',
                                'imageUrl': 'string',
                                'buttons': [
                                    {
                                        'text': 'string',
                                        'value': 'string'
                                    },
                                ]
                            }
                        },
                        'variations': [
                            {
                                'plainTextMessage': {
                                    'value': 'string'
                                },
                                'customPayload': {
                                    'value': 'string'
                                },
                                'ssmlMessage': {
                                    'value': 'string'
                                },
                                'imageResponseCard': {
                                    'title': 'string',
                                    'subtitle': 'string',
                                    'imageUrl': 'string',
                                    'buttons': [
                                        {
                                            'text': 'string',
                                            'value': 'string'
                                        },
                                    ]
                                }
                            },
                        ]
                    },
                ],
                'allowInterrupt': True|False
            },
            'continueResponse': {
                'messageGroups': [
                    {
                        'message': {
                            'plainTextMessage': {
                                'value': 'string'
                            },
                            'customPayload': {
                                'value': 'string'
                            },
                            'ssmlMessage': {
                                'value': 'string'
                            },
                            'imageResponseCard': {
                                'title': 'string',
                                'subtitle': 'string',
                                'imageUrl': 'string',
                                'buttons': [
                                    {
                                        'text': 'string',
                                        'value': 'string'
                                    },
                                ]
                            }
                        },
                        'variations': [
                            {
                                'plainTextMessage': {
                                    'value': 'string'
                                },
                                'customPayload': {
                                    'value': 'string'
                                },
                                'ssmlMessage': {
                                    'value': 'string'
                                },
                                'imageResponseCard': {
                                    'title': 'string',
                                    'subtitle': 'string',
                                    'imageUrl': 'string',
                                    'buttons': [
                                        {
                                            'text': 'string',
                                            'value': 'string'
                                        },
                                    ]
                                }
                            },
                        ]
                    },
                ],
                'allowInterrupt': True|False
            },
            'stillWaitingResponse': {
                'messageGroups': [
                    {
                        'message': {
                            'plainTextMessage': {
                                'value': 'string'
                            },
                            'customPayload': {
                                'value': 'string'
                            },
                            'ssmlMessage': {
                                'value': 'string'
                            },
                            'imageResponseCard': {
                                'title': 'string',
                                'subtitle': 'string',
                                'imageUrl': 'string',
                                'buttons': [
                                    {
                                        'text': 'string',
                                        'value': 'string'
                                    },
                                ]
                            }
                        },
                        'variations': [
                            {
                                'plainTextMessage': {
                                    'value': 'string'
                                },
                                'customPayload': {
                                    'value': 'string'
                                },
                                'ssmlMessage': {
                                    'value': 'string'
                                },
                                'imageResponseCard': {
                                    'title': 'string',
                                    'subtitle': 'string',
                                    'imageUrl': 'string',
                                    'buttons': [
                                        {
                                            'text': 'string',
                                            'value': 'string'
                                        },
                                    ]
                                }
                            },
                        ]
                    },
                ],
                'frequencyInSeconds': 123,
                'timeoutInSeconds': 123,
                'allowInterrupt': True|False
            },
            'active': True|False
        }
    },
    'obfuscationSetting': {
        'obfuscationSettingType': 'None'|'DefaultObfuscation'
    },
    'botId': 'string',
    'botVersion': 'string',
    'localeId': 'string',
    'intentId': 'string',
    'creationDateTime': datetime(2015, 1, 1),
    'lastUpdatedDateTime': datetime(2015, 1, 1),
    'multipleValuesSetting': {
        'allowMultipleValues': True|False
    }
}

Response Structure

  • (dict) --

    • slotId (string) --

      The unique identifier of the slot that was updated.

    • slotName (string) --

      The updated name of the slot.

    • description (string) --

      The updated description of the bot.

    • slotTypeId (string) --

      The updated identifier of the slot type that provides values for the slot.

    • valueElicitationSetting (dict) --

      The updated prompts that Amazon Lex sends to the user to elicit a response that provides a value for the slot.

      • defaultValueSpecification (dict) --

        A list of default values for a slot. Default values are used when Amazon Lex hasn't determined a value for a slot. You can specify default values from context variables, sesion attributes, and defined values.

        • defaultValueList (list) --

          A list of default values. Amazon Lex chooses the default value to use in the order that they are presented in the list.

          • (dict) --

            Specifies the default value to use when a user doesn't provide a value for a slot.

            • defaultValue (string) --

              The default value to use when a user doesn't provide a value for a slot.

      • slotConstraint (string) --

        Specifies whether the slot is required or optional.

      • promptSpecification (dict) --

        The prompt that Amazon Lex uses to elicit the slot value from the user.

        • messageGroups (list) --

          A collection of messages that Amazon Lex can send to the user. Amazon Lex chooses the actual message to send at runtime.

          • (dict) --

            Provides one or more messages that Amazon Lex should send to the user.

            • message (dict) --

              The primary message that Amazon Lex should send to the user.

              • plainTextMessage (dict) --

                A message in plain text format.

                • value (string) --

                  The message to send to the user.

              • customPayload (dict) --

                A message in a custom format defined by the client application.

                • value (string) --

                  The string that is sent to your application.

              • ssmlMessage (dict) --

                A message in Speech Synthesis Markup Language (SSML).

                • value (string) --

                  The SSML text that defines the prompt.

              • imageResponseCard (dict) --

                A message that defines a response card that the client application can show to the user.

                • title (string) --

                  The title to display on the response card. The format of the title is determined by the platform displaying the response card.

                • subtitle (string) --

                  The subtitle to display on the response card. The format of the subtitle is determined by the platform displaying the response card.

                • imageUrl (string) --

                  The URL of an image to display on the response card. The image URL must be publicly available so that the platform displaying the response card has access to the image.

                • buttons (list) --

                  A list of buttons that should be displayed on the response card. The arrangement of the buttons is determined by the platform that displays the button.

                  • (dict) --

                    Describes a button to use on a response card used to gather slot values from a user.

                    • text (string) --

                      The text that appears on the button. Use this to tell the user what value is returned when they choose this button.

                    • value (string) --

                      The value returned to Amazon Lex when the user chooses this button. This must be one of the slot values configured for the slot.

            • variations (list) --

              Message variations to send to the user. When variations are defined, Amazon Lex chooses the primary message or one of the variations to send to the user.

              • (dict) --

                The object that provides message text and it's type.

                • plainTextMessage (dict) --

                  A message in plain text format.

                  • value (string) --

                    The message to send to the user.

                • customPayload (dict) --

                  A message in a custom format defined by the client application.

                  • value (string) --

                    The string that is sent to your application.

                • ssmlMessage (dict) --

                  A message in Speech Synthesis Markup Language (SSML).

                  • value (string) --

                    The SSML text that defines the prompt.

                • imageResponseCard (dict) --

                  A message that defines a response card that the client application can show to the user.

                  • title (string) --

                    The title to display on the response card. The format of the title is determined by the platform displaying the response card.

                  • subtitle (string) --

                    The subtitle to display on the response card. The format of the subtitle is determined by the platform displaying the response card.

                  • imageUrl (string) --

                    The URL of an image to display on the response card. The image URL must be publicly available so that the platform displaying the response card has access to the image.

                  • buttons (list) --

                    A list of buttons that should be displayed on the response card. The arrangement of the buttons is determined by the platform that displays the button.

                    • (dict) --

                      Describes a button to use on a response card used to gather slot values from a user.

                      • text (string) --

                        The text that appears on the button. Use this to tell the user what value is returned when they choose this button.

                      • value (string) --

                        The value returned to Amazon Lex when the user chooses this button. This must be one of the slot values configured for the slot.

        • maxRetries (integer) --

          The maximum number of times the bot tries to elicit a resonse from the user using this prompt.

        • allowInterrupt (boolean) --

          Indicates whether the user can interrupt a speech prompt from the bot.

      • sampleUtterances (list) --

        If you know a specific pattern that users might respond to an Amazon Lex request for a slot value, you can provide those utterances to improve accuracy. This is optional. In most cases, Amazon Lex is capable of understanding user utterances.

        • (dict) --

          A sample utterance that invokes an intent or respond to a slot elicitation prompt.

          • utterance (string) --

            The sample utterance that Amazon Lex uses to build its machine-learning model to recognize intents.

      • waitAndContinueSpecification (dict) --

        Specifies the prompts that Amazon Lex uses while a bot is waiting for customer input.

        • waitingResponse (dict) --

          The response that Amazon Lex sends to indicate that the bot is waiting for the conversation to continue.

          • messageGroups (list) --

            A collection of responses that Amazon Lex can send to the user. Amazon Lex chooses the actual response to send at runtime.

            • (dict) --

              Provides one or more messages that Amazon Lex should send to the user.

              • message (dict) --

                The primary message that Amazon Lex should send to the user.

                • plainTextMessage (dict) --

                  A message in plain text format.

                  • value (string) --

                    The message to send to the user.

                • customPayload (dict) --

                  A message in a custom format defined by the client application.

                  • value (string) --

                    The string that is sent to your application.

                • ssmlMessage (dict) --

                  A message in Speech Synthesis Markup Language (SSML).

                  • value (string) --

                    The SSML text that defines the prompt.

                • imageResponseCard (dict) --

                  A message that defines a response card that the client application can show to the user.

                  • title (string) --

                    The title to display on the response card. The format of the title is determined by the platform displaying the response card.

                  • subtitle (string) --

                    The subtitle to display on the response card. The format of the subtitle is determined by the platform displaying the response card.

                  • imageUrl (string) --

                    The URL of an image to display on the response card. The image URL must be publicly available so that the platform displaying the response card has access to the image.

                  • buttons (list) --

                    A list of buttons that should be displayed on the response card. The arrangement of the buttons is determined by the platform that displays the button.

                    • (dict) --

                      Describes a button to use on a response card used to gather slot values from a user.

                      • text (string) --

                        The text that appears on the button. Use this to tell the user what value is returned when they choose this button.

                      • value (string) --

                        The value returned to Amazon Lex when the user chooses this button. This must be one of the slot values configured for the slot.

              • variations (list) --

                Message variations to send to the user. When variations are defined, Amazon Lex chooses the primary message or one of the variations to send to the user.

                • (dict) --

                  The object that provides message text and it's type.

                  • plainTextMessage (dict) --

                    A message in plain text format.

                    • value (string) --

                      The message to send to the user.

                  • customPayload (dict) --

                    A message in a custom format defined by the client application.

                    • value (string) --

                      The string that is sent to your application.

                  • ssmlMessage (dict) --

                    A message in Speech Synthesis Markup Language (SSML).

                    • value (string) --

                      The SSML text that defines the prompt.

                  • imageResponseCard (dict) --

                    A message that defines a response card that the client application can show to the user.

                    • title (string) --

                      The title to display on the response card. The format of the title is determined by the platform displaying the response card.

                    • subtitle (string) --

                      The subtitle to display on the response card. The format of the subtitle is determined by the platform displaying the response card.

                    • imageUrl (string) --

                      The URL of an image to display on the response card. The image URL must be publicly available so that the platform displaying the response card has access to the image.

                    • buttons (list) --

                      A list of buttons that should be displayed on the response card. The arrangement of the buttons is determined by the platform that displays the button.

                      • (dict) --

                        Describes a button to use on a response card used to gather slot values from a user.

                        • text (string) --

                          The text that appears on the button. Use this to tell the user what value is returned when they choose this button.

                        • value (string) --

                          The value returned to Amazon Lex when the user chooses this button. This must be one of the slot values configured for the slot.

          • allowInterrupt (boolean) --

            Indicates whether the user can interrupt a speech response from Amazon Lex.

        • continueResponse (dict) --

          The response that Amazon Lex sends to indicate that the bot is ready to continue the conversation.

          • messageGroups (list) --

            A collection of responses that Amazon Lex can send to the user. Amazon Lex chooses the actual response to send at runtime.

            • (dict) --

              Provides one or more messages that Amazon Lex should send to the user.

              • message (dict) --

                The primary message that Amazon Lex should send to the user.

                • plainTextMessage (dict) --

                  A message in plain text format.

                  • value (string) --

                    The message to send to the user.

                • customPayload (dict) --

                  A message in a custom format defined by the client application.

                  • value (string) --

                    The string that is sent to your application.

                • ssmlMessage (dict) --

                  A message in Speech Synthesis Markup Language (SSML).

                  • value (string) --

                    The SSML text that defines the prompt.

                • imageResponseCard (dict) --

                  A message that defines a response card that the client application can show to the user.

                  • title (string) --

                    The title to display on the response card. The format of the title is determined by the platform displaying the response card.

                  • subtitle (string) --

                    The subtitle to display on the response card. The format of the subtitle is determined by the platform displaying the response card.

                  • imageUrl (string) --

                    The URL of an image to display on the response card. The image URL must be publicly available so that the platform displaying the response card has access to the image.

                  • buttons (list) --

                    A list of buttons that should be displayed on the response card. The arrangement of the buttons is determined by the platform that displays the button.

                    • (dict) --

                      Describes a button to use on a response card used to gather slot values from a user.

                      • text (string) --

                        The text that appears on the button. Use this to tell the user what value is returned when they choose this button.

                      • value (string) --

                        The value returned to Amazon Lex when the user chooses this button. This must be one of the slot values configured for the slot.

              • variations (list) --

                Message variations to send to the user. When variations are defined, Amazon Lex chooses the primary message or one of the variations to send to the user.

                • (dict) --

                  The object that provides message text and it's type.

                  • plainTextMessage (dict) --

                    A message in plain text format.

                    • value (string) --

                      The message to send to the user.

                  • customPayload (dict) --

                    A message in a custom format defined by the client application.

                    • value (string) --

                      The string that is sent to your application.

                  • ssmlMessage (dict) --

                    A message in Speech Synthesis Markup Language (SSML).

                    • value (string) --

                      The SSML text that defines the prompt.

                  • imageResponseCard (dict) --

                    A message that defines a response card that the client application can show to the user.

                    • title (string) --

                      The title to display on the response card. The format of the title is determined by the platform displaying the response card.

                    • subtitle (string) --

                      The subtitle to display on the response card. The format of the subtitle is determined by the platform displaying the response card.

                    • imageUrl (string) --

                      The URL of an image to display on the response card. The image URL must be publicly available so that the platform displaying the response card has access to the image.

                    • buttons (list) --

                      A list of buttons that should be displayed on the response card. The arrangement of the buttons is determined by the platform that displays the button.

                      • (dict) --

                        Describes a button to use on a response card used to gather slot values from a user.

                        • text (string) --

                          The text that appears on the button. Use this to tell the user what value is returned when they choose this button.

                        • value (string) --

                          The value returned to Amazon Lex when the user chooses this button. This must be one of the slot values configured for the slot.

          • allowInterrupt (boolean) --

            Indicates whether the user can interrupt a speech response from Amazon Lex.

        • stillWaitingResponse (dict) --

          A response that Amazon Lex sends periodically to the user to indicate that the bot is still waiting for input from the user.

          • messageGroups (list) --

            One or more message groups, each containing one or more messages, that define the prompts that Amazon Lex sends to the user.

            • (dict) --

              Provides one or more messages that Amazon Lex should send to the user.

              • message (dict) --

                The primary message that Amazon Lex should send to the user.

                • plainTextMessage (dict) --

                  A message in plain text format.

                  • value (string) --

                    The message to send to the user.

                • customPayload (dict) --

                  A message in a custom format defined by the client application.

                  • value (string) --

                    The string that is sent to your application.

                • ssmlMessage (dict) --

                  A message in Speech Synthesis Markup Language (SSML).

                  • value (string) --

                    The SSML text that defines the prompt.

                • imageResponseCard (dict) --

                  A message that defines a response card that the client application can show to the user.

                  • title (string) --

                    The title to display on the response card. The format of the title is determined by the platform displaying the response card.

                  • subtitle (string) --

                    The subtitle to display on the response card. The format of the subtitle is determined by the platform displaying the response card.

                  • imageUrl (string) --

                    The URL of an image to display on the response card. The image URL must be publicly available so that the platform displaying the response card has access to the image.

                  • buttons (list) --

                    A list of buttons that should be displayed on the response card. The arrangement of the buttons is determined by the platform that displays the button.

                    • (dict) --

                      Describes a button to use on a response card used to gather slot values from a user.

                      • text (string) --

                        The text that appears on the button. Use this to tell the user what value is returned when they choose this button.

                      • value (string) --

                        The value returned to Amazon Lex when the user chooses this button. This must be one of the slot values configured for the slot.

              • variations (list) --

                Message variations to send to the user. When variations are defined, Amazon Lex chooses the primary message or one of the variations to send to the user.

                • (dict) --

                  The object that provides message text and it's type.

                  • plainTextMessage (dict) --

                    A message in plain text format.

                    • value (string) --

                      The message to send to the user.

                  • customPayload (dict) --

                    A message in a custom format defined by the client application.

                    • value (string) --

                      The string that is sent to your application.

                  • ssmlMessage (dict) --

                    A message in Speech Synthesis Markup Language (SSML).

                    • value (string) --

                      The SSML text that defines the prompt.

                  • imageResponseCard (dict) --

                    A message that defines a response card that the client application can show to the user.

                    • title (string) --

                      The title to display on the response card. The format of the title is determined by the platform displaying the response card.

                    • subtitle (string) --

                      The subtitle to display on the response card. The format of the subtitle is determined by the platform displaying the response card.

                    • imageUrl (string) --

                      The URL of an image to display on the response card. The image URL must be publicly available so that the platform displaying the response card has access to the image.

                    • buttons (list) --

                      A list of buttons that should be displayed on the response card. The arrangement of the buttons is determined by the platform that displays the button.

                      • (dict) --

                        Describes a button to use on a response card used to gather slot values from a user.

                        • text (string) --

                          The text that appears on the button. Use this to tell the user what value is returned when they choose this button.

                        • value (string) --

                          The value returned to Amazon Lex when the user chooses this button. This must be one of the slot values configured for the slot.

          • frequencyInSeconds (integer) --

            How often a message should be sent to the user. Minimum of 1 second, maximum of 5 minutes.

          • timeoutInSeconds (integer) --

            If Amazon Lex waits longer than this length of time for a response, it will stop sending messages.

          • allowInterrupt (boolean) --

            Indicates that the user can interrupt the response by speaking while the message is being played.

        • active (boolean) --

          Specifies whether the bot will wait for a user to respond. When this field is false, wait and continue responses for a slot aren't used and the bot expects an appropriate response within the configured timeout. If the active field isn't specified, the default is true.

    • obfuscationSetting (dict) --

      The updated setting that determines whether the slot value is obfuscated in the Amazon CloudWatch logs.

      • obfuscationSettingType (string) --

        Value that determines whether Amazon Lex obscures slot values in conversation logs. The default is to obscure the values.

    • botId (string) --

      The identifier of the bot that contains the slot.

    • botVersion (string) --

      The identifier of the slot version that contains the slot. Will always be DRAFT .

    • localeId (string) --

      The locale that contains the slot.

    • intentId (string) --

      The intent that contains the slot.

    • creationDateTime (datetime) --

      The timestamp of the date and time that the slot was created.

    • lastUpdatedDateTime (datetime) --

      The timestamp of the date and time that the slot was last updated.

    • multipleValuesSetting (dict) --

      Indicates whether the slot accepts multiple values in one response.

      • allowMultipleValues (boolean) --

        Indicates whether a slot can return multiple values. When true , the slot may return more than one value in a response. When false , the slot returns only a single value.

        Multi-value slots are only available in the en-US locale. If you set this value to true in any other locale, Amazon Lex throws a ValidationException .

        If the allowMutlipleValues is not set, the default value is false .