Evento di input e formato di risposta della funzione Lambda

currentIntent: fornisce i campi name, slots, slotDetails e confirmationStatus dell'intento.

nluIntentConfidenceScoreè la fiducia di Amazon Lex che l'intento attuale è quello che meglio corrisponde all'intento attuale dell'utente.

slotsè una mappa di nomi di slot, configurati per l'intento, ai valori degli slot che Amazon Lex ha riconosciuto nella conversazione con l'utente. Un valore di slot rimane null fino a quando l'utente non fornisca un valore.

Il valore dello slot nell'evento di input potrebbe non corrispondere a uno dei valori configurati per lo slot. Ad esempio, se l'utente risponde alla richiesta «Di che colore è l'auto che preferisci?» con «pizza», Amazon Lex restituirà «pizza» come valore dello slot. La funzione dovrebbe convalidare i valori per assicurare che questi abbiano senso nel contesto.

slotDetails fornisce ulteriori informazioni su un valore dello slot. La matrice resolutions contiene un elenco di valori aggiuntivi riconosciuti per lo slot. Ciascuno slot può avere un massimo di cinque valori.

Il campo originalValue contiene il valore che l'utente ha inserito per lo slot. Quando il tipo di slot è configurato per restituire il valore di risoluzione superiore come valore dello slot, originalValue potrebbe essere diverso dal valore del campo slots.

confirmationStatus fornisce la risposta dell'utente a un messaggio di richiesta di conferma, se disponibile. Ad esempio, se Amazon Lex chiede «Vuoi ordinare una pizza grande al formaggio? ,» a seconda della risposta dell'utente, il valore di questo campo può essere Confirmed oDenied. In caso contrario, il valore di questo campo è None.

Se l'utente conferma l'intento, Amazon Lex imposta questo campo su. Confirmed Se l'utente nega l'intenzione, Amazon Lex imposta questo valore su. Denied

Nella risposta di conferma, un'enunciazione utente potrebbe fornire aggiornamenti dello slot. Ad esempio, l'utente potrebbe dire "Sì, modifica dimensione a media". In questo caso, l'evento Lambda successivo ha il valore dello slot aggiornato, PizzaSize impostato su. medium Amazon Lex imposta il confirmationStatus toNone, poiché l'utente ha modificato alcuni dati dello slot, richiedendo la funzione Lambda per eseguire la convalida dei dati utente.

AlternativeIntents: se abiliti i punteggi di confidenza, Amazon Lex restituisce fino a quattro intenti alternativi. Ogni intento include un punteggio che indica il livello di fiducia di Amazon Lex rispetto all'intento corretto in base all'espressione dell'utente.

Il contenuto degli intenti alternativi è lo stesso del contenuto del campo. currentIntent Per ulteriori informazioni, consulta Utilizzo dei punteggi di confidenza.

bot: informazioni sul bot che ha elaborato la richiesta.

userID: questo valore viene fornito dall'applicazione client. Amazon Lex lo passa alla funzione Lambda.

inputTranscript: testo utilizzato per elaborare la richiesta.

Se si tratta di un input di testo, il campo inputTranscript contiene il testo inserito dall'utente.

In caso di input di flusso audio, il campo inputTranscript contiene il testo estratto dal flusso audio. Questo è il testo che viene effettivamente elaborato per riconoscere gli intenti e i valori dello slot.

InvocationSource: per indicare il motivo per cui Amazon Lex richiama la funzione Lambda, la imposta su uno dei seguenti valori:

Nella configurazione dell'intento, puoi avere due funzioni Lambda separate per inizializzare e convalidare i dati utente e soddisfare l'intento. Puoi anche usare una funzione Lambda per fare entrambe le cose. In tal caso, la funzione Lambda può utilizzare il invocationSource valore per seguire il percorso del codice corretto.

outputDialogMode— Per ogni input dell'utente, il client invia la richiesta ad Amazon Lex utilizzando una delle operazioni API di runtime, PostContent oppurePostText. Amazon Lex utilizza i parametri di richiesta per determinare se la risposta al client è di testo o vocale e imposta questo campo di conseguenza.

La funzione Lambda può utilizzare queste informazioni per generare un messaggio appropriato. Ad esempio, se il client si aspetta una risposta vocale, la funzione Lambda potrebbe restituire Speech Synthesis Markup Language (SSML) anziché testo.

messageVersion — La versione del messaggio che identifica il formato dei dati degli eventi che entrano nella funzione Lambda e il formato previsto della risposta da una funzione Lambda.

SessionAttributes: attributi di sessione specifici dell'applicazione che il client invia nella richiesta. Se desideri che Amazon Lex li includa nella risposta al client, la tua funzione Lambda dovrebbe rispedirli ad Amazon Lex nella risposta. Per ulteriori informazioni, consulta Impostazione degli attributi di sessione

RequestAttributes: attributi specifici della richiesta che il client invia nella richiesta. Utilizza gli attributi di richiesta per inviare informazioni che non devono essere conservate per l'intera sessione. Se non ci sono attributi della richiesta, il valore sarà null. Per ulteriori informazioni, consulta Impostazione degli attributi di richiesta

recentIntentSummaryVisualizza: informazioni sullo stato di un intento. È possibile visualizzare informazioni sugli ultimi tre intenti utilizzati. Queste informazioni possono essere usate per impostare i valori nell'intento o per tornare a un intento precedente. Per ulteriori informazioni, consulta Gestione delle sessioni con l'API Amazon Lex.

SentimentResponse: il risultato di un'analisi del sentiment di Amazon Comprehend dell'ultima espressione. È possibile utilizzare queste informazioni per gestire il flusso di conversazione del bot in base all'emozione espressa dall'utente. Per ulteriori informazioni, consulta Analisi delle emozioni.

KendraResponse: il risultato di una query su un indice Amazon Kendra. Presente solo nell'input a un hook di codice di adempimento e solo quando l'intento estende l'intento integrato AMAZON.KendraSearchIntent. Il campo contiene l'intera risposta della ricerca di Amazon Kendra. Per ulteriori informazioni, consulta AMAZON.KendraSearchIntent.

ActiveContexts: uno o più contesti attivi durante questo turno di conversazione con l'utente.

Per ulteriori informazioni, consulta Impostazione del contesto degli intenti.

Close— Informa Amazon Lex di non aspettarsi una risposta dall'utente. Ad esempio, "L'ordine della tua pizza è stato registrato" non richiede una risposta.

Il campo fulfillmentState è obbligatorio. Amazon Lex utilizza questo valore per impostare il dialogState campo nella PostText risposta PostContent o all'applicazione client. I campi message e responseCard sono facoltativi. Se non specifichi un messaggio, Amazon Lex utilizza il messaggio di addio o il messaggio di follow-up configurato per l'intento.

"dialogAction": {
    "type": "Close",
    "fulfillmentState": "Fulfilled or Failed",
    "message": {
      "contentType": "PlainText or SSML or CustomPayload",
      "content": "Message to convey to the user. For example, Thanks, your pizza has been ordered."
    },
   "responseCard": {
      "version": integer-value,
      "contentType": "application/vnd.amazonaws.card.generic",
      "genericAttachments": [
          {
             "title":"card-title",
             "subTitle":"card-sub-title",
             "imageUrl":"URL of the image to be shown",
             "attachmentLinkUrl":"URL of the attachment to be associated with the card",
             "buttons":[ 
                 {
                    "text":"button-text",
                    "value":"Value sent to server on button click"
                 }
              ]
           } 
       ] 
     }
  }

ConfirmIntent— Informa Amazon Lex che l'utente deve rispondere sì o no per confermare o negare l'intenzione attuale.

È necessario includere i campi intentName e slots. Il campo slots deve contenere una voce per ciascuno slot riempito per l'intento specificato. Non è necessario includere una voce nel campo slots per gli slot che non vengono riempiti. È necessario includere il campo message se il campo intento confirmationPrompt è nullo. Il contenuto del message campo restituito dalla funzione Lambda ha la precedenza su quello confirmationPrompt specificato nell'intento. Il campo responseCard è facoltativo.

"dialogAction": {
    "type": "ConfirmIntent",
    "message": {
      "contentType": "PlainText or SSML or CustomPayload",
      "content": "Message to convey to the user. For example, Are you sure you want a large pizza?"
    },
   "intentName": "intent-name",
   "slots": {
      "slot-name": "value",
      "slot-name": "value",
      "slot-name": "value"  
   },
   "responseCard": {
      "version": integer-value,
      "contentType": "application/vnd.amazonaws.card.generic",
      "genericAttachments": [
          {
             "title":"card-title",
             "subTitle":"card-sub-title",
             "imageUrl":"URL of the image to be shown",
             "attachmentLinkUrl":"URL of the attachment to be associated with the card",
             "buttons":[ 
                 {
                    "text":"button-text",
                    "value":"Value sent to server on button click"
                 }
              ]
           } 
       ] 
     }
  }
                         

Delegate— Indica ad Amazon Lex di scegliere la linea d'azione successiva in base alla configurazione del bot. Se la risposta non include alcun attributo di sessione, Amazon Lex conserva gli attributi esistenti. Per ottenere un valore null di uno slot, non occorre includere il campo slot nella richiesta. Si riceverà un'eccezione DependencyFailedException se la funzione di adempimento restituisce l'operazione di dialogo Delegate senza rimuovere alcuno slot.

I campi kendraQueryRequestPayload e kendraQueryFilterString sono facoltativi e utilizzati solo quando l'intento è derivato dall'intento integrato AMAZON.KendraSearchIntent. Per ulteriori informazioni, consulta AMAZON.KendraSearchIntent.

  "dialogAction": {
   "type": "Delegate",
   "slots": {
      "slot-name": "value",
      "slot-name": "value",
      "slot-name": "value"  
   },
   "kendraQueryRequestPayload": "Amazon Kendra query",
   "kendraQueryFilterString": "Amazon Kendra attribute filters"
  }

ElicitIntent— Informa Amazon Lex che l'utente dovrebbe rispondere con un enunciato che include un intento. Ad esempio, "Voglio una pizza grande", che indica l'intento OrderPizzaIntent. L'espressione «grande», d'altra parte, non è sufficiente per Amazon Lex per dedurre l'intento dell'utente.

I campi message e responseCard sono facoltativi. Se non fornisci un messaggio, Amazon Lex utilizza uno dei prompt di chiarimento del bot. Se non è stata definita alcuna richiesta di chiarimento, Amazon Lex restituisce un'eccezione 400 Bad Request.

{
  "dialogAction": {
    "type": "ElicitIntent",
    "message": {
      "contentType": "PlainText or SSML or CustomPayload",
      "content": "Message to convey to the user. For example, What can I help you with?"
    },
    "responseCard": {
      "version": integer-value,
      "contentType": "application/vnd.amazonaws.card.generic",
      "genericAttachments": [
          {
             "title":"card-title",
             "subTitle":"card-sub-title",
             "imageUrl":"URL of the image to be shown",
             "attachmentLinkUrl":"URL of the attachment to be associated with the card",
             "buttons":[ 
                 {
                    "text":"button-text",
                    "value":"Value sent to server on button click"
                 }
              ]
           } 
       ] 
    }
 }                       
                        

ElicitSlot— Informa Amazon Lex che l'utente deve fornire un valore di slot nella risposta.

I campi intentName, slotToElicit e slots sono obbligatori. I campi message e responseCard sono facoltativi. Se non specifichi un messaggio, Amazon Lex utilizza uno dei prompt di elicitazione dello slot configurati per lo slot.

  "dialogAction": {
    "type": "ElicitSlot",
    "message": {
      "contentType": "PlainText or SSML or CustomPayload",
      "content": "Message to convey to the user. For example, What size pizza would you like?"
    },
   "intentName": "intent-name",
   "slots": {
      "slot-name": "value",
      "slot-name": "value",
      "slot-name": "value"  
   },
   "slotToElicit" : "slot-name",
   "responseCard": {
      "version": integer-value,
      "contentType": "application/vnd.amazonaws.card.generic",
      "genericAttachments": [
          {
             "title":"card-title",
             "subTitle":"card-sub-title",
             "imageUrl":"URL of the image to be shown",
             "attachmentLinkUrl":"URL of the attachment to be associated with the card",
             "buttons":[ 
                 {
                    "text":"button-text",
                    "value":"Value sent to server on button click"
                 }
              ]
           } 
       ] 
     }
  }