

Avis de fin de support : le 15 septembre 2025, le support pour Amazon Lex V1 AWS sera interrompu. Après le 15 septembre 2025, vous ne pourrez plus accéder à la console Amazon Lex V1 ni aux ressources Amazon Lex V1. Si vous utilisez Amazon Lex V2, consultez plutôt le [guide Amazon Lex V2](https://docs.aws.amazon.com/lexv2/latest/dg/what-is.html). 

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.

# PostContent
<a name="API_runtime_PostContent"></a>

 Envoie l'entrée utilisateur (texte ou voix) à Amazon Lex. Les clients utilisent cette API pour envoyer des requêtes texte et audio à Amazon Lex lors de l'exécution. Amazon Lex interprète les données saisies par l'utilisateur à l'aide du modèle d'apprentissage automatique qu'il a conçu pour le bot. 

Le `PostContent` fonctionnement prend en charge l'entrée audio à 8 kHz et 16 kHz. Vous pouvez utiliser le son 8 kHz pour obtenir une meilleure précision de reconnaissance vocale dans les applications audio téléphoniques. 

 En réponse, Amazon Lex renvoie le message suivant à transmettre à l'utilisateur. Examinez les exemples de messages suivants : 
+  Lorsqu'un utilisateur saisit « Je voudrais une pizza », Amazon Lex peut renvoyer une réponse avec un message demandant les données du créneau (par exemple,`PizzaSize`) : « Quelle taille de pizza souhaitez-vous ? ». 
+  Une fois que l'utilisateur a fourni toutes les informations relatives à la commande de pizza, Amazon Lex peut renvoyer une réponse contenant un message pour obtenir la confirmation de l'utilisateur : « Vous commandez la pizza ? ». 
+  Une fois que l'utilisateur a répondu « Oui » à l'invite de confirmation, Amazon Lex peut renvoyer une déclaration de conclusion : « Merci, votre pizza au fromage a été commandée. ». 

 Tous les messages Amazon Lex ne nécessitent pas de réponse de la part de l'utilisateur. Par exemple, les énoncés de conclusion ne nécessitent pas de réponse. Certains messages ne nécessitent qu'une réponse par oui ou par non. En outre`message`, Amazon Lex fournit un contexte supplémentaire sur le message dans la réponse, que vous pouvez utiliser pour améliorer le comportement des clients, par exemple en affichant l'interface utilisateur client appropriée. Considérez les exemples suivants : 
+  Si le message vise à obtenir des données d'emplacement, Amazon Lex renvoie les informations contextuelles suivantes : 
  +  `x-amz-lex-dialog-state`en-tête défini sur `ElicitSlot` 
  +  `x-amz-lex-intent-name`en-tête défini sur le nom de l'intention dans le contexte actuel 
  +  `x-amz-lex-slot-to-elicit`en-tête défini sur le nom du slot pour lequel le `message` cherche à obtenir des informations 
  +  `x-amz-lex-slots`en-tête défini sur une carte des emplacements configurés pour l'intention avec leurs valeurs actuelles 
+  Si le message est une invite de confirmation, l'`x-amz-lex-dialog-state`en-tête est défini sur `Confirmation` et l'`x-amz-lex-slot-to-elicit`en-tête est omis. 
+  Si le message est une invite de clarification configurée pour l'intention, indiquant que l'intention de l'utilisateur n'est pas comprise, l'`x-amz-dialog-state`en-tête est défini sur `ElicitIntent` et l'`x-amz-slot-to-elicit`en-tête est omis. 

 En outre, Amazon Lex renvoie également des informations spécifiques à votre application`sessionAttributes`. Pour plus d'informations, consultez [la section Gestion du contexte de conversation](https://docs.aws.amazon.com/lex/latest/dg/context-mgmt.html). 

## Syntaxe de la demande
<a name="API_runtime_PostContent_RequestSyntax"></a>

```
POST /bot/botName/alias/botAlias/user/userId/content HTTP/1.1
x-amz-lex-session-attributes: sessionAttributes
x-amz-lex-request-attributes: requestAttributes
Content-Type: contentType
Accept: accept
x-amz-lex-active-contexts: activeContexts

inputStream
```

## Paramètres de demande URI
<a name="API_runtime_PostContent_RequestParameters"></a>

La demande utilise les paramètres URI suivants.

 ** [accept](#API_runtime_PostContent_RequestSyntax) **   <a name="lex-runtime_PostContent-request-accept"></a>
 Vous transmettez cette valeur comme en-tête `Accept` HTTP.   
 Le message renvoyé par Amazon Lex dans la réponse peut être texte ou vocal en fonction de la valeur d'en-tête `Accept` HTTP de la demande.   
+  Si la valeur est égale à cette valeur`text/plain; charset=utf-8`, Amazon Lex renvoie du texte dans la réponse. 
+  Si la valeur commence par`audio/`, Amazon Lex renvoie un message vocal dans la réponse. Amazon Lex utilise Amazon Polly pour générer le discours (en utilisant la configuration que vous avez spécifiée dans l'`Accept`en-tête). Par exemple, si vous spécifiez `audio/mpeg` comme valeur, Amazon Lex renvoie la parole au format MPEG.
+ Si la valeur est`audio/pcm`, le discours renvoyé est `audio/pcm` au format Little Endian 16 bits. 
+ Les valeurs acceptées sont les suivantes :
  + audio/mpeg
  + audio/ogg
  + audio/PCM
  + texte/clair ; jeu de caractères = utf-8
  + audio/\$1 (mpeg par défaut)

 ** [activeContexts](#API_runtime_PostContent_RequestSyntax) **   <a name="lex-runtime_PostContent-request-activeContexts"></a>
Liste des contextes actifs pour la demande. Un contexte peut être activé lorsqu'une intention précédente est satisfaite, ou en incluant le contexte dans la demande,  
Si vous ne spécifiez pas de liste de contextes, Amazon Lex utilisera la liste actuelle des contextes pour la session. Si vous spécifiez une liste vide, tous les contextes de la session sont effacés.

 ** [botAlias](#API_runtime_PostContent_RequestSyntax) **   <a name="lex-runtime_PostContent-request-uri-botAlias"></a>
Alias du bot Amazon Lex.  
Obligatoire : oui

 ** [botName](#API_runtime_PostContent_RequestSyntax) **   <a name="lex-runtime_PostContent-request-uri-botName"></a>
Nom du bot Amazon Lex.  
Obligatoire : oui

 ** [contentType](#API_runtime_PostContent_RequestSyntax) **   <a name="lex-runtime_PostContent-request-contentType"></a>
 Vous transmettez cette valeur comme en-tête `Content-Type` HTTP.   
 Indique le format audio ou le texte. La valeur de l'en-tête doit commencer par l'un des préfixes suivants :   
+ Format PCM, les données audio doivent être dans l'ordre des octets de l'ordre des petits et dians.
  + audio/l16 ; débit = 16 000 ; canaux = 1
  + audio/x-l16 ; fréquence d'échantillonnage = 16 000 ; nombre de canaux = 1
  + audio/lpcm ; fréquence d'échantillonnage = 8 000 ; = 16 ; nombre de canaux = 1 ; = faux sample-size-bits is-big-endian 
+ Format Opus
  + audio/ x-cbr-opus-with -preamble ; taille du préambule = 0 ; débit = 256000 ; =4 frame-size-milliseconds
+ Format texte
  + texte/clair ; jeu de caractères = utf-8
Obligatoire : oui

 ** [requestAttributes](#API_runtime_PostContent_RequestSyntax) **   <a name="lex-runtime_PostContent-request-requestAttributes"></a>
Vous transmettez cette valeur comme en-tête `x-amz-lex-request-attributes` HTTP.  
Informations spécifiques à la demande transmises entre Amazon Lex et une application cliente. La valeur doit être une carte sérialisée JSON et codée en base64 avec des clés et des valeurs de chaîne. La taille totale des `sessionAttributes` en-têtes `requestAttributes` et est limitée à 12 Ko.  
L'espace de noms `x-amz-lex:` est réservé aux attributs spéciaux. Ne créez aucun attribut de demande avec le préfixe`x-amz-lex:`.  
Pour plus d'informations, consultez la section [Définition des attributs de demande](https://docs.aws.amazon.com/lex/latest/dg/context-mgmt.html#context-mgmt-request-attribs).

 ** [sessionAttributes](#API_runtime_PostContent_RequestSyntax) **   <a name="lex-runtime_PostContent-request-sessionAttributes"></a>
Vous transmettez cette valeur comme en-tête `x-amz-lex-session-attributes` HTTP.  
Informations spécifiques à l'application transmises entre Amazon Lex et une application cliente. La valeur doit être une carte sérialisée JSON et codée en base64 avec des clés et des valeurs de chaîne. La taille totale des `requestAttributes` en-têtes `sessionAttributes` et est limitée à 12 Ko.  
Pour plus d'informations, consultez la section [Définition des attributs de session](https://docs.aws.amazon.com/lex/latest/dg/context-mgmt.html#context-mgmt-session-attribs).

 ** [userId](#API_runtime_PostContent_RequestSyntax) **   <a name="lex-runtime_PostContent-request-uri-userId"></a>
ID de l'utilisateur de l'application cliente. Amazon Lex l'utilise pour identifier la conversation d'un utilisateur avec votre bot. Au moment de l'exécution, chaque demande doit contenir le `userID` champ.  
Pour décider de l'ID utilisateur à utiliser pour votre application, tenez compte des facteurs suivants.  
+ Le `userID` champ ne doit contenir aucune information personnellement identifiable de l'utilisateur, par exemple son nom, son numéro d'identification personnel ou toute autre information personnelle de l'utilisateur final.
+ Si vous souhaitez qu'un utilisateur entame une conversation sur un appareil et la poursuive sur un autre, utilisez un identifiant spécifique à l'utilisateur.
+ Si vous souhaitez que le même utilisateur puisse avoir deux conversations indépendantes sur deux appareils différents, choisissez un identifiant spécifique à l'appareil.
+ Un utilisateur ne peut pas avoir deux conversations indépendantes avec deux versions différentes du même bot. Par exemple, un utilisateur ne peut pas avoir de conversation avec les versions PROD et BETA du même bot. Si vous pensez qu'un utilisateur devra avoir une conversation avec deux versions différentes, par exemple pendant le test, incluez l'alias du bot dans l'ID utilisateur pour séparer les deux conversations.
Contraintes de longueur : longueur minimale de 2. Longueur maximum de 100.  
Modèle : `[0-9a-zA-Z._:-]+`   
Obligatoire : oui

## Corps de la demande
<a name="API_runtime_PostContent_RequestBody"></a>

La demande accepte les données binaires suivantes.

 ** [inputStream](#API_runtime_PostContent_RequestSyntax) **   <a name="lex-runtime_PostContent-request-inputStream"></a>
 Entrée utilisateur au format audio PCM ou Opus ou au format texte, comme décrit dans l'en-tête `Content-Type` HTTP.   
Vous pouvez diffuser des données audio vers Amazon Lex ou créer une mémoire tampon locale qui capture toutes les données audio avant de les envoyer. En général, vous obtiendrez de meilleures performances si vous diffusez des données audio plutôt que de les mettre en mémoire tampon localement.  
Obligatoire : oui

## Syntaxe de la réponse
<a name="API_runtime_PostContent_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-Type: contentType
x-amz-lex-intent-name: intentName
x-amz-lex-nlu-intent-confidence: nluIntentConfidence
x-amz-lex-alternative-intents: alternativeIntents
x-amz-lex-slots: slots
x-amz-lex-session-attributes: sessionAttributes
x-amz-lex-sentiment: sentimentResponse
x-amz-lex-message: message
x-amz-lex-encoded-message: encodedMessage
x-amz-lex-message-format: messageFormat
x-amz-lex-dialog-state: dialogState
x-amz-lex-slot-to-elicit: slotToElicit
x-amz-lex-input-transcript: inputTranscript
x-amz-lex-encoded-input-transcript: encodedInputTranscript
x-amz-lex-bot-version: botVersion
x-amz-lex-session-id: sessionId
x-amz-lex-active-contexts: activeContexts

audioStream
```

## Eléments de réponse
<a name="API_runtime_PostContent_ResponseElements"></a>

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

La réponse renvoie les en-têtes HTTP suivants.

 ** [activeContexts](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-activeContexts"></a>
Liste des contextes actifs pour la session. Un contexte peut être défini lorsqu'une intention est satisfaite ou en appelant l'`PutSession`opération `PostContent``PostText`, ou.  
Vous pouvez utiliser un contexte pour contrôler les intentions qui peuvent donner suite à une intention ou pour modifier le fonctionnement de votre application.

 ** [alternativeIntents](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-alternativeIntents"></a>
Une à quatre intentions alternatives qui peuvent être applicables à l'intention de l'utilisateur.  
Chaque alternative inclut un score qui indique dans quelle mesure Amazon Lex est sûr que l'intention correspond à celle de l'utilisateur. Les intentions sont triées en fonction du score de confiance.

 ** [botVersion](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-botVersion"></a>
Version du bot qui a répondu à la conversation. Vous pouvez utiliser ces informations pour déterminer si une version d'un bot est plus performante qu'une autre.  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 64 caractères.  
Modèle : `[0-9]+|\$LATEST` 

 ** [contentType](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-contentType"></a>
Type de contenu tel que spécifié dans l'en-tête `Accept` HTTP de la demande.

 ** [dialogState](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-dialogState"></a>
Identifie l'état actuel de l'interaction de l'utilisateur. Amazon Lex renvoie l'une des valeurs suivantes sous la forme`dialogState`. Le client peut éventuellement utiliser ces informations pour personnaliser l'interface utilisateur.   
+  `ElicitIntent`- Amazon Lex souhaite connaître l'intention de l'utilisateur. Considérez les exemples suivants : 

   Par exemple, un utilisateur peut exprimer une intention (« Je veux commander une pizza »). Si Amazon Lex ne parvient pas à déduire l'intention de l'utilisateur à partir de cet énoncé, il renverra cet état de dialogue. 
+  `ConfirmIntent`- Amazon Lex attend une réponse « oui » ou « non ». 

  Par exemple, Amazon Lex souhaite obtenir la confirmation de l'utilisateur avant de réaliser une intention. Au lieu d'une simple réponse « oui » ou « non », un utilisateur peut répondre en fournissant des informations supplémentaires. Par exemple, « oui, mais fais-en une pizza à croûte épaisse » ou « Non, je veux commander un verre ». Amazon Lex peut traiter ces informations supplémentaires (dans ces exemples, mettre à jour l'emplacement du type de croûte ou modifier l'intention de OrderPizza à OrderDrink). 
+  `ElicitSlot`- Amazon Lex attend la valeur d'un emplacement pour l'objectif actuel. 

   Supposons, par exemple, qu'Amazon Lex envoie le message suivant dans sa réponse : « Quelle taille de pizza aimeriez-vous ? ». Un utilisateur peut répondre en indiquant la valeur de l'emplacement (par exemple, « moyen »). L'utilisateur peut également fournir des informations supplémentaires dans la réponse (par exemple, « pizza à croûte moyenne épaisse »). Amazon Lex peut traiter ces informations supplémentaires de manière appropriée. 
+  `Fulfilled`- Indique que la fonction Lambda a répondu avec succès à l'intention. 
+  `ReadyForFulfillment`- Indique que le client doit répondre à la demande. 
+  `Failed`- Indique que la conversation avec l'utilisateur a échoué. 

   Cela peut se produire pour diverses raisons, notamment parce que l'utilisateur ne fournit pas de réponse appropriée aux demandes du service (vous pouvez configurer le nombre de fois où Amazon Lex peut demander à un utilisateur des informations spécifiques) ou si la fonction Lambda ne répond pas à son objectif. 
Valeurs valides : `ElicitIntent | ConfirmIntent | ElicitSlot | Fulfilled | ReadyForFulfillment | Failed` 

 ** [encodedInputTranscript](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-encodedInputTranscript"></a>
Le texte utilisé pour traiter la demande.  
Si l'entrée correspond à un flux audio, le champ `encodedInputTranscript` contient le texte extraite du flux audio. Il s'agit du texte qui est réellement traité pour reconnaître les intentions et les valeurs d'option. Vous pouvez utiliser ces informations pour déterminer si Amazon Lex traite correctement le son que vous envoyez.  
Le `encodedInputTranscript` champ est codé en base 64. Vous devez décoder le champ avant de pouvoir utiliser la valeur.

 ** [encodedMessage](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-encodedMessage"></a>
Le message à transmettre à l'utilisateur. Le message peut provenir de la configuration du bot ou d'une fonction Lambda.  
Si l'intention n'est pas configurée avec une fonction Lambda, ou si la fonction Lambda renvoie la valeur « `Delegate` the » `dialogAction.type` dans sa réponse, Amazon Lex décide de la marche à suivre et sélectionne un message approprié dans la configuration du bot en fonction du contexte d'interaction actuel. Par exemple, si Amazon Lex n'est pas en mesure de comprendre les informations saisies par les utilisateurs, il envoie un message de demande de clarification.  
Lorsque vous créez une intention, vous pouvez attribuer des messages à des groupes. Lorsque des messages sont affectés à des groupes, Amazon Lex renvoie un message de chaque groupe dans la réponse. Le champ de message est une chaîne JSON échappée contenant les messages. Pour plus d'informations sur la structure de la chaîne JSON renvoyée, consultez[Formats de message pris en charge](howitworks-manage-prompts.md#msg-prompts-formats).  
Si la fonction Lambda renvoie un message, Amazon Lex le transmet au client dans sa réponse.  
Le `encodedMessage` champ est codé en base 64. Vous devez décoder le champ avant de pouvoir utiliser la valeur.  
Contraintes de longueur : longueur minimale de 1 caractère. Longueur maximale de 1366.

 ** [inputTranscript](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-inputTranscript"></a>
 *Cet en-tête est devenu obsolète.*   
Le texte utilisé pour traiter la demande.  
Vous ne pouvez utiliser ce champ que dans les paramètres régionaux de-DE, en-AU, en-GB, en-US, es-419, es-ES, es-US, fr-CA, fr-FR et it-IT. Dans tous les autres paramètres régionaux, le `inputTranscript` champ est nul. Vous devriez plutôt utiliser le `encodedInputTranscript` champ.  
Si l'entrée correspond à un flux audio, le champ `inputTranscript` contient le texte extraite du flux audio. Il s'agit du texte qui est réellement traité pour reconnaître les intentions et les valeurs d'option. Vous pouvez utiliser ces informations pour déterminer si Amazon Lex traite correctement le son que vous envoyez.

 ** [intentName](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-intentName"></a>
Intention actuelle de l'utilisateur dont Amazon Lex est au courant.

 ** [message](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-message"></a>
 *Cet en-tête est devenu obsolète.*   
Vous ne pouvez utiliser ce champ que dans les paramètres régionaux de-DE, en-AU, en-GB, en-US, es-419, es-ES, es-US, fr-CA, fr-FR et it-IT. Dans tous les autres paramètres régionaux, le `message` champ est nul. Vous devriez plutôt utiliser le `encodedMessage` champ.  
Le message à transmettre à l'utilisateur. Le message peut provenir de la configuration du bot ou d'une fonction Lambda.  
Si l'intention n'est pas configurée avec une fonction Lambda, ou si la fonction Lambda renvoie la valeur « `Delegate` the » `dialogAction.type` dans sa réponse, Amazon Lex décide de la marche à suivre et sélectionne un message approprié dans la configuration du bot en fonction du contexte d'interaction actuel. Par exemple, si Amazon Lex n'est pas en mesure de comprendre les informations saisies par les utilisateurs, il envoie un message de demande de clarification.  
Lorsque vous créez une intention, vous pouvez attribuer des messages à des groupes. Lorsque des messages sont affectés à des groupes, Amazon Lex renvoie un message de chaque groupe dans la réponse. Le champ de message est une chaîne JSON échappée contenant les messages. Pour plus d'informations sur la structure de la chaîne JSON renvoyée, consultez[Formats de message pris en charge](howitworks-manage-prompts.md#msg-prompts-formats).  
Si la fonction Lambda renvoie un message, Amazon Lex le transmet au client dans sa réponse.  
Contraintes de longueur : longueur minimale de 1 caractère. Longueur maximale de 1024.

 ** [messageFormat](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-messageFormat"></a>
Format du message de réponse. L’une des valeurs suivantes :  
+  `PlainText`- Le message contient du texte UTF-8 brut.
+  `CustomPayload`- Le message est un format personnalisé pour le client.
+  `SSML`- Le message contient du texte formaté pour la sortie vocale.
+  `Composite`- Le message contient un objet JSON échappé contenant un ou plusieurs messages provenant des groupes auxquels les messages ont été affectés lors de la création de l'intention.
Valeurs valides : `PlainText | CustomPayload | SSML | Composite` 

 ** [nluIntentConfidence](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-nluIntentConfidence"></a>
Fournit un score qui indique dans quelle mesure Amazon Lex est sûr que l'intention renvoyée correspond à l'intention de l'utilisateur. Le score est compris entre 0,0 et 1,0.  
Le score est un score relatif et non un score absolu. Le score peut changer en fonction des améliorations apportées à Amazon Lex. 

 ** [sentimentResponse](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-sentimentResponse"></a>
Le sentiment exprimé dans un énoncé.  
Lorsque le bot est configuré pour envoyer des énoncés à Amazon Comprehend à des fins d'analyse des sentiments, ce champ contient le résultat de l'analyse.

 ** [sessionAttributes](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-sessionAttributes"></a>
 Carte des key/value paires représentant les informations contextuelles spécifiques à la session. 

 ** [sessionId](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-sessionId"></a>
Identifiant unique de la session.

 ** [slots](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-slots"></a>
Carte de zéro ou plusieurs créneaux d'intention (paires nom/valeur) détectés par Amazon Lex à partir des données saisies par l'utilisateur au cours de la conversation. Le champ est codé en base 64.  
Amazon Lex crée une liste de résolutions contenant les valeurs probables pour un emplacement. La valeur renvoyée est déterminée par la valeur `valueSelectionStrategy` sélectionnée lors de la création ou de la mise à jour du type d'emplacement. S'il `valueSelectionStrategy` est défini sur`ORIGINAL_VALUE`, la valeur fournie par l'utilisateur est renvoyée, si la valeur utilisateur est similaire aux valeurs des emplacements. Si la valeur `valueSelectionStrategy` est définie `TOP_RESOLUTION` sur Amazon Lex, elle renvoie la première valeur de la liste de résolutions ou, en l'absence de liste de résolutions, la valeur nulle. Si vous ne spécifiez pas de`valueSelectionStrategy`, la valeur par défaut est`ORIGINAL_VALUE`.

 ** [slotToElicit](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-slotToElicit"></a>
 Si la `dialogState` valeur est`ElicitSlot`, renvoie le nom de l'emplacement pour lequel Amazon Lex demande une valeur. 

La réponse renvoie ce qui suit en tant que corps HTTP.

 ** [audioStream](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-audioStream"></a>
L'invite (ou déclaration) à transmettre à l'utilisateur. Ceci est basé sur la configuration et le contexte du bot. Par exemple, si Amazon Lex n'a pas compris l'intention de l'utilisateur, il envoie le `clarificationPrompt` fichier configuré pour le bot. Si l'intention nécessite une confirmation avant d'effectuer l'action d'exécution, elle envoie le`confirmationPrompt`. Autre exemple : supposons que la fonction Lambda ait répondu avec succès à l'intention et ait envoyé un message à transmettre à l'utilisateur. Amazon Lex envoie ensuite ce message dans la réponse. 

## Erreurs
<a name="API_runtime_PostContent_Errors"></a>

 ** BadGatewayException **   
Soit le bot Amazon Lex est toujours en cours de création, soit l'un des services dépendants (Amazon Polly, AWS Lambda) a échoué en raison d'une erreur de service interne.  
Code d’état HTTP : 502

 ** BadRequestException **   
 La validation de la demande a échoué, il n'y a aucun message utilisable dans le contexte, ou la création du bot a échoué, est toujours en cours ou contient des modifications non intégrées.   
Code d’état HTTP : 400

 ** ConflictException **   
 Deux clients utilisent le même compte AWS, le même bot Amazon Lex et le même ID utilisateur.   
Code d’état HTTP : 409

 ** DependencyFailedException **   
 L'une des dépendances, telle qu'AWS Lambda ou Amazon Polly, a généré une exception. Par exemple,   
+ Si Amazon Lex ne dispose pas des autorisations suffisantes pour appeler une fonction Lambda.
+ Si l'exécution d'une fonction Lambda prend plus de 30 secondes.
+ Si une fonction Lambda d'exécution renvoie une action de `Delegate` dialogue sans supprimer aucune valeur d'intervalle.
Code d'état HTTP : 424

 ** InternalFailureException **   
Erreur de service interne. Réessayez l'appel.  
Code d’état HTTP : 500

 ** LimitExceededException **   
Dépassement d'une limite.  
Code d’état HTTP : 429

 ** LoopDetectedException **   
Cette exception n'est pas utilisée.  
Code d'état HTTP : 508

 ** NotAcceptableException **   
L'en-tête d'acceptation de la demande n'a pas de valeur valide.  
Code d'état HTTP : 406

 ** NotFoundException **   
La ressource (telle que le bot Amazon Lex ou un alias) à laquelle il est fait référence est introuvable.  
Code d’état HTTP :404

 ** RequestTimeoutException **   
Le discours d'entrée est trop long.  
Code d’état HTTP : 408

 ** UnsupportedMediaTypeException **   
La valeur de l'en-tête Content-Type (`PostContent`API) n'est pas valide.   
Code d’état HTTP : 415

## Exemples
<a name="API_runtime_PostContent_Examples"></a>

### Exemple 1
<a name="API_runtime_PostContent_Example_1"></a>

 Dans cette demande, l'URI identifie un bot (Traffic), une version du bot (\$1LATEST) et un nom d'utilisateur final (someuser). L'`Content-Type`en-tête identifie le format de l'audio dans le corps. Amazon Lex prend également en charge d'autres formats. Pour convertir l'audio d'un format à un autre, vous pouvez utiliser le logiciel open source SoX si nécessaire. Vous spécifiez le format dans lequel vous souhaitez obtenir la réponse en ajoutant l'en-tête `Accept` HTTP. 

 Dans la réponse, l'`x-amz-lex-message`en-tête indique la réponse renvoyée par Amazon Lex. Le client peut ensuite envoyer cette réponse à l'utilisateur. Le même message est envoyé sous audio/MPEG forme de codage fragmenté (comme demandé). 

#### Exemple de demande
<a name="API_runtime_PostContent_Example_1_Request"></a>

```
"POST /bot/Traffic/alias/$LATEST/user/someuser/content HTTP/1.1[\r][\n]"
"x-amz-lex-session-attributes: eyJ1c2VyTmFtZSI6IkJvYiJ9[\r][\n]"
"Content-Type: audio/x-l16; channel-count=1; sample-rate=16000f[\r][\n]"
"Accept: audio/mpeg[\r][\n]"
"Host: runtime.lex.us-east-1.amazonaws.com[\r][\n]"
"Authorization: AWS4-HMAC-SHA256 Credential=BLANKED_OUT/20161230/us-east-1/lex/aws4_request, 
SignedHeaders=accept;content-type;host;x-amz-content-sha256;x-amz-date;x-amz-lex-session-attributes, Signature=78ca5b54ea3f64a17ff7522de02cd90a9acd2365b45a9ce9b96ea105bb1c7ec2[\r][\n]"
"X-Amz-Date: 20161230T181426Z[\r][\n]"
"X-Amz-Content-Sha256: e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855[\r][\n]"
"Transfer-Encoding: chunked[\r][\n]"
"Connection: Keep-Alive[\r][\n]"
"User-Agent: Apache-HttpClient/4.5.x (Java/1.8.0_112)[\r][\n]"
"Accept-Encoding: gzip,deflate[\r][\n]"
"[\r][\n]"
"1000[\r][\n]"
"[0x7][0x0][0x7][0x0][\n]"
"[0x0][0x7][0x0][0xfc][0xff][\n]"
"[0x0][\n]"
…
```

#### Exemple de réponse
<a name="API_runtime_PostContent_Example_1_Response"></a>

```
"HTTP/1.1 200 OK[\r][\n]"
"x-amzn-RequestId: cc8b34af-cebb-11e6-a35c-55f3a992f28d[\r][\n]"
"x-amz-lex-message: Sorry, can you repeat that?[\r][\n]"
"x-amz-lex-dialog-state: ElicitIntent[\r][\n]"
"x-amz-lex-session-attributes: eyJ1c2VyTmFtZSI6IkJvYiJ9[\r][\n]"
"Content-Type: audio/mpeg[\r][\n]"
"Transfer-Encoding: chunked[\r][\n]"
"Date: Fri, 30 Dec 2016 18:14:28 GMT[\r][\n]"
"[\r][\n]"               
"2000[\r][\n]"
"ID3[0x4][0x0][0x0][0x0][0x0][0x0]#TSSE[0x0][0x0][0x0][0xf][0x0][0x0][0x3]Lavf57.41.100[0x0][0x0][0x0][0x0][0x0][0x0][0x0][0x0][0x0][0x0][0x0][0xff][0xf3]`[0xc4][0x0][0x1b]{[0x8d][0xe8][0x1]C[0x18][0x1][0x0]J[0xe0]`b[0xdd][0xd1][0xb][0xfd][0x11][0xdf][0xfe]";[0xbb][0xbb][0x9f][0xee][0xee][0xee][0xee]|DDD/[0xff][0xff][0xff][0xff]www?D[0xf7]w^?[0xff][0xfa]h[0x88][0x85][0xfe][0x88][0x88][0x88][[0xa2]'[0xff][0xfa]"{[0x9f][0xe8][0x88]]D[0xeb][0xbb][0xbb][0xa2]!u[0xfd][0xdd][0xdf][0x88][0x94][0x0]F[0xef][0xa1]8[0x0][0x82]w[0x88]N[0x0][0x0][0x9b][0xbb][0xe8][0xe
…
```

## consultez aussi
<a name="API_runtime_PostContent_SeeAlso"></a>

Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
+  [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/runtime.lex-2016-11-28/PostContent) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/runtime.lex-2016-11-28/PostContent) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/runtime.lex-2016-11-28/PostContent) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/runtime.lex-2016-11-28/PostContent) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/runtime.lex-2016-11-28/PostContent) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/runtime.lex-2016-11-28/PostContent) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/runtime.lex-2016-11-28/PostContent) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/runtime.lex-2016-11-28/PostContent) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/runtime.lex-2016-11-28/PostContent) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/runtime.lex-2016-11-28/PostContent) 