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

CreateBotVersion

Crea una nuova versione del bot basata sulla $LATEST versione. Se la $LATEST versione di questa risorsa non è cambiata da quando hai creato l'ultima versione, Amazon Lex non crea una nuova versione. Restituisce l'ultima versione creata.

Nota

Puoi aggiornare solo la $LATEST versione del bot. Non è possibile aggiornare le versioni numerate create con l'CreateBotVersionoperazione.

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

Questa operazione richiede l’autorizzazione per l'operazione lex:CreateBotVersion.

Sintassi della richiesta

POST /bots/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 del bot di cui desideri creare una nuova versione. Il nome distingue tra maiuscole e minuscole.

Vincoli di lunghezza: lunghezza minima di 2. La lunghezza massima è 50 caratteri.

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

Campo obbligatorio: sì

Corpo della richiesta

La richiesta accetta i seguenti dati in formato JSON.

checksum

Identifica una revisione specifica della $LATEST versione del bot. Se specifichi un checksum e la $LATEST versione del bot ha un checksum diverso, viene restituita un'PreconditionFailedExceptioneccezione e Amazon Lex 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

{
   "abortStatement": { 
      "messages": [ 
         { 
            "content": "string",
            "contentType": "string",
            "groupNumber": number
         }
      ],
      "responseCard": "string"
   },
   "checksum": "string",
   "childDirected": boolean,
   "clarificationPrompt": { 
      "maxAttempts": number,
      "messages": [ 
         { 
            "content": "string",
            "contentType": "string",
            "groupNumber": number
         }
      ],
      "responseCard": "string"
   },
   "createdDate": number,
   "description": "string",
   "detectSentiment": boolean,
   "enableModelImprovements": boolean,
   "failureReason": "string",
   "idleSessionTTLInSeconds": number,
   "intents": [ 
      { 
         "intentName": "string",
         "intentVersion": "string"
      }
   ],
   "lastUpdatedDate": number,
   "locale": "string",
   "name": "string",
   "status": "string",
   "version": "string",
   "voiceId": "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.

abortStatement

Il messaggio che Amazon Lex utilizza per annullare una conversazione. Per ulteriori informazioni, consulta PutBot.

Tipo: oggetto Statement

checksum

Checksum che identifica la versione del bot che è stata creata.

▬Tipo: stringa

childDirected

Per ogni bot Amazon Lex creato con Amazon Lex Model Building Service, devi specificare se l'uso di Amazon Lex è correlato a un sito Web, programma o altra applicazione indirizzato o destinato, in tutto o in parte, a bambini di età inferiore ai 13 anni e soggetto al Children's Online Privacy Protection Act (COPPA) specificando true o false nel childDirected campo. Specificando true nel childDirected campo, confermi che l'uso di Amazon Lex è correlato a un sito Web, programma o altra applicazione indirizzato o destinato, in tutto o in parte, a bambini di età inferiore ai 13 anni e soggetto al COPPA. Specificando false nel childDirected campo, confermi che l'uso di Amazon Lex non è correlato a un sito Web, programma o altra applicazione indirizzato o destinato, in tutto o in parte, a bambini di età inferiore ai 13 anni e soggetti al COPPA. Non puoi specificare un valore predefinito per il childDirected campo che non riflette accuratamente se l'uso di Amazon Lex è correlato a un sito Web, programma o altra applicazione indirizzata o destinata, in tutto o in parte, a bambini di età inferiore ai 13 anni e soggetta al COPPA.

Se l'uso di Amazon Lex si riferisce a un sito Web, programma o altra applicazione rivolta, in tutto o in parte, a bambini di età inferiore ai 13 anni, devi ottenere il consenso genitoriale verificabile richiesto ai sensi del COPPA. Per informazioni sull'uso di Amazon Lex in relazione a siti Web, programmi o altre applicazioni rivolti o destinati, in tutto o in parte, a bambini di età inferiore ai 13 anni, consulta le domande frequenti su Amazon Lex.

Tipo: Booleano

clarificationPrompt

Il messaggio che Amazon Lex utilizza quando non comprende la richiesta dell'utente. Per ulteriori informazioni, consulta PutBot.

Tipo: oggetto Prompt

createdDate

La data in cui è stata creata la versione del bot.

Tipo: Timestamp

description

Una descrizione del bot.

▬Tipo: stringa

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

detectSentiment

Indica se gli enunciati inseriti dall'utente devono essere inviati ad Amazon Comprehend per l'analisi del sentiment.

Tipo: Booleano

enableModelImprovements

Indica se il bot utilizza miglioramenti di precisione. trueindica che il bot sta utilizzando i miglioramenti, altrimentifalse.

Tipo: Booleano

failureReason

In caso status FAILED affermativo, Amazon Lex fornisce il motivo per cui non è riuscita a creare il bot.

▬Tipo: stringa

idleSessionTTLInSeconds

Il tempo massimo, in secondi, durante il quale Amazon Lex conserva i dati raccolti in una conversazione. Per ulteriori informazioni, consulta PutBot.

Tipo: integer

Intervallo valido: valore minimo pari a 60. Valore massimo pari a 86400.

intents

Un array di oggetti Intent. Per ulteriori informazioni, consulta PutBot.

Tipo: matrice di oggetti Intent

lastUpdatedDate

La data in cui è stata aggiornata la $LATEST versione di questo bot.

Tipo: Timestamp

locale

Specifica la lingua di destinazione per il bot.

▬Tipo: stringa

Valori validi: de-DE | en-AU | en-GB | en-IN | en-US | es-419 | es-ES | es-US | fr-FR | fr-CA | it-IT | ja-JP | ko-KR

name

Il nome del bot.

▬Tipo: stringa

Vincoli di lunghezza: lunghezza minima di 2. La lunghezza massima è 50 caratteri.

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

status

Quando invii una richiesta per creare o aggiornare un bot, Amazon Lex imposta l'elemento di status risposta suBUILDING. Dopo che Amazon Lex ha creato il bot, viene status impostato suREADY. Se Amazon Lex non è in grado di creare il bot, status lo impostaFAILED. Amazon Lex restituisce il motivo dell'errore nell'elemento di failureReason risposta.

▬Tipo: stringa

Valori validi: BUILDING | READY | READY_BASIC_TESTING | FAILED | NOT_BUILT

version

La versione del bot.

▬Tipo: stringa

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

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

voiceId

L'ID vocale Amazon Polly utilizzato da Amazon Lex per le interazioni vocali con l'utente.

▬Tipo: stringa

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: