CreateBotVersion - Amazon Lex V1
Syntaxe de la demandeParamètres de demande URICorps de la demandeSyntaxe de la réponseEléments de réponseErreursconsultez aussi

Si vous utilisez Amazon Lex V2, consultez plutôt le guide Amazon Lex V2.

 

Si vous utilisez Amazon Lex V1, nous vous recommandons de mettre à niveau vos robots vers Amazon Lex V2. Nous n'ajoutons plus de nouvelles fonctionnalités à la V1 et recommandons vivement d'utiliser la V2 pour tous les nouveaux robots.

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

CreateBotVersion

Crée une nouvelle version du bot en fonction de la $LATEST version. Si la $LATEST version de cette ressource n'a pas changé depuis que vous avez créé la dernière version, Amazon Lex ne crée pas de nouvelle version. Elle renvoie la dernière version créée.

Note

Vous ne pouvez mettre à jour que la $LATEST version du bot. Vous ne pouvez pas mettre à jour les versions numérotées que vous créez avec cette CreateBotVersion opération.

Lorsque vous créez la première version d'un bot, Amazon Lex définit la version sur 1. Les versions suivantes sont incrémentées de 1. Pour de plus amples informations, veuillez consulter Gestion des versions.

Cette opération nécessite une autorisation pour l'action lex:CreateBotVersion.

Syntaxe de la demande

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

{
   "checksum": "string"
}

Paramètres de demande URI

La demande utilise les paramètres URI suivants.

name

Nom du bot dont vous souhaitez créer une nouvelle version. Le nom est sensible à la casse.

Contraintes de longueur : longueur minimale de 2. Longueur maximale de 50.

Modèle : ^([A-Za-z]_?)+$

Obligatoire : oui

Corps de la demande

Cette demande accepte les données suivantes au format JSON.

checksum

Identifie une révision spécifique de la $LATEST version du bot. Si vous spécifiez une somme de contrôle et que la $LATEST version du bot possède une somme de contrôle différente, une PreconditionFailedException exception est renvoyée et Amazon Lex ne publie pas de nouvelle version. Si vous ne spécifiez pas de somme de contrôle, Amazon Lex publie la $LATEST version.

Type : chaîne

Obligatoire : non

Syntaxe de la réponse

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"
}

Eléments de réponse

Si l’action aboutit, le service renvoie une réponse HTTP 201.

Les données suivantes sont renvoyées au format JSON par le service.

abortStatement

Le message utilisé par Amazon Lex pour annuler une conversation. Pour de plus amples informations, veuillez consulter PutBot.

Type : objet Statement

checksum

Somme de contrôle identifiant la version du bot qui a été créée.

Type : chaîne

childDirected

Pour chaque bot Amazon Lex créé avec Amazon Lex Model Building Service, vous devez indiquer si votre utilisation d'Amazon Lex est liée à un site Web, à un programme ou à une autre application destiné ou ciblé, en tout ou en partie, aux enfants de moins de 13 ans et soumis à la loi COPPA (Children's Online Privacy Protection Act) en spécifiant true ou false dans le childDirected champ. trueEn spécifiant dans ce childDirected champ, vous confirmez que votre utilisation d'Amazon Lex est liée à un site Web, à un programme ou à une autre application destiné ou ciblé, en tout ou en partie, aux enfants de moins de 13 ans et soumis à la COPPA. falseEn spécifiant dans ce childDirected champ, vous confirmez que votre utilisation d'Amazon Lex n'est pas liée à un site Web, à un programme ou à une autre application destiné ou ciblé, en tout ou en partie, aux enfants de moins de 13 ans et soumis à la COPPA. Vous ne pouvez pas spécifier de valeur par défaut pour le childDirected champ qui ne reflète pas exactement si votre utilisation d'Amazon Lex est liée à un site Web, à un programme ou à une autre application destiné ou ciblé, en tout ou en partie, aux enfants de moins de 13 ans et soumis à la COPPA.

Si votre utilisation d'Amazon Lex concerne un site Web, un programme ou une autre application destinés, en tout ou en partie, à des enfants de moins de 13 ans, vous devez obtenir le consentement parental vérifiable requis en vertu de la COPPA. Pour plus d'informations concernant l'utilisation d'Amazon Lex en relation avec des sites Web, des programmes ou d'autres applications destinés ou ciblés, en tout ou en partie, aux enfants de moins de 13 ans, consultez la FAQ Amazon Lex.

Type : booléen

clarificationPrompt

Message utilisé par Amazon Lex lorsqu'il ne comprend pas la demande de l'utilisateur. Pour de plus amples informations, veuillez consulter PutBot.

Type : objet Prompt

createdDate

Date à laquelle la version du bot a été créée.

Type : Timestamp

description

Description du bot.

Type : chaîne

Contraintes de longueur : longueur minimum de 0. Longueur maximum de 200.

detectSentiment

Indique si les énoncés saisis par l'utilisateur doivent être envoyés à Amazon Comprehend pour analyse des sentiments.

Type : booléen

enableModelImprovements

Indique si le bot utilise des améliorations de précision. trueindique que le bot utilise les améliorations, sinon,false.

Type : booléen

failureReason

Dans status l'affirmativeFAILED, Amazon Lex fournit la raison pour laquelle il n'a pas réussi à créer le bot.

Type : chaîne

idleSessionTTLInSeconds

Durée maximale en secondes pendant laquelle Amazon Lex conserve les données collectées au cours d'une conversation. Pour de plus amples informations, veuillez consulter PutBot.

Type : entier

Plage valide : Valeur minimum de 60. Valeur maximum de 86 400.

intents

Tableau d’objets Intent. Pour de plus amples informations, veuillez consulter PutBot.

Type : tableau d’objets Intent

lastUpdatedDate

Date à laquelle la $LATEST version de ce bot a été mise à jour.

Type : Timestamp

locale

Spécifie les paramètres régionaux cibles pour le bot.

Type : chaîne

Valeurs valides : 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

Le nom du bot.

Type : chaîne

Contraintes de longueur : longueur minimale de 2. Longueur maximale de 50.

Modèle : ^([A-Za-z]_?)+$

status

Lorsque vous envoyez une demande de création ou de mise à jour d'un bot, Amazon Lex définit l'élément de status réponse surBUILDING. Une fois qu'Amazon Lex a créé le bot, celui-ci status passe àREADY. Si Amazon Lex ne parvient pas à créer le bot, il est status configuré surFAILED. Amazon Lex renvoie la raison de l'échec dans l'élément de failureReason réponse.

Type : chaîne

Valeurs valides : BUILDING | READY | READY_BASIC_TESTING | FAILED | NOT_BUILT

version

La version du bot.

Type : chaîne

Contraintes de longueur : longueur minimum de 1. Longueur maximale de 64.

Modèle : \$LATEST|[0-9]+

voiceId

L'identifiant vocal Amazon Polly utilisé par Amazon Lex pour les interactions vocales avec l'utilisateur.

Type : chaîne

Erreurs

BadRequestException

La demande n'est pas bien formulée. Par exemple, une valeur n'est pas valide ou un champ obligatoire est manquant. Vérifiez les valeurs des champs, puis réessayez.

Code d’état HTTP : 400

ConflictException

Un conflit s'est produit lors du traitement de la demande. Réessayez votre demande.

Code d’état HTTP : 409

InternalFailureException

Une erreur interne Amazon Lex s'est produite. Réessayez votre demande.

Code d’état HTTP : 500

LimitExceededException

La demande a dépassé une limite. Réessayez votre demande.

Code d’état HTTP : 429

NotFoundException

La ressource spécifiée dans la demande est introuvable. Vérifiez la ressource et réessayez.

Code d’état HTTP : 404

PreconditionFailedException

La somme de contrôle de la ressource que vous essayez de modifier ne correspond pas à la somme de contrôle de la demande. Vérifiez le checksum de la ressource et réessayez.

Code d’état HTTP : 412

consultez aussi

Pour plus d’informations sur l’utilisation de cette API dans l’un des kits SDK AWS spécifiques au langage, consultez les ressources suivantes :