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à.
# Utilizzo BedrockAgentIntent per utilizzare un agente Amazon Bedrock in Amazon Lex V2
**Nota**
Prima di poter sfruttare le funzionalità di intelligenza artificiale generativa, è necessario soddisfare i seguenti prerequisiti
Per informazioni sui prezzi per l'utilizzo di Amazon Bedrock, consulta i prezzi di [Amazon Bedrock](https://aws.amazon.com/bedrock/pricing/).
Attiva le funzionalità di intelligenza artificiale generativa per le impostazioni locali del tuo bot. Per farlo, segui i passaggi indicati in[Ottimizza la creazione e le prestazioni dei bot Lex V2 utilizzando l'intelligenza artificiale generativa](generative-features.md).
Puoi sfruttare Amazon Bedrock Agents per gestire carichi di lavoro complessi richiesti dai clienti senza dover passare attraverso un processo completo di definizione delle attività. Amazon Lex V2 offre una funzionalità integrata `AMAZON.BedrockAgentIntent` che puoi aggiungere al tuo bot. Questo intento sfrutta le funzionalità di intelligenza artificiale generativa di Amazon Bedrock riconoscendo le richieste dei clienti, analizzandole, ragionandole e infine rispondendo. Ha anche la capacità di porre eventuali domande di follow-up al fine di portare a termine l'attività richiesta (ad esempio, immagina che tu abbia definito un agente di vendita al dettaglio in grado di controllare lo stato dell'ordine del cliente). Quando il cliente chiede lo stato dell'ordine, l'agente prima richiede `customerId` o si `emailId` associa per recuperare i dettagli e infine risponde indicando lo stato corretto dell'ordine). Puoi anche decidere di integrare il tuo AMAZON. BedrockAgentIntent con una Bedrock Knowledge Base per rispondere direttamente alle domande dei clienti.
Assicurati che il tuo ruolo IAM disponga delle autorizzazioni appropriate per accedere ad AMAZON. BedrockAgentIntent seguendo i passaggi indicati in Autorizzazioni per AMAZON. BedrockAgentIntent
Per sfruttare AMAZON. BedrockAgentIntent devi aver creato uno dei seguenti knowledge store.
+ Agenti Amazon Bedrock: per ulteriori informazioni, consulta [Creazione di agenti Bedrock](https://docs.aws.amazon.com/bedrock/latest/userguide/agents.html).
+ Amazon Bedrock Knowledge Base: per ulteriori informazioni, consulta [Creazione di una Knowledge Base](https://docs.aws.amazon.com/bedrock/latest/userguide/knowledge-base-create.html).
Per utilizzare AMAZON. BedrockAgentIntent, assicurati che il tuo ruolo IAM disponga delle autorizzazioni appropriate seguendo i passaggi riportati in [Autorizzazioni necessarie in Lex V2 for Bedrock](https://docs.aws.amazon.com/lexv2/latest/dg/bedrock-agent-intent-permissions.html) Agent Intent.
**Topics**
+ [Abilita Bedrock Agent Intent nella schermata di configurazione dell'IA generativa](bedrock-agent-intent-genai.md)
+ [Abilita Bedrock Agent Intent aggiungendo un intento integrato al bot](bedrock-agent-intent-level.md)
+ [Autorizzazioni necessarie in Lex V2 per Bedrock Agent Intent](bedrock-agent-intent-permissions.md)
+ [Richiesta di esempio con attributi di sessione](bedrock-agent-intent-sample.md)
# Abilita Bedrock Agent Intent nella schermata di configurazione dell'IA generativa
Puoi abilitare Bedrock Agent Intent accedendo alla schermata Generative AI.
1. Accedi alla Console di gestione AWS e apri la console Amazon Lex V2 da [https://console.aws.amazon.com/lexv2/casa](https://console.aws.amazon.com/lexv2/home).
1. Nel pannello di navigazione sotto **Bots**, seleziona il bot che desideri utilizzare per Bedrock Agent Intent.
1. Seleziona la lingua per il bot che desideri abilitare.
1. Vai alla sezione **Configurazione dell'IA generativa** sullo schermo e seleziona **Configura**.
1. Nella sezione BedrockAgentIntent di configurazione, seleziona **Crea BedrockAgent intento**.
# Abilita Bedrock Agent Intent aggiungendo un intento integrato al bot
Puoi abilitare Bedrock Agent Intent aggiungendo un intento integrato al tuo bot Amazon Lex V2.
**Nota**
Devi prima attivare la funzionalità Bedrock Agent Intent nel pannello Generative AI per attivare la funzionalità per i singoli bot.
1. Accedi alla Console di gestione AWS e apri la console Amazon Lex V2 da https://console.aws.amazon.com/lexv2/ casa.
1. Nel pannello di navigazione sotto **Bots**, seleziona il bot che desideri utilizzare per Bedrock Agent Intent.
1. In Tutte le lingue, seleziona **Inglese (Stati Uniti**) per espandere l'elenco.
1. Seleziona **Aggiungi intento** e scegli **Usa intento integrato** dal menu a discesa.
1. Per maggiori dettagli sulle configurazioni per AMAZON. BedrockAgentIntent, vedi[AMAZON.BedrockAgentIntent](built-in-intent-bedrockagent.md).
# Autorizzazioni necessarie in Lex V2 per Bedrock Agent Intent
+ Per accedere a questa funzionalità sulla console Amazon Lex V2, assicurati che la console disponga del ruolo `bedrock:ListFoundationModels` e delle `bedrock:ListInferenceProfiles` autorizzazioni.
+ Il ruolo IAM associato al bot dovrebbe avere le autorizzazioni necessarie per. `AMAZON.BedrockAgentIntent`
Il ruolo bot deve disporre delle autorizzazioni per la chiamata `bedrock:InvokeAgent` se utilizza Amazon Bedrock Agents `bedrock:InvokeModel` e `bedrock:RetrieveAndGenerate` se utilizza Amazon Bedrock Knowledge Bases nell'intento. Inoltre, devi allegare una dichiarazione per ciascuno degli agenti che specifichi nei tuoi bot `AMAZON.BedrockAgentIntent` (consulta la dichiarazione Autorizzazioni ad accedere ad Amazon Bedrock Agent o Autorizzazioni ad accedere alle Knowledge Bases di Amazon Bedrock nella politica riportata di seguito).
Quando abiliti la funzionalità con la console Amazon Lex, la policy verrà aggiunta automaticamente al ruolo bot a condizione che il bot utilizzi un ruolo collegato al servizio generato da Amazon Lex.
# Richiesta di esempio con attributi di sessione
L'esempio seguente mostra come richiamare AMAZON. BedrockAgentIntent e dimostra gli attributi di sessione e richiesta che vengono compilati nella risposta. Questi attributi contengono i dati di risposta dell'agente Bedrock e possono essere utilizzati per accedere all'output dell'agente, alle fonti della Knowledge Base di Amazon Bedrock e ai dettagli delle chiamate dei gruppi di azione.
```
{
"sessionId": "user-session-123",
"messages": [{
"content": "Your order #12345 is currently being processed and will ship within 2-3 business days. You will receive a tracking number via email once it ships.",
"contentType": "PlainText"
}],
"sessionState": {
"sessionAttributes": {
"x-amz-lex:bedrock-agent-search-response": "Your order #12345 is currently being processed and will ship within 2-3 business days. You will receive a tracking number via email once it ships.",
"x-amz-lex:bedrock-knowledge-base-search-response-source": "[{\"title\": \"Order Processing Guide\", \"uri\": \"s3://knowledge-base/orders/processing.pdf\", \"excerpt\": \"Standard orders typically ship within 2-3 business days...\"}]",
"x-amz-lex:bedrock-agent-action-group-invocation-input": "{\"actionGroupName\": \"OrderLookup\", \"function\": \"getOrderStatus\", \"parameters\": {\"orderId\": \"12345\", \"customerId\": \"67890\"}}",
"x-amz-lex:bedrock-agent-knowledge-base-lookup-input": "{\"knowledgeBaseId\": \"KB123456\", \"query\": \"order status processing time\", \"numberOfResults\": 3}"
},
"intent": {
"name": "BedrockAgentIntent",
"slots": {},
"state": "Fulfilled",
"confirmationState": "None"
},
"dialogAction": {
"type": "ElicitIntent"
}
},
"interpretations": [{
"intent": {
"name": "FallbackIntent",
"slots": {}
},
"interpretationSource": "Lex"
}],
"requestAttributes": {
"x-amz-lex:channels:platform": "Web",
"x-amz-lex:accept-content-types": "PlainText",
"x-amz-lex:bedrock-agent-search-response": "Your order #12345 is currently being processed and will ship within 2-3 business days. You will receive a tracking number via email once it ships.",
"x-amz-lex:bedrock-knowledge-base-search-response-source": "[{\"title\": \"Order Processing Guide\", \"uri\": \"s3://knowledge-base/orders/processing.pdf\", \"excerpt\": \"Standard orders typically ship within 2-3 business days...\"}]",
"x-amz-lex:bedrock-agent-action-group-invocation-input": "{\"actionGroupName\": \"OrderLookup\", \"function\": \"getOrderStatus\", \"parameters\": {\"orderId\": \"12345\", \"customerId\": \"67890\"}}",
"x-amz-lex:bedrock-agent-knowledge-base-lookup-input": "{\"knowledgeBaseId\": \"KB123456\", \"query\": \"order status processing time\", \"numberOfResults\": 3}"
}
}
```
In questo esempio, gli attributi di sessione mostrano come vengono BedrockAgentIntent compilati i dati di risposta, tra cui la risposta dell'agente, le fonti della Knowledge Base di Amazon Bedrock utilizzate, le invocazioni dei gruppi di azione e i dettagli di ricerca della Amazon Bedrock Knowledge Base utilizzati per generare la risposta.
[Per ulteriori informazioni, consulta AMAZON. BedrockAgentIntent](https://docs.aws.amazon.com/lexv2/latest/dg/built-in-intent-bedrockagent.html).