CreateIntentVersion - Amazon Lex versione 1
Sintassi della richiestaParametri della richiesta URICorpo della richiestaSintassi della rispostaElementi di rispostaErroriVedi anche

Se utilizzi Amazon Lex V2, consulta invece la guida Amazon Lex V2.

 

Se utilizzi Amazon Lex V1, ti consigliamo di aggiornare i bot ad Amazon Lex V2. Non stiamo più aggiungendo nuove funzionalità alla V1 e consigliamo vivamente di utilizzare la V2 per tutti i nuovi bot.

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à.

CreateIntentVersion

Crea una nuova versione di un intento basata sulla $LATEST versione dell'intento. Se la $LATEST versione di questo intento non è cambiata dall'ultimo aggiornamento, Amazon Lex non crea una nuova versione. Restituisce l'ultima versione che hai creato.

Nota

Puoi aggiornare solo la $LATEST versione dell'intento. Non è possibile aggiornare le versioni numerate create con l'CreateIntentVersionoperazione.

Quando crei una versione di un intento, Amazon Lex imposta la versione su 1. Le versioni successive aumentano di 1. Per ulteriori informazioni, consulta Funzione Controllo delle versioni.

Questa operazione necessita delle autorizzazioni a eseguire l'operazione lex:CreateIntentVersion.

Sintassi della richiesta

POST /intents/name/versions HTTP/1.1
Content-type: application/json

{
   "checksum": "string"
}

Parametri della richiesta URI

La richiesta utilizza i seguenti parametri URI.

name

Il nome dell'intento di cui desideri creare una nuova versione. Il nome distingue tra maiuscole e minuscole.

Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 100.

Modello: ^([A-Za-z]_?)+$

Campo obbligatorio: sì

Corpo della richiesta

La richiesta accetta i seguenti dati in formato JSON.

checksum

Checksum della $LATEST versione dell'intento da utilizzare per creare la nuova versione. Se specifichi un checksum e la $LATEST versione dell'intento ha un checksum diverso, Amazon Lex restituisce un'PreconditionFailedExceptioneccezione e non pubblica una nuova versione. Se non specifichi un checksum, Amazon Lex pubblica la $LATEST versione.

▬Tipo: stringa

Campo obbligatorio: no

Sintassi della risposta

HTTP/1.1 201
Content-type: application/json

{
   "checksum": "string",
   "conclusionStatement": { 
      "messages": [ 
         { 
            "content": "string",
            "contentType": "string",
            "groupNumber": number
         }
      ],
      "responseCard": "string"
   },
   "confirmationPrompt": { 
      "maxAttempts": number,
      "messages": [ 
         { 
            "content": "string",
            "contentType": "string",
            "groupNumber": number
         }
      ],
      "responseCard": "string"
   },
   "createdDate": number,
   "description": "string",
   "dialogCodeHook": { 
      "messageVersion": "string",
      "uri": "string"
   },
   "followUpPrompt": { 
      "prompt": { 
         "maxAttempts": number,
         "messages": [ 
            { 
               "content": "string",
               "contentType": "string",
               "groupNumber": number
            }
         ],
         "responseCard": "string"
      },
      "rejectionStatement": { 
         "messages": [ 
            { 
               "content": "string",
               "contentType": "string",
               "groupNumber": number
            }
         ],
         "responseCard": "string"
      }
   },
   "fulfillmentActivity": { 
      "codeHook": { 
         "messageVersion": "string",
         "uri": "string"
      },
      "type": "string"
   },
   "inputContexts": [ 
      { 
         "name": "string"
      }
   ],
   "kendraConfiguration": { 
      "kendraIndex": "string",
      "queryFilterString": "string",
      "role": "string"
   },
   "lastUpdatedDate": number,
   "name": "string",
   "outputContexts": [ 
      { 
         "name": "string",
         "timeToLiveInSeconds": number,
         "turnsToLive": number
      }
   ],
   "parentIntentSignature": "string",
   "rejectionStatement": { 
      "messages": [ 
         { 
            "content": "string",
            "contentType": "string",
            "groupNumber": number
         }
      ],
      "responseCard": "string"
   },
   "sampleUtterances": [ "string" ],
   "slots": [ 
      { 
         "defaultValueSpec": { 
            "defaultValueList": [ 
               { 
                  "defaultValue": "string"
               }
            ]
         },
         "description": "string",
         "name": "string",
         "obfuscationSetting": "string",
         "priority": number,
         "responseCard": "string",
         "sampleUtterances": [ "string" ],
         "slotConstraint": "string",
         "slotType": "string",
         "slotTypeVersion": "string",
         "valueElicitationPrompt": { 
            "maxAttempts": number,
            "messages": [ 
               { 
                  "content": "string",
                  "contentType": "string",
                  "groupNumber": number
               }
            ],
            "responseCard": "string"
         }
      }
   ],
   "version": "string"
}

Elementi di risposta

Se l'operazione riesce, il servizio restituisce una risposta HTTP 201.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

checksum

Checksum della versione dell'intento creata.

▬Tipo: stringa

conclusionStatement

Dopo che la funzione Lambda specificata nel fulfillmentActivity campo soddisfa l'intento, Amazon Lex trasmette questa dichiarazione all'utente.

Tipo: oggetto Statement

confirmationPrompt

Se definito, il prompt utilizzato da Amazon Lex per confermare l'intenzione dell'utente prima di soddisfarla.

Tipo: oggetto Prompt

createdDate

La data di creazione dell'intento.

Tipo: Timestamp

description

Una descrizione dell'intento.

▬Tipo: stringa

Limitazioni di lunghezza: lunghezza minima di 0. Lunghezza massima di 200.

dialogCodeHook

Se definita, Amazon Lex richiama questa funzione Lambda per ogni input dell'utente.

Tipo: oggetto CodeHook

followUpPrompt

Se definito, Amazon Lex utilizza questo prompt per sollecitare attività utente aggiuntive dopo il raggiungimento dell'intento.

Tipo: oggetto FollowUpPrompt

fulfillmentActivity

Descrive come viene soddisfatto l'intento.

Tipo: oggetto FulfillmentActivity

inputContexts

Una serie di InputContext oggetti che elenca i contesti che devono essere attivi affinché Amazon Lex possa scegliere l'intento in una conversazione con l'utente.

Tipo: matrice di oggetti InputContext

Membri dell'array: numero minimo di 0 elementi. Numero massimo 5 elementi.

kendraConfiguration

Informazioni di configurazione, se presenti, per connettere un indice Amazon Kendra con l'intento. AMAZON.KendraSearchIntent

Tipo: oggetto KendraConfiguration

lastUpdatedDate

La data in cui l'intento è stato aggiornato.

Tipo: Timestamp

name

Il nome dell'intento.

▬Tipo: stringa

Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 100.

Modello: ^([A-Za-z]_?)+$

outputContexts

Una matrice di OutputContext oggetti che elenca i contesti che l'intento attiva quando l'intento viene soddisfatto.

Tipo: matrice di oggetti OutputContext

Membri dell'array: numero minimo di 0 elementi. Numero massimo di 10 elementi.

parentIntentSignature

Un identificatore univoco per un intento incorporato.

▬Tipo: stringa

rejectionStatement

Se l'utente risponde «no» alla domanda definita inconfirmationPrompt, Amazon Lex risponde con questa dichiarazione per confermare che l'intento è stato annullato.

Tipo: oggetto Statement

sampleUtterances

Una serie di espressioni di esempio configurate per l'intento.

Tipo: matrice di stringhe

Membri dell'array: numero minimo di 0 elementi. Numero massimo di 1500 articoli.

Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 200.

slots

Una serie di tipi di slot che definisce le informazioni necessarie per soddisfare l'intento.

Tipo: matrice di oggetti Slot

Membri dell'array: numero minimo di 0 elementi. Numero massimo di 100 elementi.

version

Il numero di versione assegnato alla nuova versione dell'intento.

▬Tipo: stringa

Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 64 caratteri.

Modello: \$LATEST|[0-9]+

Errori

BadRequestException

La richiesta non è ben formulata. Ad esempio, un valore non è valido o manca un campo obbligatorio. Controlla i valori del campo e riprova.

Codice di stato HTTP: 400

ConflictException

Si è verificato un conflitto nell'elaborazione della richiesta. Riprova la richiesta.

Codice di stato HTTP: 409

InternalFailureException

Si è verificato un errore interno di Amazon Lex. Riprova la richiesta.

Codice di stato HTTP: 500

LimitExceededException

La richiesta ha superato il limite. Riprova la richiesta.

Codice di stato HTTP: 429

NotFoundException

La risorsa specificata nella richiesta non è stata trovata. Controlla la risorsa e riprova.

Codice di stato HTTP: 404

PreconditionFailedException

Il checksum della risorsa che stai cercando di modificare non corrisponde al checksum della richiesta. Controlla il checksum della risorsa e riprova.

Codice di stato HTTP: 412

Vedi anche

Per ulteriori informazioni sull'utilizzo di questa API in uno degli AWS SDK specifici della lingua, consulta quanto segue: