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. # GetIntent Renvoie des informations relatives à une intention. Outre le nom de l'intention, vous devez spécifier la version de l'intention. Cette opération exige des autorisations pour exécuter l'action `lex:GetIntent`. ## Syntaxe de la demande ``` GET /intents/name/versions/version HTTP/1.1 ``` ## Paramètres de demande URI La demande utilise les paramètres URI suivants. ** [name](#API_GetIntent_RequestSyntax) ** Nom de l'intention. Le nom est sensible à la casse. Contraintes de longueur : longueur minimale de 1 caractère. Longueur maximum de 100. Modèle : `^([A-Za-z]_?)+$` Obligatoire : oui ** [version](#API_GetIntent_RequestSyntax) ** La version de l'intention. Contraintes de longueur : longueur minimum de 1. Longueur maximale de 64 caractères. Modèle : `\$LATEST|[0-9]+` Obligatoire : oui ## Corps de la demande La demande n’a pas de corps de requête. ## Syntaxe de la réponse ``` HTTP/1.1 200 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" } ``` ## 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](#API_GetIntent_ResponseSyntax) ** Somme de contrôle de l'intention. Type : Chaîne ** [conclusionStatement](#API_GetIntent_ResponseSyntax) ** Une fois que la fonction Lambda spécifiée dans l'`fulfillmentActivity`élément répond à l'intention, Amazon Lex transmet cette déclaration à l'utilisateur. Type : objet [Statement](API_Statement.md) ** [confirmationPrompt](#API_GetIntent_ResponseSyntax) ** Si cela est défini dans le bot, Amazon Lex utilise une invite pour confirmer l'intention avant de répondre à la demande de l'utilisateur. Pour de plus amples informations, veuillez consulter [PutIntent](API_PutIntent.md). Type : objet [Prompt](API_Prompt.md) ** [createdDate](#API_GetIntent_ResponseSyntax) ** Date à laquelle l'intention a été créée. Type : Timestamp ** [description](#API_GetIntent_ResponseSyntax) ** Une description de l'intention. Type : Chaîne Contraintes de longueur : longueur minimum de 0. Longueur maximum de 200. ** [dialogCodeHook](#API_GetIntent_ResponseSyntax) ** Si elle est définie dans le bot, Amazon Amazon Lex invoque cette fonction Lambda pour chaque entrée utilisateur. Pour de plus amples informations, veuillez consulter [PutIntent](API_PutIntent.md). Type : objet [CodeHook](API_CodeHook.md) ** [followUpPrompt](#API_GetIntent_ResponseSyntax) ** Si elle est définie dans le bot, Amazon Lex utilise cette invite pour solliciter une activité supplémentaire de l'utilisateur une fois que l'intention a été remplie. Pour de plus amples informations, veuillez consulter [PutIntent](API_PutIntent.md). Type : objet [FollowUpPrompt](API_FollowUpPrompt.md) ** [fulfillmentActivity](#API_GetIntent_ResponseSyntax) ** Décrit comment l'intention est atteinte. Pour de plus amples informations, veuillez consulter [PutIntent](API_PutIntent.md). Type : objet [FulfillmentActivity](API_FulfillmentActivity.md) ** [inputContexts](#API_GetIntent_ResponseSyntax) ** Tableau d'`InputContext`objets répertoriant les contextes qui doivent être actifs pour qu'Amazon Lex puisse choisir l'intention d'une conversation avec l'utilisateur. Type : tableau d’objets [InputContext](API_InputContext.md) Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 5 éléments. ** [kendraConfiguration](#API_GetIntent_ResponseSyntax) ** Informations de configuration, le cas échéant, pour se connecter à un index Amazon Kendra dans le `AMAZON.KendraSearchIntent` but recherché. Type : objet [KendraConfiguration](API_KendraConfiguration.md) ** [lastUpdatedDate](#API_GetIntent_ResponseSyntax) ** Date à laquelle l'intention a été mise à jour. Lorsque vous créez une ressource, la date de création et la date de dernière mise à jour sont identiques. Type : Timestamp ** [name](#API_GetIntent_ResponseSyntax) ** Nom de l'intention. Type : Chaîne Contraintes de longueur : Longueur minimum de 1. Longueur maximum de 100. Modèle : `^([A-Za-z]_?)+$` ** [outputContexts](#API_GetIntent_ResponseSyntax) ** Tableau d'`OutputContext`objets répertoriant les contextes que l'intention active lorsqu'elle est réalisée. Type : tableau d’objets [OutputContext](API_OutputContext.md) Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 10 éléments. ** [parentIntentSignature](#API_GetIntent_ResponseSyntax) ** Identifiant unique pour une intention intégrée. Type : Chaîne ** [rejectionStatement](#API_GetIntent_ResponseSyntax) ** Si l'utilisateur répond « non » à la question définie dans`confirmationPrompt`, Amazon Lex répond par cette déclaration pour reconnaître que l'intention a été annulée. Type : objet [Statement](API_Statement.md) ** [sampleUtterances](#API_GetIntent_ResponseSyntax) ** Un ensemble d'exemples d'énoncés configurés en fonction de l'intention. Type : tableau de chaînes Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 1 500 articles. Contraintes de longueur : longueur minimale de 1. Longueur maximum de 200. ** [slots](#API_GetIntent_ResponseSyntax) ** Un ensemble de créneaux d'intention configurés pour l'intention. Type : tableau d’objets [Slot](API_Slot.md) Membres du tableau : nombre minimum de 0 élément. Nombre maximal de 100 éléments. ** [version](#API_GetIntent_ResponseSyntax) ** La version de l'intention. Type : Chaîne Contraintes de longueur : longueur minimum de 1. Longueur maximale de 64 caractères. 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 ** 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 ## Voir aussi 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/lex-models-2017-04-19/GetIntent) + [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetIntent) + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetIntent) + [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetIntent) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetIntent) + [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetIntent) + [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetIntent) + [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetIntent) + [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetIntent) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetIntent)