在對話期間使用拼寫樣式擷取槽值

焦點模式

在對話期間使用拼寫樣式擷取槽值 - Amazon Lex

Amazon Lex V2 提供內建插槽，可擷取使用者特有的資訊，例如名字、姓氏、電子郵件地址或英數字元識別符。例如，您可以使用 AMAZON.LastName槽擷取姓氏，例如 "Jackson" 或 "Garcia"。不過，Amazon Lex V2 可能會混淆難以發音或區域設定中不常見的姓氏，例如 "Xiulan"。若要擷取這類名稱，您可以要求使用者以字母或單字拼法提供輸入。

Amazon Lex V2 提供三種槽引出樣式供您使用。當您設定槽引出樣式時，它會變更 Amazon Lex V2 從使用者解譯輸入的方式。

字母拼寫 – 使用此樣式，您可以指示機器人接聽拼寫，而不是整個片語。例如，若要擷取姓氏，例如 "Xiulan"，您可以告訴使用者一次拼寫一個字母的姓氏。機器人將擷取拼寫並將字母解析為單字。例如，如果使用者說「x i u l a n」，機器人會擷取姓氏為「xiulan」。

逐字拼寫 – 在語音對話中，特別是使用電話時，有幾個字母，例如 "t、"b、"p"，聽起來很相似。擷取英數字元值或拼寫名稱會導致不正確的值，您可以提示使用者提供識別字和字母。例如，如果對預訂 ID 請求的語音回應是「abp123」，您的機器人可能會改為識別「abb123」一詞。如果這是不正確的值，您可以要求使用者提供輸入，如 "a as in alpha b as in boy p as in peter one two three"。機器人會將輸入解析為「abp123」。

使用逐字拼寫時，您可以使用下列格式：

"as in" （在 Apple 中為 )
"for" （適用於 Apple 的 )
"like" （類似蘋果）

預設 – 這是使用單字發音擷取插槽的自然樣式。例如，它可以自然地擷取名稱，例如 "John Stiles"。如果未指定槽引出樣式，機器人會使用預設樣式。對於 AMAZON.AlphaNumeric和 AMAZON.UKPostal程式碼槽類型，預設樣式支援字母輸入拼寫。

如果名稱「Xiulan」是使用字母和單字的混合來表達，例如「x as in x-ray i u l as in lion a n」，則槽引出樣式必須設定為spell-by-word樣式。spell-by-letter樣式無法辨識。

您應該建立語音界面，以自然的對話風格擷取槽值，以獲得更好的體驗。對於使用自然樣式未正確擷取的輸入，您可以重新提示使用者，並將槽引出樣式設定為spell-by-letter或spell-by-word寫。

您可以針對英文（美國）、英文（英國）和英文（澳洲）語言的下列槽類型，使用spell-by-wordspell-by-letter拼寫樣式：

啟用拼字

當您從使用者引出插槽時，您可以在執行階段啟用逐spell-by-letter和spell-by-word寫。您可以使用 PutSession、RecognizeText、RecognizeUtterance 或 StartConversation 操作設定拼寫樣式。您也可以使用 Lambda 函數來啟用spell-by-letter和spell-by-word。

您可以使用上述其中一個 API 操作請求sessionState中的 dialogAction 欄位，或在設定 Lambda 回應時，設定拼寫樣式（如需詳細資訊AWS Lambda Lex V2 的回應格式，請參閱）。您只能在對話方塊動作類型為時設定樣式，ElicitSlot以及在要引出的槽是支援的槽類型之一時設定樣式。

下列 JSON 程式碼顯示dialogAction欄位集，以使用spell-by-word樣式：


"dialogAction": {
    "slotElicitationStyle": "SpellByWord",
    "slotToElicit": "BookingId",
    "type": "ElicitSlot"
}

slotElicitationStyle 欄位可以設定為 SpellByLetter、SpellByWord 或 Default。如果您未指定值，則值會設為 Default。

注意

您無法透過主控台啟用spell-by-letter字母或spell-by-word引出樣式。

使用 Lambda 和 Lex V2 的範例程式碼

如果第一次嘗試解析無法運作的槽值，通常會執行變更拼寫樣式。下列程式碼範例是 Python Lambda 函數，在第二次嘗試解析槽時，spell-by-word樣式。

若要使用範例程式碼，您必須具有：

使用一種語言的機器人，英文 (GB) (en_GB)。
一個意圖，「CheckAccount」，一個範例表達用語，「我想要檢查我的帳戶」。請確定在意圖定義的程式碼掛勾區段中選取使用 Lambda 函數進行初始化和驗證。
意圖應該有一個AMAZON.UKPostalCode內建類型的槽「PostalCode」。
已定義 Lambda 函數的別名。如需詳細資訊，請參閱為您的機器人建立 AWS Lambda 函數。


import json
import time
import os
import logging

logger = logging.getLogger()
logger.setLevel(logging.DEBUG)

# --- Helpers that build all of the responses ---

def get_slots(intent_request):
    return intent_request['sessionState']['intent']['slots']

def get_session_attributes(intent_request):
    sessionState = intent_request['sessionState']
    if 'sessionAttributes' in sessionState:
        return sessionState['sessionAttributes']
    return {}

def get_slot(intent_request, slotName):
    slots = get_slots(intent_request)
    if slots is not None and slotName in slots and slots[slotName] is not None:
        logger.debug('resolvedValue={}'.format(slots[slotName]['value']['resolvedValues']))
        return slots[slotName]['value']['resolvedValues']
    else:
        return None

def elicit_slot(session_attributes, intent_request, slots, slot_to_elicit, slot_elicitation_style, message):
    return {'sessionState': {'dialogAction': {'type': 'ElicitSlot',
                                              'slotToElicit': slot_to_elicit,
                                              'slotElicitationStyle': slot_elicitation_style
                                              },
                             'intent': {'name': intent_request['sessionState']['intent']['name'],
                                        'slots': slots,
                                        'state': 'InProgress'
                                        },
                             'sessionAttributes': session_attributes,
                             'originatingRequestId': 'REQUESTID'
                             },
            'sessionId': intent_request['sessionId'],
            'messages': [ message ],
            'requestAttributes': intent_request['requestAttributes']
            if 'requestAttributes' in intent_request else None
            }

def build_validation_result(isvalid, violated_slot, slot_elicitation_style, message_content):
    return {'isValid': isvalid,
            'violatedSlot': violated_slot,
            'slotElicitationStyle': slot_elicitation_style,
            'message': {'contentType': 'PlainText', 
            'content': message_content}
            }

def GetItemInDatabase(postal_code):
    """
    Perform database check for transcribed postal code. This is a no-op
    check that shows that postal_code can't be found in the database.
    """
    return None

def validate_postal_code(intent_request):

    postal_code = get_slot(intent_request, 'PostalCode')

    if GetItemInDatabase(postal_code) is None:
        return build_validation_result(
            False,
            'PostalCode',
            'SpellByWord',
            "Sorry, I can't find your information. " +
            "To try again, spell out your postal " +
            "code using words, like a as in apple."
        )
    return {'isValid': True}

def check_account(intent_request):
    """
    Performs dialog management and fulfillment for checking an account
    with a postal code. Besides fulfillment, the implementation for this 
    intent demonstrates the following:
    1) Use of elicitSlot in slot validation and re-prompting.
    2) Use of sessionAttributes to pass information that can be used to
        guide a conversation.
    """
    slots = get_slots(intent_request)
    postal_code = get_slot(intent_request, 'PostalCode')
    session_attributes = get_session_attributes(intent_request)

    if intent_request['invocationSource'] == 'DialogCodeHook':
        # Validate the PostalCode slot. If any aren't valid, 
        # re-elicit for the value.
        validation_result = validate_postal_code(intent_request)
        if not validation_result['isValid']:
            slots[validation_result['violatedSlot']] = None
            return elicit_slot(
                session_attributes,
                intent_request,
                slots,
                validation_result['violatedSlot'],
                validation_result['slotElicitationStyle'],
                validation_result['message']
            )
    
        return close(
            intent_request,
            session_attributes,
            'Fulfilled',
            {'contentType': 'PlainText',
             'content': 'Thanks'
             }
        )

def close(intent_request, session_attributes, fulfillment_state, message):
    intent_request['sessionState']['intent']['state'] = fulfillment_state
    return {
        'sessionState': {
            'sessionAttributes': session_attributes,
            'dialogAction': {
                'type': 'Close'
            },
            'intent': intent_request['sessionState']['intent'],
            'originatingRequestId': 'xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx'
        },
        'messages': [ message ],
        'sessionId': intent_request['sessionId'],
        'requestAttributes': intent_request['requestAttributes'] if 'requestAttributes' in intent_request else None
    }

# --- Intents ---

def dispatch(intent_request):
    """
    Called when the user specifies an intent for this bot.
    """
    intent_name = intent_request['sessionState']['intent']['name']
    response = None

    # Dispatch to your bot's intent handlers
    if intent_name == 'CheckAccount':
        response = check_account(intent_request)

    return response

# --- Main handler ---

def lambda_handler(event, context):
    """
    Route the incoming request based on the intent.

    The JSON body of the request is provided in the event slot.
    """

    # By default, treat the user request as coming from 
    # Eastern Standard Time.
    os.environ['TZ'] = 'America/New_York'
    time.tzset()

    logger.debug('event={}'.format(json.dumps(event)))
    response = dispatch(event)
    logger.debug("response={}".format(json.dumps(response)))

    return response