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

# GetBot
<a name="API_GetBot"></a>

Restituisce informazioni sui metadati per un bot specifico. È necessario fornire il nome del bot e la versione o l'alias del bot. 

 Questa operazione richiede le autorizzazioni per l'operazione `lex:GetBot`. 

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

```
GET /bots/name/versions/versionoralias HTTP/1.1
```

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

La richiesta utilizza i seguenti parametri URI.

 ** [name](#API_GetBot_RequestSyntax) **   <a name="lex-GetBot-request-uri-name"></a>
Il nome del bot. Il nome distingue tra maiuscole e minuscole.   
Vincoli di lunghezza: lunghezza minima di 2. La lunghezza massima è 50 caratteri.  
Modello: `^([A-Za-z]_?)+$`   
Obbligatorio: sì

 ** [versionoralias](#API_GetBot_RequestSyntax) **   <a name="lex-GetBot-request-uri-versionOrAlias"></a>
La versione o l'alias del bot.  
Obbligatorio: sì

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

La richiesta non ha un corpo della richiesta.

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

```
HTTP/1.1 200
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",
   "nluIntentConfidenceThreshold": number,
   "status": "string",
   "version": "string",
   "voiceId": "string"
}
```

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

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

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

 ** [abortStatement](#API_GetBot_ResponseSyntax) **   <a name="lex-GetBot-response-abortStatement"></a>
Il messaggio che Amazon Lex restituisce quando l'utente decide di terminare la conversazione senza completarla. Per ulteriori informazioni, consulta [PutBot](API_PutBot.md).  
Tipo: oggetto [Statement](API_Statement.md)

 ** [checksum](#API_GetBot_ResponseSyntax) **   <a name="lex-GetBot-response-checksum"></a>
Checksum del bot utilizzato per identificare una revisione specifica della versione del bot. `$LATEST`  
Tipo: String

 ** [childDirected](#API_GetBot_ResponseSyntax) **   <a name="lex-GetBot-response-childDirected"></a>
Per ogni bot Amazon Lex creato con Amazon Lex Model Building Service, devi specificare se l'uso di Amazon Lex è correlato a un sito Web, programma o altra applicazione indirizzato o destinato, in tutto o in parte, a bambini di età inferiore ai 13 anni e soggetto al Children's Online Privacy Protection Act (COPPA) specificando `true` o `false` nel `childDirected` campo. Specificando `true` nel `childDirected` campo, confermi che l'uso di Amazon Lex **è** correlato a un sito Web, programma o altra applicazione indirizzato o destinato, in tutto o in parte, a bambini di età inferiore ai 13 anni e soggetto al COPPA. Specificando `false` nel `childDirected` campo, confermi che l'uso di Amazon Lex **non è** correlato a un sito Web, programma o altra applicazione indirizzato o destinato, in tutto o in parte, a bambini di età inferiore ai 13 anni e soggetti al COPPA. Non puoi specificare un valore predefinito per il `childDirected` campo che non riflette accuratamente se l'uso di Amazon Lex è correlato a un sito Web, programma o altra applicazione indirizzata o destinata, in tutto o in parte, a bambini di età inferiore ai 13 anni e soggetta al COPPA.  
Se l'uso di Amazon Lex si riferisce a un sito Web, programma o altra applicazione rivolta, in tutto o in parte, a bambini di età inferiore ai 13 anni, devi ottenere il consenso genitoriale verificabile richiesto ai sensi del COPPA. Per informazioni sull'uso di Amazon Lex in relazione a siti Web, programmi o altre applicazioni rivolti o destinati, in tutto o in parte, a bambini di età inferiore ai 13 anni, consulta le [domande frequenti su Amazon Lex.](https://aws.amazon.com/lex/faqs#data-security)   
Tipo: Booleano

 ** [clarificationPrompt](#API_GetBot_ResponseSyntax) **   <a name="lex-GetBot-response-clarificationPrompt"></a>
Il messaggio che Amazon Lex utilizza quando non comprende la richiesta dell'utente. Per ulteriori informazioni, consulta [PutBot](API_PutBot.md).   
Tipo: oggetto [Prompt](API_Prompt.md)

 ** [createdDate](#API_GetBot_ResponseSyntax) **   <a name="lex-GetBot-response-createdDate"></a>
La data di creazione del bot.  
Tipo: Timestamp

 ** [description](#API_GetBot_ResponseSyntax) **   <a name="lex-GetBot-response-description"></a>
Una descrizione del bot.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima di 0. Lunghezza massima di 200.

 ** [detectSentiment](#API_GetBot_ResponseSyntax) **   <a name="lex-GetBot-response-detectSentiment"></a>
Indica se gli enunciati degli utenti devono essere inviati ad Amazon Comprehend per l'analisi del sentiment.  
Tipo: Booleano

 ** [enableModelImprovements](#API_GetBot_ResponseSyntax) **   <a name="lex-GetBot-response-enableModelImprovements"></a>
Indica se il bot utilizza miglioramenti di precisione. `true`indica che il bot sta utilizzando i miglioramenti, altrimenti`false`.  
Tipo: Booleano

 ** [failureReason](#API_GetBot_ResponseSyntax) **   <a name="lex-GetBot-response-failureReason"></a>
In caso `status` `FAILED` affermativo, Amazon Lex spiega perché non è riuscito a creare il bot.  
Tipo: String

 ** [idleSessionTTLInSeconds](#API_GetBot_ResponseSyntax) **   <a name="lex-GetBot-response-idleSessionTTLInSeconds"></a>
Il tempo massimo, in secondi, durante il quale Amazon Lex conserva i dati raccolti in una conversazione. Per ulteriori informazioni, consulta [PutBot](API_PutBot.md).  
Tipo: numero intero  
Intervallo valido: valore minimo pari a 60. Valore massimo pari a 86400.

 ** [intents](#API_GetBot_ResponseSyntax) **   <a name="lex-GetBot-response-intents"></a>
Un array di oggetti `intent`. Per ulteriori informazioni, consulta [PutBot](API_PutBot.md).  
Tipo: matrice di oggetti [Intent](API_Intent.md)

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

 ** [locale](#API_GetBot_ResponseSyntax) **   <a name="lex-GetBot-response-locale"></a>
 Il locale di destinazione per il bot.   
Tipo: String  
Valori validi: `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](#API_GetBot_ResponseSyntax) **   <a name="lex-GetBot-response-name"></a>
Il nome del bot.  
Tipo: String  
Vincoli di lunghezza: lunghezza minima di 2. La lunghezza massima è 50 caratteri.  
Modello: `^([A-Za-z]_?)+$` 

 ** [nluIntentConfidenceThreshold](#API_GetBot_ResponseSyntax) **   <a name="lex-GetBot-response-nluIntentConfidenceThreshold"></a>
Il punteggio che determina dove Amazon Lex inserisce o entrambi quando restituisce intenti alternativi in una risposta [PostContent](https://docs.aws.amazon.com/lex/latest/dg/API_runtime_PostContent.html)o [PostText](https://docs.aws.amazon.com/lex/latest/dg/API_runtime_PostText.html). `AMAZON.FallbackIntent` `AMAZON.KendraSearchIntent` `AMAZON.FallbackIntent`viene inserito se il punteggio di confidenza a tutti gli effetti è inferiore a questo valore. `AMAZON.KendraSearchIntent`viene inserito solo se è configurato per il bot.  
Tipo: numero a doppia precisione  
Intervallo valido: valore minimo di 0. Valore massimo di 1.

 ** [status](#API_GetBot_ResponseSyntax) **   <a name="lex-GetBot-response-status"></a>
Lo stato del bot.   
Quando lo stato è, `BUILDING` Amazon Lex crea il bot per il test e l'uso.  
Se lo stato del bot è uguale`READY_BASIC_TESTING`, puoi testarlo utilizzando le espressioni esatte specificate nelle intenzioni del bot. Quando il bot è pronto per il test completo o per l'esecuzione, lo stato è. `READY`  
Se c'è stato un problema con la creazione del bot, lo stato è `FAILED` e il `failureReason` campo spiega perché il bot non ha creato.  
Se il bot è stato salvato ma non creato, lo stato è`NOT_BUILT`.  
Tipo: String  
Valori validi: `BUILDING | READY | READY_BASIC_TESTING | FAILED | NOT_BUILT` 

 ** [version](#API_GetBot_ResponseSyntax) **   <a name="lex-GetBot-response-version"></a>
La versione del bot. Per un nuovo bot, la versione è sempre`$LATEST`.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 64 caratteri.  
Modello: `\$LATEST|[0-9]+` 

 ** [voiceId](#API_GetBot_ResponseSyntax) **   <a name="lex-GetBot-response-voiceId"></a>
L'ID vocale Amazon Polly utilizzato da Amazon Lex per l'interazione vocale con l'utente. Per ulteriori informazioni, consulta [PutBot](API_PutBot.md).  
Tipo: String

## Errori
<a name="API_GetBot_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_GetBot_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/GetBot) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetBot) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetBot) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetBot) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetBot) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetBot) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetBot) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetBot) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetBot) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetBot)