Se utilizzi Amazon Lex V2, consulta invece la guida Amazon Lex V2.
Se utilizzi Amazon Lex V1, ti consigliamo di aggiornare i bot ad Amazon Lex V2. Non stiamo più aggiungendo nuove funzionalità alla V1 e consigliamo vivamente di utilizzare la V2 per tutti i nuovi bot.
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
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
GET /intents/name/versions/version HTTP/1.1
Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
- name
-
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]_?)+$Campo obbligatorio: sì
- version
-
La versione dell'intento.
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 64 caratteri.
Modello:
\$LATEST|[0-9]+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
{
"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
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
- checksum
-
Checksum dell'intento.
▬Tipo: stringa
- conclusionStatement
-
Dopo che la funzione Lambda specificata nell'
fulfillmentActivityelemento soddisfa l'intento, Amazon Lex trasmette questa dichiarazione all'utente.Tipo: oggetto Statement
- confirmationPrompt
-
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.
Tipo: oggetto Prompt
- createdDate
-
La data in cui è stato creato l'intento.
Tipo: Timestamp
- description
-
Una descrizione dell'intento.
▬Tipo: stringa
Limitazioni di lunghezza: lunghezza minima di 0. Lunghezza massima di 200.
- dialogCodeHook
-
Se definita nel bot, Amazon Amazon Lex richiama questa funzione Lambda per ogni input dell'utente. Per ulteriori informazioni, consulta PutIntent.
Tipo: oggetto CodeHook
- followUpPrompt
-
Se definito nel bot, Amazon Lex utilizza questo prompt per sollecitare ulteriori attività utente dopo che l'intento è stato raggiunto. Per ulteriori informazioni, consulta PutIntent.
Tipo: oggetto FollowUpPrompt
- fulfillmentActivity
-
Descrive come viene soddisfatto l'intento. Per ulteriori informazioni, consulta PutIntent.
Tipo: oggetto FulfillmentActivity
- inputContexts
-
Una serie di
InputContextoggetti 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
Membri dell'array: numero minimo di 0 elementi. Numero massimo 5 elementi.
- kendraConfiguration
-
Informazioni di configurazione, se presenti, per connettersi a un indice Amazon Kendra con l'intento.
AMAZON.KendraSearchIntentTipo: oggetto KendraConfiguration
- lastUpdatedDate
-
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
-
Il nome dell'intento.
▬Tipo: stringa
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 100.
Modello:
^([A-Za-z]_?)+$ - outputContexts
-
Una matrice di
OutputContextoggetti che elenca i contesti che l'intento attiva quando l'intento viene soddisfatto.Tipo: matrice di oggetti OutputContext
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 10 elementi.
- parentIntentSignature
-
Un identificatore univoco per un intento incorporato.
▬Tipo: stringa
- rejectionStatement
-
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
- sampleUtterances
-
Una serie di espressioni di esempio configurate per l'intento.
Tipo: matrice 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
-
Una serie di slot di intento configurati per l'intento.
Tipo: matrice di oggetti Slot
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 100 elementi.
- version
-
La versione dell'intento.
▬Tipo: stringa
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 64 caratteri.
Modello:
\$LATEST|[0-9]+
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 uno degli AWS SDK specifici della lingua, consulta quanto segue:
