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

PutSlotType

Crée un type d'option personnalisé ou remplace un type d'option personnalisé existant.

Pour créer un type d'emplacement personnalisé, spécifiez un nom pour le type d'emplacement et un ensemble de valeurs d'énumération, qui sont les valeurs qu'un emplacement de ce type peut prendre. Pour de plus amples informations, veuillez consulter Amazon Lex : comment ça marche.

Si vous spécifiez le nom d'un type de slot existant, les champs de la demande remplacent les valeurs existantes dans la $LATEST version du type de slot. Amazon Lex supprime les champs que vous ne fournissez pas dans la demande. Si vous ne spécifiez pas de champs obligatoires, Amazon Lex génère une exception. Lorsque vous mettez à jour la $LATEST version d'un type d'emplacement, si un bot utilise la $LATEST version d'une intention qui contient le type d'emplacement, le status champ du bot est défini surNOT_BUILT.

Cette opération exige des autorisations pour l'action lex:PutSlotType.

Syntaxe de la demande

PUT /slottypes/name/versions/$LATEST HTTP/1.1
Content-type: application/json

{
   "checksum": "string",
   "createVersion": boolean,
   "description": "string",
   "enumerationValues": [ 
      { 
         "synonyms": [ "string" ],
         "value": "string"
      }
   ],
   "parentSlotTypeSignature": "string",
   "slotTypeConfigurations": [ 
      { 
         "regexConfiguration": { 
            "pattern": "string"
         }
      }
   ],
   "valueSelectionStrategy": "string"
}

Paramètres de demande URI

La demande utilise les paramètres URI suivants.

name

Nom du type d'option. Le nom ne distingue pas les majuscules et minuscules.

Le nom ne peut pas correspondre à un nom de type d'emplacement intégré ou à un nom de type d'emplacement intégré avec « AMAZON ». supprimé. Par exemple, étant donné qu'il existe un type d'emplacement intégré appeléAMAZON.DATE, vous ne pouvez pas créer un type d'emplacement personnalisé appeléDATE.

Pour obtenir la liste des types d'emplacements intégrés, consultez la section Référence des types d'emplacements dans le kit Alexa Skills.

Contraintes de longueur : longueur minimum de 1. Longueur maximum de 100.

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.

Lorsque vous créez un nouveau type d'emplacement, laissez le checksum champ vide. Si vous spécifiez un checksum, vous obtenez une BadRequestException exception.

Lorsque vous souhaitez mettre à jour un type d'emplacement, définissez le checksum champ sur la somme de contrôle de la dernière révision de la $LATEST version. Si vous ne spécifiez pas le checksum champ, ou si la somme de contrôle ne correspond pas à la $LATEST version, vous obtenez une PreconditionFailedException exception.

Type : chaîne

Obligatoire : non

createVersion

Lorsqu'il est réglé sur true une nouvelle version numérotée du type de slot est créée. Cela revient à appeler l'CreateSlotTypeVersionopération. Si vous ne le spécifiez pascreateVersion, la valeur par défaut estfalse.

Type : booléen

Obligatoire : non

description

Une description du type d'emplacement.

Type : chaîne

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

Obligatoire : non

enumerationValues

Liste d'EnumerationValueobjets qui définit les valeurs que le type de slot peut prendre. Chaque valeur peut comporter une liste de synonyms valeurs supplémentaires qui aident à former le modèle d'apprentissage automatique aux valeurs qu'il résout pour un emplacement.

Un type de slot d'expression régulière ne nécessite pas de valeurs d'énumération. Tous les autres types d'emplacements nécessitent une liste de valeurs d'énumération.

Lorsqu'Amazon Lex résout la valeur d'un emplacement, il génère une liste de résolutions contenant jusqu'à cinq valeurs possibles pour l'emplacement. Si vous utilisez une fonction Lambda, cette liste de résolutions est transmise à la fonction. Si vous n'utilisez pas de fonction Lambda, vous pouvez choisir de renvoyer la valeur saisie par l'utilisateur ou la première valeur de la liste de résolutions en tant que valeur d'intervalle. Le valueSelectionStrategy champ indique l'option à utiliser.

Type : tableau d’objets EnumerationValue

Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 10 000 articles.

Obligatoire : non

parentSlotTypeSignature

Type d'emplacement intégré utilisé comme parent du type d'emplacement. Lorsque vous définissez un type d'emplacement parent, le nouveau type d'emplacement possède la même configuration que le parent.

Seule la clause AMAZON.AlphaNumeric est prise en charge.

Type : chaîne

Contraintes de longueur : Longueur minimum de 1. Longueur maximum de 100.

Modèle : ^((AMAZON\.)_?|[A-Za-z]_?)+

Obligatoire : non

slotTypeConfigurations

Informations de configuration qui étendent le type de slot intégré du parent. La configuration est ajoutée aux paramètres du type de slot parent.

Type : tableau d’objets SlotTypeConfiguration

Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 10 éléments.

Obligatoire : non

valueSelectionStrategy

Détermine la stratégie de résolution des emplacements qu'Amazon Lex utilise pour renvoyer les valeurs des types d'emplacements. Le champ peut être défini sur l'une des valeurs suivantes :

  • ORIGINAL_VALUE- Renvoie la valeur saisie par l'utilisateur, si la valeur utilisateur est similaire à la valeur du slot.

  • TOP_RESOLUTION- S'il existe une liste de résolutions pour le slot, renvoyez la première valeur de la liste de résolutions comme valeur du type de slot. S'il n'existe pas de liste de résolution, la valeur null (nulle) est renvoyée.

Si vous ne le spécifiez pasvalueSelectionStrategy, la valeur par défaut estORIGINAL_VALUE.

Type : chaîne

Valeurs valides : ORIGINAL_VALUE | TOP_RESOLUTION

Obligatoire : non

Syntaxe de la réponse

HTTP/1.1 200
Content-type: application/json

{
   "checksum": "string",
   "createdDate": number,
   "createVersion": boolean,
   "description": "string",
   "enumerationValues": [ 
      { 
         "synonyms": [ "string" ],
         "value": "string"
      }
   ],
   "lastUpdatedDate": number,
   "name": "string",
   "parentSlotTypeSignature": "string",
   "slotTypeConfigurations": [ 
      { 
         "regexConfiguration": { 
            "pattern": "string"
         }
      }
   ],
   "valueSelectionStrategy": "string",
   "version": "string"
}

Eléments de réponse

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

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

checksum

Somme de contrôle de la $LATEST version du type de slot.

Type : chaîne

createdDate

Date à laquelle le type de slot a été créé.

Type : Timestamp

createVersion

Truesi une nouvelle version du type de slot a été créée. Si le createVersion champ n'a pas été spécifié dans la demande, le createVersion champ est défini sur false dans la réponse.

Type : booléen

description

Une description du type d'emplacement.

Type : chaîne

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

enumerationValues

Liste d'EnumerationValueobjets qui définit les valeurs que le type de slot peut prendre.

Type : tableau d’objets EnumerationValue

Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 10 000 articles.

lastUpdatedDate

Date à laquelle le type de slot a été mis à jour. Lorsque vous créez un type de slot, la date de création et la date de dernière mise à jour sont identiques.

Type : Timestamp

name

Nom du type d'option.

Type : chaîne

Contraintes de longueur : Longueur minimum de 1. Longueur maximum de 100.

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

parentSlotTypeSignature

Type d'emplacement intégré utilisé comme parent du type d'emplacement.

Type : chaîne

Contraintes de longueur : Longueur minimum de 1. Longueur maximum de 100.

Modèle : ^((AMAZON\.)_?|[A-Za-z]_?)+

slotTypeConfigurations

Informations de configuration qui étendent le type de slot intégré du parent.

Type : tableau d’objets SlotTypeConfiguration

Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 10 éléments.

valueSelectionStrategy

Stratégie de résolution d'emplacement utilisée par Amazon Lex pour déterminer la valeur de l'emplacement. Pour de plus amples informations, veuillez consulter PutSlotType.

Type : chaîne

Valeurs valides : ORIGINAL_VALUE | TOP_RESOLUTION

version

Version du type de slot. Pour un nouveau type de slot, la version est toujours$LATEST.

Type : chaîne

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

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

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

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 :