StartBotConversation

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

L'StartBotConversationazione stabilisce una conversazione vocale tra un utente finale e il tuo bot Amazon Lex v2. L'utente fornisce le informazioni richieste al bot. Il bot restituisce quindi le informazioni alla funzione Audio Lambda della rete telefonica pubblica commutata (PSTN) e la funzione esegue le attività richieste.

Ad esempio, il bot può riprodurre un messaggio di benvenuto opzionale all'inizio di una conversazione per descrivere brevemente l'attività che la funzione audio Lambda PSTN può eseguire. La conversazione va avanti e indietro tra l'utente e il bot finché il bot non raccoglie le informazioni richieste. Al termine della conversazione, l'SDK Amazon Chime richiama la funzione audio Lambda PSTN con un evento di successo dell'azione, che contiene le informazioni raccolte dal bot. La funzione Lambda audio PSTN elabora le informazioni ed esegue l'operazione richiesta.

Il servizio audio offre interazioni conversazionali realistiche con gli utenti. Ad esempio, gli utenti possono interrompere il bot e rispondere a una domanda prima del termine del prompt audio. Inoltre, gli utenti possono utilizzare qualsiasi combinazione di cifre vocali e DTMF per fornire informazioni. Il bot attende che l'utente fornisca un input prima di rispondere. È possibile configurare per quanto tempo il bot attende che l'utente finisca di parlare prima di interpretare qualsiasi input vocale. L'utente può anche indicare al bot di attendere se ha bisogno di tempo per recuperare informazioni aggiuntive durante una chiamata, come i numeri delle carte di credito.

L'StartBotConversationazione utilizza Amazon Lex e Amazon Polly per tutta la durata della conversazione con il bot. Si applicano i costi standard di Amazon Lex e Amazon Polly. Per ulteriori informazioni sui prezzi, consulta le pagine dei prezzi delle conversazioni in streaming di Amazon Lex e dei prezzi di Amazon Polly.

StartBotConversation sintassi

L'esempio seguente mostra la StartBotConversation sintassi tipica.

{
  "SchemaVersion": "1.0",
  "Actions":[
    {
      "Type": "StartBotConversation",
      "Parameters": {
        "CallId": "string",
        "ParticipantTag": "string",
        "BotAliasArn": "string",
        "LocaleId": "string",
        "Configuration": {
          "SessionState": {
             "SessionAttributes": {
                "string": "string" 
             },
             "DialogAction" : {
               "Type": "string"
             }
          },
          "WelcomeMessages": [
            {
              "Content": "string",
              "ContentType": "string" 
            }
          ]
        }
      }
    }
  ]
}

Utilizzo di StartBotConversation action

L'esempio seguente mostra un'StartBotConversationazione tipica.

{
  "SchemaVersion": "1.0",
  "Actions":[
    {
      "Type": "StartBotConversation",
      "Parameters": {
        "CallId": "call-id-1",
        "BotAliasArn": "arn:aws:lex:us-east-1:123456789012:bot-alias/ABCDEFGHIH/MNOPQRSTUV",
        "LocaleId": "en_US",
        "Configuration": {
          "SessionState": {
             "SessionAttributes": {
                "mykey1": "myvalue1" 
             },
             "DialogAction" : {
               "Type": "ElicitIntent"
             }
          },
          "WelcomeMessages": [
            {
              "Content": "Welcome. How can I help you?",
              "ContentType": "PlainText" 
            }
          ]
        }
      }
    }
  ]
}

Manipolazione ACTION_SUCCESSFUL events

L'esempio seguente mostra un ACTION_SUCCESSFUL evento tipico dell'StartBotConversationazione.

{
    "SchemaVersion": "1.0",
    "Sequence": number,
    "InvocationEventType": "ACTION_SUCCESSFUL",
    "ActionData":
    {
        "CallId": "string",
        "Type": "StartBotConversation",
        "Parameters": {
            // parameters provided in the StartBotConversation action.
        },
        "CallDetails": {
            // Information about the call associated with the AWS Lambda invocation.
        },
        "IntentResult": {
            "SessionId": "string",
            "SessionState": {
                "SessionAttributes": {
                    "string": "string"
                },
                "Intent": {
                    "Name": "string",
                    "Slots":  {
                        "string": {
                            "Value": {
                                "OriginalValue": "string",
                                "InterpretedValue": "string",
                                "ResolvedValues": ["string"]
                            },
                            "Values": []
                        }
                    },
                    "State": "string",
                    "ConfirmationState": "string"
                }
            },
            "Interpretations": [
                {
                    "NluConfidence": {
                        "Score": number
                    },
                    "Intent": {
                        "Name": "string",
                        "Slots": {
                            "string": {
                                "Value": {
                                    "OriginalValue": "string",
                                    "InterpretedValue": "string",
                                    "ResolvedValues": ["string"]
                                },
                                "Values": []
                            }
                        },
                        "State": "string",
                        "ConfirmationState": "string"
                    }
                }
            ]
        }
    }
}

Gestione ACTION_FAILED events

L'esempio seguente mostra un ACTION_FAILED evento tipico dell'StartBotConversationazione.

{
    "SchemaVersion": "1.0",
    "Sequence": number,
    "InvocationEventType": "ACTION_FAILED",
    "ActionData":{
        "CallId": "string",
        "Type": "StartBotConversation",
        "Parameters": {
            // parameters provided in the StartBotConversation action
        },
        "ErrorType": "string",
        "ErrorMessage": "string"
    },
    "CallDetails":{
    }
}

Codici di errore

La tabella seguente elenca i messaggi di errore che una funzione Lambda può restituire in un ACTION_FAILED evento.

Concessione delle autorizzazioni per l'utilizzo di un bot

L'esempio seguente concede all'SDK Amazon Chime l'autorizzazione a chiamare Amazon Lex. StartConversation APIs. È necessario concedere esplicitamente al servizio audio l'autorizzazione a utilizzare il bot. Il blocco delle condizioni è richiesto per i responsabili del servizio. Il blocco condition deve utilizzare le chiavi di contesto globali AWS:SourceAccount eAWS:SourceArn. AWS:SourceAccountÈ l'ID del tuo account AWS. AWS:SourceArnÈ l'ARN della risorsa dell'applicazione audio PSTN che richiama il bot Lex.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "AllowChimePstnAudioUseBot",
      "Effect": "Allow",
      "Principal": {
        "Service": "voiceconnector.chime.amazonaws.com"
      },
      "Action": "lex:StartConversation",
      "Resource": "arn:aws:lex:region:awsAccountId:bot-alias/botId/aliasId",
      "Condition": {
        "StringEquals": {
          "AWS:SourceAccount": "awsAccountId"
        },
        "ArnEquals": {
        "AWS:SourceArn": "arn:aws:voiceconnector:region:awsAccountId:sma/smaId"
        }
      }
    }
  ]
}

Configurazione dei timeout vocali e DTMF

È possibile configurare i timeout vocali e DTMF durante l'acquisizione dell'input dell'utente. Puoi configurare i timeout tramite gli attributi di sessione quando inizi una conversazione con un bot e sovrascriverli nella funzione Lambda del tuo bot Lex, se necessario. Amazon Lex ti consente di impostare più slot per un intento o per i bot. Poiché puoi specificare che gli attributi di sessione si applicano all'intento e al livello di slot, puoi specificare che l'attributo sia impostato solo quando si sta raccogliendo un determinato tipo di input. Ad esempio, puoi specificare un timeout più lungo quando raccogli un numero di account rispetto a quando raccogli una data. Puoi usare i caratteri jolly nella chiave dell'attributo di sessione.

Ad esempio, per impostare un timeout vocale per tutti gli slot a tutti gli effetti su 4000 millisecondi, puoi fornire un attributo di sessione utilizzando: x-amz-lex:start-timeout-ms:*:* come nome dell'attributo di sessione e 4000 come valore dell'attributo di sessione. Per ulteriori informazioni, consulta Configurazione dei timeout per l'acquisizione dell'input dell'utente nella Amazon Lex Developer Guide.

Utilizzo degli ingressi DTMF durante una conversazione

I bot di Amazon Lex supportano l'input vocale e da tastiera durante una conversazione. I bot interpretano gli input da tastiera come cifre DTMF. Puoi richiedere ai contatti di terminare l'immissione con un tasto cancelletto (#) e di annullare una conversazione usando il tasto asterisco (*). Se non chiedi ai clienti di terminare l'immissione con il tasto cancelletto, Lex smette di attendere la pressione di altri tasti dopo 5 secondi.

Quote di fatturazione e servizio

AWS ti addebita i seguenti costi:

È inoltre necessario conoscere le seguenti quote di servizio: