Avviso di fine del supporto: il 15 settembre 2025 AWS interromperà il supporto per Amazon Lex V1. Dopo il 15 settembre 2025, non potrai più accedere alla console di Amazon Lex V1 o alle risorse di Amazon Lex V1. Se utilizzi Amazon Lex V2, consulta invece la [guida Amazon Lex V2](https://docs.aws.amazon.com/lexv2/latest/dg/what-is.html). 

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

# GetIntent
<a name="API_GetIntent"></a>

 Restituisce informazioni su un intento. Oltre al nome dell'intento, è necessario specificare la versione dell'intento. 

 Questa operazione necessita delle autorizzazioni a eseguire l'operazione `lex:GetIntent`. 

## Sintassi della richiesta
<a name="API_GetIntent_RequestSyntax"></a>

```
GET /intents/name/versions/version HTTP/1.1
```

## Parametri della richiesta URI
<a name="API_GetIntent_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [name](#API_GetIntent_RequestSyntax) **   <a name="lex-GetIntent-request-uri-name"></a>
Il nome dell'intento. Il nome distingue tra maiuscole e minuscole.   
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 100.  
Modello: `^([A-Za-z]_?)+$`   
Obbligatorio: sì

 ** [version](#API_GetIntent_RequestSyntax) **   <a name="lex-GetIntent-request-uri-version"></a>
La versione dell'intento.  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 64 caratteri.  
Modello: `\$LATEST|[0-9]+`   
Obbligatorio: sì

## Corpo della richiesta
<a name="API_GetIntent_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_GetIntent_ResponseSyntax"></a>

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

## Elementi di risposta
<a name="API_GetIntent_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [checksum](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-checksum"></a>
Checksum dell'intento.  
Tipo: String

 ** [conclusionStatement](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-conclusionStatement"></a>
Dopo che la funzione Lambda specificata nell'`fulfillmentActivity`elemento soddisfa l'intento, Amazon Lex trasmette questa dichiarazione all'utente.  
Tipo: oggetto [Statement](API_Statement.md)

 ** [confirmationPrompt](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-confirmationPrompt"></a>
Se definito nel bot, Amazon Lex utilizza il prompt per confermare l'intento prima di soddisfare la richiesta dell'utente. Per ulteriori informazioni, consulta [PutIntent](API_PutIntent.md).   
Tipo: oggetto [Prompt](API_Prompt.md)

 ** [createdDate](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-createdDate"></a>
La data di creazione dell'intento.  
Tipo: Timestamp

 ** [description](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-description"></a>
Una descrizione dell'intento.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima di 0. Lunghezza massima di 200.

 ** [dialogCodeHook](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-dialogCodeHook"></a>
Se definita nel bot, Amazon Amazon Lex richiama questa funzione Lambda per ogni input dell'utente. Per ulteriori informazioni, consulta [PutIntent](API_PutIntent.md).   
Tipo: oggetto [CodeHook](API_CodeHook.md)

 ** [followUpPrompt](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-followUpPrompt"></a>
Se definito nel bot, Amazon Lex utilizza questo prompt per sollecitare ulteriori attività dell'utente dopo il raggiungimento dell'intento. Per ulteriori informazioni, consulta [PutIntent](API_PutIntent.md).  
Tipo: oggetto [FollowUpPrompt](API_FollowUpPrompt.md)

 ** [fulfillmentActivity](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-fulfillmentActivity"></a>
Descrive come viene soddisfatto l'intento. Per ulteriori informazioni, consulta [PutIntent](API_PutIntent.md).   
Tipo: oggetto [FulfillmentActivity](API_FulfillmentActivity.md)

 ** [inputContexts](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-inputContexts"></a>
Una serie di `InputContext` oggetti che elenca i contesti che devono essere attivi affinché Amazon Lex possa scegliere l'intento in una conversazione con l'utente.  
Tipo: matrice di oggetti [InputContext](API_InputContext.md)  
Membri dell'array: numero minimo di 0 elementi. Numero massimo 5 elementi.

 ** [kendraConfiguration](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-kendraConfiguration"></a>
Informazioni di configurazione, se presenti, per connettersi a un indice Amazon Kendra con l'intento. `AMAZON.KendraSearchIntent`  
Tipo: oggetto [KendraConfiguration](API_KendraConfiguration.md)

 ** [lastUpdatedDate](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-lastUpdatedDate"></a>
La data in cui l'intento è stato aggiornato. Quando crei una risorsa, la data di creazione e la data dell'ultimo aggiornamento coincidono.   
Tipo: Timestamp

 ** [name](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-name"></a>
Il nome dell'intento.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 100.  
Modello: `^([A-Za-z]_?)+$` 

 ** [outputContexts](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-outputContexts"></a>
Una matrice di `OutputContext` oggetti che elenca i contesti che l'intento attiva quando l'intento viene soddisfatto.  
Tipo: matrice di oggetti [OutputContext](API_OutputContext.md)  
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 10 elementi.

 ** [parentIntentSignature](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-parentIntentSignature"></a>
Un identificatore univoco per un intento incorporato.  
Tipo: String

 ** [rejectionStatement](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-rejectionStatement"></a>
Se l'utente risponde «no» alla domanda definita in`confirmationPrompt`, Amazon Lex risponde con questa dichiarazione per confermare che l'intento è stato annullato.   
Tipo: oggetto [Statement](API_Statement.md)

 ** [sampleUtterances](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-sampleUtterances"></a>
Una serie di espressioni di esempio configurate per l'intento.  
Tipo: array di stringhe  
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 1500 articoli.  
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 200.

 ** [slots](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-slots"></a>
Una serie di slot di intento configurati per l'intento.  
Tipo: matrice di oggetti [Slot](API_Slot.md)  
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 100 elementi.

 ** [version](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-version"></a>
La versione dell'intento.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 64 caratteri.  
Modello: `\$LATEST|[0-9]+` 

## Errori
<a name="API_GetIntent_Errors"></a>

 ** 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

 ** 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

## Vedi anche
<a name="API_GetIntent_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/GetIntent) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetIntent) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetIntent) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetIntent) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetIntent) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetIntent) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetIntent) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetIntent) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetIntent) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetIntent)