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 Amazon Lex V1 o alle risorse Amazon Lex V1. Se utilizzi Amazon Lex V2, consulta invece la guida Amazon Lex V2.
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à.
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
GET /bots/name/versions/versionoralias HTTP/1.1
Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
- name
-
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]_?)+$Campo obbligatorio: sì
- versionoralias
-
La versione o l'alias del bot.
Campo obbligatorio: sì
Corpo della richiesta
La richiesta non ha un corpo della richiesta.
Sintassi della risposta
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
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
- abortStatement
-
Il messaggio che Amazon Lex restituisce quando l'utente decide di terminare la conversazione senza completarla. Per ulteriori informazioni, consulta PutBot.
Tipo: oggetto Statement
- checksum
-
Checksum del bot utilizzato per identificare una revisione specifica della versione del bot.
$LATESTTipo: stringa
- childDirected
-
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
trueofalsenelchildDirectedcampo. SpecificandotruenelchildDirectedcampo, 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. SpecificandofalsenelchildDirectedcampo, confermi che il tuo utilizzo 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 ilchildDirectedcampo 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.
Tipo: Booleano
- clarificationPrompt
-
Il messaggio che Amazon Lex utilizza quando non comprende la richiesta dell'utente. Per ulteriori informazioni, consulta PutBot.
Tipo: oggetto Prompt
- createdDate
-
La data di creazione del bot.
Tipo: Timestamp
- description
-
Una descrizione del bot.
Tipo: stringa
Limitazioni di lunghezza: lunghezza minima di 0. Lunghezza massima di 200.
- detectSentiment
-
Indica se gli enunciati degli utenti devono essere inviati ad Amazon Comprehend per l'analisi del sentiment.
Tipo: Booleano
- enableModelImprovements
-
Indica se il bot utilizza miglioramenti di precisione.
trueindica che il bot sta utilizzando i miglioramenti, altrimentifalse.Tipo: Booleano
- failureReason
-
In caso
statusFAILEDaffermativo, Amazon Lex spiega perché non è riuscito a creare il bot.Tipo: stringa
- idleSessionTTLInSeconds
-
Il tempo massimo, in secondi, durante il quale Amazon Lex conserva i dati raccolti in una conversazione. Per ulteriori informazioni, consulta PutBot.
Tipo: integer
Intervallo valido: valore minimo pari a 60. Valore massimo pari a 86400.
- intents
-
Un array di oggetti
intent. Per ulteriori informazioni, consulta PutBot.Tipo: matrice di oggetti Intent
- lastUpdatedDate
-
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
-
Il locale di destinazione per il bot.
Tipo: stringa
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
-
Il nome del bot.
Tipo: stringa
Vincoli di lunghezza: lunghezza minima di 2. La lunghezza massima è 50 caratteri.
Modello:
^([A-Za-z]_?)+$ - nluIntentConfidenceThreshold
-
Il punteggio che determina dove Amazon Lex inserisce o entrambi quando restituisce intenti alternativi in una risposta PostContento PostText.
AMAZON.FallbackIntentAMAZON.KendraSearchIntentAMAZON.FallbackIntentviene inserito se il punteggio di confidenza a tutti gli effetti è inferiore a questo valore.AMAZON.KendraSearchIntentviene inserito solo se è configurato per il bot.Tipo: double
Intervallo valido: valore minimo di 0. Valore massimo di 1.
- status
-
Lo stato del bot.
Quando lo stato è,
BUILDINGAmazon 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 è.READYSe c'è stato un problema con la creazione del bot, lo stato è
FAILEDe ilfailureReasoncampo spiega perché il bot non ha creato.Se il bot è stato salvato ma non creato, lo stato è
NOT_BUILT.Tipo: stringa
Valori validi:
BUILDING | READY | READY_BASIC_TESTING | FAILED | NOT_BUILT - version
-
La versione del bot. Per un nuovo bot, la versione è sempre
$LATEST.Tipo: stringa
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 64 caratteri.
Modello:
\$LATEST|[0-9]+ - voiceId
-
L'ID vocale Amazon Polly utilizzato da Amazon Lex per l'interazione vocale con l'utente. Per ulteriori informazioni, consulta PutBot.
Tipo: stringa
Errori
- 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
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
