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à.
# Impostazione degli attributi di richiesta
Gli *attributi di richiesta* contengono informazioni specifiche sulla richiesta e si applicano solo alla richiesta corrente. Un'applicazione client invia queste informazioni ad Amazon Lex. Utilizza gli attributi di richiesta per inviare informazioni che non devono essere conservate per l'intera sessione. Puoi creare i tuoi attributi di richiesta personali oppure utilizzare quelli predefiniti. Per inviare gli attributi di richiesta, utilizza l'intestazione `x-amz-lex-request-attributes` in un [PostContent](API_runtime_PostContent.md) o il campo `requestAttributes` in una richiesta [PostText](API_runtime_PostText.md). Poiché, a differenza degli attributi di sessione, gli attributi di richiesta non vengono mantenuti tra richieste diverse, non vengono restituiti nelle risposte `PostContent` o `PostText`.
**Nota**
Per inviare informazioni che vengano mantenute tra richieste diverse, utilizza gli attributi di sessione.
Il namespace `x-amz-lex:` è riservato agli attributi di richiesta predefiniti. Non creare attributi di richiesta con il prefisso `x-amz-lex:`.
## Impostazione di attributi di richiesta predefiniti
Amazon Lex fornisce attributi di richiesta predefiniti per gestire il modo in cui elabora le informazioni inviate al bot. Gli attributi non vengono salvati per l'intera sessione, quindi dovrai inviare gli attributi predefiniti in ogni richiesta. Tutti gli attributi predefiniti sono nel namespace `x-amz-lex:`.
Oltre ai seguenti attributi predefiniti, Amazon Lex fornisce attributi predefiniti per le piattaforme di messaggistica. Per un elenco di questi attributi, consulta [Implementazione di un bot Amazon Lex su una piattaforma di messaggistica](example1.md).
### Impostazione del tipo di risposta
Se utilizzi due applicazioni client che hanno funzionalità diverse, potresti dover limitare il formato dei messaggi in una risposta. Ad esempio, potresti voler limitare i messaggi inviati a un client Web al testo normale, ma permettere a un client mobile di utilizzare sia testo normale sia il formato SSML (Speech Synthesis Markup Language). Per impostare il formato dei messaggi restituiti dalle operazioni [PostContent](API_runtime_PostContent.md) e [PostText](API_runtime_PostText.md), utilizza l'attributo di richiesta `x-amz-lex:accept-content-types"`.
Puoi impostare l'attributo su una qualsiasi combinazione dei seguenti tipi di messaggi:
+ `PlainText`—Il messaggio contiene testo UTF-8 semplice.
+ `SSML`—Il messaggio contiene testo formattato per l'output vocale.
+ `CustomPayload`—Il messaggio contiene un formato personalizzato che hai creato per il tuo cliente. Puoi definire il payload in base alle esigenze della tua applicazione.
Amazon Lex restituisce solo messaggi con il tipo specificato `Message` nel campo della risposta. Puoi impostare più di un valore separandoli con una virgola. Se utilizzi dei gruppi di messaggi, ogni gruppo di messaggi deve contenere almeno un messaggio del tipo specificato. In caso contrario, viene visualizzato un errore `NoUsableMessageException`. Per ulteriori informazioni, consulta [Gruppi di messaggi](howitworks-manage-prompts.md#message-groups).
**Nota**
L'attributo di richiesta `x-amz-lex:accept-content-types` non ha alcun effetto sul contenuto del corpo HTML. Il contenuto di una risposta dell'operazione `PostText` è sempre testo normale UTF-8. Il corpo di una risposta dell'operazione `PostContent` contiene dati nel formato impostato nell'intestazione `Accept` nella richiesta.
### Impostazione del fuso orario preferito
Per impostare il fuso orario dell'utente da utilizzare per risolvere le date, utilizza l'attributo di richiesta `x-amz-lex:time-zone`. Se non specifichi un fuso orario nell'attributo `x-amz-lex:time-zone`, il valore predefinito dipende della regione che utilizzi per il tuo bot.
| Region | Fuso orario predefinito |
| --- | --- |
| Stati Uniti orientali (Virginia settentrionale) | America/New\$1York |
| Stati Uniti occidentali (Oregon) | America/Los\$1Angeles |
| Asia Pacifico (Singapore) | Asia/Singapore |
| Asia Pacifico (Sydney) | Australia/Sydney |
| Asia Pacifico (Tokyo) | Asia/Tokyo |
| Europa (Francoforte) | Europe/Berlin |
| Europa (Irlanda) | Europe/Dublin |
| Europa (Londra) | Europe/London |
Ad esempio, se l'utente risponde `tomorrow` in risposta alla richiesta «In che giorno desideri che il pacco venga consegnato?» la *data* effettiva di consegna del pacco dipende dal fuso orario dell'utente. Ad esempio, quando sono le 02:00 del 16 settembre a New York, sono le 23:00 del 15 settembre a Los Angeles. Se il servizio è attivo nella regione degli Stati Uniti orientali (Virginia settentrionale) e una persona a Los Angeles ordina un pacco da consegnare «domani» utilizzando il fuso orario predefinito, il pacco verrà consegnato il 17 e non il 16. Se invece imposti l'attributo di richiesta `x-amz-lex:time-zone` su `America/Los_Angeles`, il pacco verrà consegnato il giorno 16.
Puoi impostare l'attributo su uno dei nomi dei fusi orari della IANA (Internet Assigned Number Authority). Per l'elenco dei nomi dei fusi orari, consulta l'[elenco dei fusi orari del database tz](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) su Wikipedia.
## Impostazione di attributi di richiesta definiti dall'utente
Un *attributo di richiesta definito dall'utente* è un'informazione che invii al tuo bot con ciascuna richiesta. Invii l'informazione nell'intestazione `amz-lex-request-attributes` di una richiesta `PostContent` o nel campo `requestAttributes` di una richiesta `PostText`.
Per inviare gli attributi della richiesta ad Amazon Lex, crei una string-to-string mappa degli attributi. Di seguito viene spiegato come mappare gli attributi di richiesta:
```
{
"attributeName": "attributeValue",
"attributeName": "attributeValue"
}
```
Per l'operazione `PostText`, inserisci la mappa nel corpo della richiesta utilizzando il campo `requestAttributes`, come segue:
```
"requestAttributes": {
"attributeName": "attributeValue",
"attributeName": "attributeValue"
}
```
Per l'operazione `PostContent`, applica la codifica base64 alla mappa e inviala come l'intestazione `x-amz-lex-request-attributes`.
Per inviare dati binari o strutturati in un attributo di richiesta, devi dapprima trasformarli in una stringa semplice. Per ulteriori informazioni, consulta [Impostazione di attributi complessi](context-mgmt-complex-attributes.md).