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à.
# Configurazione iniziale per gli agenti AI
Per iniziare a utilizzare gli agenti Connect AI, devi prima creare un dominio. Come parte di questo processo puoi anche opzionalmente:
+ Crea una chiave di crittografia per crittografare l’estratto fornito nei suggerimenti all’agente.
+ Creare una knowledge base utilizzando dati esterni.
+ Esegui la crittografia del contenuto importato da queste applicazioni usando una chiave KMS.
Le seguenti sezioni spiegano come utilizzare la console Amazon Connect per abilitare gli agenti Connect AI. Seguili nell’ordine in cui sono elencati. Se vuoi utilizzarla APIs, supponiamo che tu abbia le competenze di programmazione necessarie.
**Topics**
+ [Tipologie di contenuto supportate](#q-content-types)
+ [Panoramica dell’integrazione](#ai-agent-overview)
+ [Prima di iniziare](#ai-agent-requirements)
+ [Fase 1: Creazione di un dominio](#enable-ai-agents-step1)
+ [Fase 2: crittografare il dominio](#enable-ai-agents-step-2)
+ [Fase 3: creare un’integrazione (knowledge base)](#enable-ai-agents-step-3)
+ [Passaggio 4: configura il flusso per gli agenti Connect AI](#enable-ai-agents-step4)
+ [Cosa succede se dispongo di più basi di conoscenza?](#multiple-knowledge-base-tips)
+ [Data dell'ultimo aggiornamento della knowledge base](#enable-ai-agents-tips)
+ [Servizio di inferenza tra Regioni](#enable-ai-agents-cross-region-inference-service)
## Tipologie di contenuto supportate
Gli agenti Connect AI supportano l'inserimento di file HTML, Word, PDF e di testo fino a 1 MB. Tenere presente quanto segue:
+ I file di testo normale devono essere in formato UTF-8.
+ I documenti di Word devono essere in formato DOCX.
+ I documenti di Word vengono convertiti automaticamente in HTML semplificato e non mantengono la famiglia di caratteri, la dimensione, il colore, l’evidenziazione, l’allineamento o altre caratteristiche di formattazione del documento di origine, come i colori di sfondo, le intestazioni o i piè di pagina.
+ I file PDF non possono essere crittografati o protetti da password.
+ Le azioni e gli script incorporati nei file PDF non sono supportati.
Per un elenco di quote regolabili, ad esempio il numero di risposte rapide per base di conoscenza, consulta [Quote di servizio Connect AI Agents](amazon-connect-service-limits.md#connect-ai-agents-quotas).
## Panoramica dell’integrazione
Segui questi passaggi generali per abilitare gli agenti Connect AI:
1. Crea un dominio (assistente). Un dominio è costituito da un'unica knowledge base, ad esempio SalesForce o Zendesk.
1. Crea una chiave di crittografia per crittografare l’estratto fornito nei suggerimenti all’agente.
1. Crea una knowledge base usando dati esterni:
+ Aggiungi integrazioni di dati da Amazon S3, SharePoint Microsoft Online[,](https://developer.salesforce.com/docs/atlas.en-us.knowledge_dev.meta/knowledge_dev/sforce_api_objects_knowledge__kav.htm) Salesforce [ ServiceNow](https://developer.servicenow.com/dev.do#!/reference/api/rome/rest/knowledge-management-api) ZenDesk e utilizza connettori predefiniti nella console Amazon Connect.
+ Esegui la crittografia del contenuto importato da queste applicazioni usando una chiave KMS.
+ Per alcune integrazioni, specifica la frequenza di sincronizzazione.
+ Rivedi l’integrazione.
1. Configurazione del flusso.
1. Assegnazione delle autorizzazioni.
## Prima di iniziare
Di seguito è riportata una panoramica dei concetti chiave e delle informazioni che ti verranno richieste durante il processo di configurazione.
Per iniziare a utilizzare gli agenti Connect AI, devi creare un *dominio*: un assistente composto da un'unica knowledge base. Segui queste linee guida durante la creazione dei domini:
+ È possibile creare più domini, ma questi non condividono integrazioni di applicazioni esterne o dati dei clienti tra loro.
+ Puoi associare ogni dominio a una o più istanze Amazon Connect, ma ogni istanza Amazon Connect può essere associata a un solo dominio.
**Nota**
Tutte le integrazioni di applicazioni esterne vengono create a livello di dominio. Tutte le istanze Amazon Connect associate a un dominio ereditano le integrazioni del dominio.
È possibile associare l’istanza Amazon Connect a un dominio diverso in qualsiasi momento, scegliendone uno diverso.
+ Tutte le integrazioni di applicazioni esterne vengono create a livello di dominio. Tutte le istanze Amazon Connect associate a un dominio ereditano le integrazioni del dominio.
+ È possibile associare l’istanza Amazon Connect a un dominio diverso in qualsiasi momento, scegliendone uno diverso.
### Come assegnare un nome al dominio
Quando crei un dominio, ti viene richiesto di fornire un nome di dominio descrittivo e significativo per te, ad esempio il nome della tua organizzazione.
### (Facoltativo) Crea AWS KMS keys per crittografare il dominio e il contenuto
Quando abiliti gli agenti Connect AI, per impostazione predefinita il dominio e la connessione sono crittografati con un Chiave di proprietà di AWS. Tuttavia, se desideri gestire le chiavi, puoi crearne o fornire due [AWS KMS keys](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#kms_keys):
+ Utilizza una chiave per il dominio Connect AI Agents, utilizzato per crittografare l'estratto fornito nei consigli.
+ Usa la seconda chiave per crittografare i contenuti importati da Amazon S3, SharePoint Microsoft Online, ServiceNow Salesforce o. ZenDesk Tieni presente che gli indici di ricerca degli agenti Connect AI sono sempre crittografati quando sono inattivi utilizzando un Chiave di proprietà di AWS.
Per creare chiavi KMS, segui le fasi riportate in [Fase 1: Creazione di un dominio](#enable-ai-agents-step1), più avanti in questa sezione.
La chiave gestita dal cliente viene creata e gestita dall'utente ed è di sua proprietà. Hai il pieno controllo della chiave KMS e vengono applicati dei AWS KMS costi.
Se scegli di configurare una chiave KMS in cui qualcun altro è l'amministratore, la chiave deve avere una policy che `kms:CreateGrant` consenta `kms:Decrypt` e `kms:GenerateDataKey*` autorizzi l'identità IAM utilizzando la chiave per richiamare gli agenti Connect AI. `kms:DescribeKey` Per utilizzare gli agenti Connect AI con chat, attività ed e-mail, la politica chiave per il dominio Connect AI Agents deve consentire `kms:Decrypt` e `kms:DescribeKey` autorizzare il responsabile del `connect.amazonaws.com` servizio. `kms:GenerateDataKey*`
**Nota**
Per utilizzare gli agenti Connect AI con chat, attività ed e-mail, la politica chiave del tuo dominio deve concedere al responsabile del `connect.amazonaws.com` servizio le seguenti autorizzazioni:
`kms:GenerateDataKey*`
`kms:DescribeKey`
`kms:Decrypt`
Per informazioni su come modificare una policy della chiave, consulta [Modifica di una policy delle chiavi](https://docs.aws.amazon.com/kms/latest/developerguide/key-policy-modifying.html) nella *Guida per gli sviluppatori del Servizio AWS di gestione delle chiavi (AWS KMS)*.
## Fase 1: Creazione di un dominio
I passaggi seguenti spiegano come aggiungere un dominio a un’istanza Amazon Connect e come aggiungere un’integrazione al dominio. Per completare questi passaggi, è necessario disporre di un’istanza senza un dominio.
1. Apri la console Amazon Connect all'indirizzo [https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/).
1. Nella pagina **Istanze di contact center virtuali di Amazon Connect** scegli **Alias istanza**, quindi il nome dell’istanza. Nell’immagine seguente è illustrato un tipico nome di istanza.
![\[La pagina delle istanze del contact center virtuale di Amazon Connect, l'alias dell'istanza.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/instance.png)
1. Nel riquadro di navigazione, scegli **AI Agents**, quindi scegli **Aggiungi dominio**.
1. Nella pagina **Aggiungi dominio** scegli **Crea un dominio**.
1. Nella casella **Nome dominio** inserisci un nome descrittivo, come il nome della tua organizzazione.
![\[Pagina Aggiungi dominio, opzione Crea un nuovo dominio.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/ai-agent-enter-domain-name.png)
1. Tieni aperta la pagina e vai alla fase successiva.
## Fase 2: crittografare il dominio
Puoi utilizzare la chiave predefinita di Amazon Connect per crittografare il tuo dominio. Puoi anche utilizzare una chiave esistente o creare chiavi di tua proprietà. Nelle fasi seguenti viene illustrato come utilizzare ogni tipo di chiave. Espandi ogni sezione in base alle esigenze.
### Utilizzare la chiave predefinita.
1. In **Crittografia**, deseleziona la casella di controllo **Personalizza le impostazioni di crittografia**.
1. Scegli **Add domain (Aggiungi dominio)**.
### Utilizzo di una chiave esistente
1. In **Crittografia**, apri l’elenco delle **chiavi AWS KMS** e seleziona la chiave desiderata.
1. Scegli **Add domain (Aggiungi dominio)**.
**Nota**
Per utilizzare una chiave esistente con chat, attività ed e-mail di Amazon Connect, devi concedere al responsabile del `connect.amazonaws.com` servizio le `kms:DescribeKey` autorizzazioni `kms:Decrypt``kms:GenerateDataKey*`, e.
Di seguito viene illustrata una tipica policy.
------
#### [ JSON ]
****
```
{
"Id": "key-consolepolicy-3",
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"AWS": "arn:aws:iam::111122223333:root"
},
"Action": "kms:*",
"Resource": "*"
},
{
"Effect": "Allow",
"Principal": {
"Service": "connect.amazonaws.com"
},
"Action": [
"kms:Decrypt",
"kms:GenerateDataKey*",
"kms:DescribeKey"
],
"Resource": "*"
}
]
}
```
------
### Crea una chiave AWS KMS
1. Nella pagina **Aggiungi dominio**, alla voce **Crittografia**, scegli **Crea una AWS KMS key**.
![\[Il pulsante Creazione di una chiave AWS KMS.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/q-encryption-settings-1.png)
In questo modo passi alla console del servizio di gestione delle chiavi (KMS). Completare la procedura riportata di seguito.
1. Nella console KMS, alla pagina **Configura chiave**, scegli **Simmetrica**, quindi scegli **Avanti**.
![\[Pagina Configura chiave, opzione Simmetrica.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/customer-profiles-create-kms-key-configure-key.png)
1. Nella pagina **Aggiungi etichette** aggiungi un alias e una descrizione per la chiave KMS e quindi scegli **Avanti**.
![\[Pagina Aggiungi etichette, Nome alias e Descrizione.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/ai-agents-create-kms-key-add-labels.png)
1. Nella pagina **Definisci le autorizzazioni amministrative chiave**, scegli **Avanti** e nella pagina **Definisci le autorizzazioni di utilizzo delle chiavi** scegli **Avanti** di nuovo.
1. Nella pagina **Verifica e modifica la policy della chiave** scorri verso il basso fino a **Policy delle chiavi**.
**Nota**
Per utilizzare gli agenti Connect AI con chat, attività ed e-mail, modifica la policy chiave per consentire e `kms:DescribeKey` autorizzare il responsabile del ` connect.amazonaws.com` servizio. `kms:Decrypt` ` kms:GenerateDataKey*` Il codice seguente mostra una policy di esempio.
****
```
{
"Id": "key-consolepolicy-3",
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"AWS": "arn:aws:iam::111122223333:root"
},
"Action": "kms:*",
"Resource": "*"
},
{
"Effect": "Allow",
"Principal": {
"Service": "connect.amazonaws.com"
},
"Action": [
"kms:Decrypt",
"kms:GenerateDataKey*",
"kms:DescribeKey"
],
"Resource": "*"
}
]
}
```
1. Scegli **Fine**.
**Nell'esempio seguente, il nome della chiave KMS inizia con 82af7d87.**
![\[La pagina Chiavi gestite dal cliente che mostra una chiave tipica.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/ai-agents-create-kms-key.png)
1. Torna alla scheda del browser **Connect AI Agents**, apri l'**AWS KMS key**elenco e seleziona la chiave che hai creato nei passaggi precedenti.
![\[Interfaccia delle impostazioni di crittografia con possibilità di personalizzare e selezionare una chiave AWS KMS.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/ai-agents-choose-kms-key.png)
1. Scegli **Add domain (Aggiungi dominio)**.
## Fase 3: creare un’integrazione (knowledge base)
1. Nella pagina **Agenti AI**, scegli **Aggiungi integrazione**.
1. Nella pagina **Aggiungi integrazione** scegli **Crea una nuova integrazione** e quindi seleziona un’origine.
![\[Pagina Aggiungi integrazione, opzione Crea una nuova integrazione, elenco a discesa Origine.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/wisdom-select-integration.png)
I passaggi per creare un’integrazione variano a seconda dell’origine scelta. Espandi le seguenti sezioni secondo necessità per completare la creazione di un’integrazione.
### Creare un’integrazione con Salesforce
Per creare un’integrazione con Salesforce è necessario seguire un processo in più fasi. Nelle sezioni seguenti viene illustrato come completare ogni fase.
#### Fase 1: aggiungere l’integrazione
1. Seleziona tutte le caselle di controllo che vengono visualizzate. In questo modo confermi la corretta configurazione del tuo account Salesforce:
![\[Riconoscimenti Salesforce per APIs, utilizzo di app connesse e accesso. AppFlow\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/q-integration-salesforce-1.png)
1. Nella casella **Nome dell’integrazione**, inserisci un nome per l’integrazione.
**Suggerimento**
Se crei più integrazioni dalla stessa origine, può essere utile sviluppare una convenzione di denominazione per distinguerne più facilmente i nomi.
1. Seleziona **Usa una connessione esistente**, apri l’elenco **Seleziona una connessione esistente** e scegli una connessione, quindi scegli **Avanti**.
- OPPURE -
Seleziona **Crea una nuova connessione** e segui questi passaggi:
1. Scegli **Produzione** o **Sandbox**.
1. In **Nome della connessione**, immetti il nome della connessione. Il nome è l’URL di Salesforce senza **https:**//.
1. Scegli **Connetti**, accedi a Salesforce e, quando richiesto, scegli **Consenti**.
1. In **Crittografia**, apri l’elenco delle **Chiavi AWS KMS** e scegli una chiave.
- OPPURE -
Scegli **Crea una chiave AWS KMS** e segui i passaggi elencati in precedenza in [Crea una chiave AWS KMS](#q-create-key) questa sezione.
1. (Facoltativo) In **Frequenza di sincronizzazione**, apri l’elenco delle **Frequenze di sincronizzazione** e seleziona un intervallo di sincronizzazione. L’impostazione predefinita del sistema è un’ora.
1. (Facoltativo) In **Data di inizio dell’importazione** scegli **Importa i record creati dopo**, quindi seleziona una data di inizio. Per impostazione predefinita, il sistema importa tutti i record.
1. Scegli **Avanti** e segui la procedura nella sezione successiva di questo argomento.
#### Fase 2: selezionare l’oggetto e i campi
**Suggerimento**
Se crei più integrazioni dalla stessa origine, può essere utile sviluppare una convenzione di denominazione per distinguerne più facilmente i nomi.
1. Nella pagina **Seleziona oggetti e campi**, apri l’elenco **Oggetti disponibili** e seleziona un oggetto. Nell’elenco vengono visualizzati solo gli oggetti della knowledge base.
1. In **Seleziona campi per** *nome oggetto*, scegli i campi che desideri utilizzare.
**Nota**
Per impostazione predefinita, il sistema seleziona automaticamente tutti i campi obbligatori.
1. Scegli **Next (Successivo)**.
#### Fase 3: rivedere e aggiungere l’integrazione
+ Controlla le impostazioni per l’integrazione. Al termine, scegli **Aggiungi integrazione**.
### Crea un'integrazione ServiceNow
1. In **Configurazione dell'integrazione**, seleziona la casella di controllo accanto a **Leggi e conferma che il tuo ServiceNow account soddisfa i requisiti di integrazione**. .
1. Nella casella **Nome dell’integrazione**, inserisci un nome per l’integrazione.
**Suggerimento**
Se crei più integrazioni dalla stessa origine, può essere utile sviluppare una convenzione di denominazione per distinguerne più facilmente i nomi.
1. Seleziona **Usa una connessione esistente**, apri l’elenco **Seleziona una connessione esistente** e scegli una connessione, quindi scegli **Avanti**.
- OPPURE -
Seleziona **Crea una nuova connessione** e segui questi passaggi:
1. Nella casella **Nome utente**, inserisci il tuo nome ServiceNow utente. È necessario disporre delle autorizzazioni di amministratore.
1. Nella casella **Password**, immetti la tua password.
1. Nella casella **URL dell'istanza**, inserisci il tuo ServiceNow URL.
1. In **Nome della connessione**, immetti un nome per la connessione.
1. Scegli **Connetti**.
1. In **Crittografia**, apri l’elenco delle **Chiavi AWS KMS** e scegli una chiave.
- OPPURE -
Scegli **Crea una chiave AWS KMS** e segui i passaggi elencati in [Crea una chiave AWS KMS](#q-create-key) precedenza in questa sezione.
1. (Facoltativo) In **Frequenza di sincronizzazione**, apri l’elenco delle **Frequenze di sincronizzazione** e seleziona un intervallo di sincronizzazione. L’impostazione predefinita del sistema è un’ora.
1. (Facoltativo) In **Data di inizio dell’importazione** scegli **Importa i record creati dopo**, quindi seleziona una data di inizio. Per impostazione predefinita, il sistema importa tutti i record.
1. Scegli **Next (Successivo)**.
1. Seleziona i campi per la knowledge base. I seguenti campi sono obbligatori:
+ short\$1description
+ numero
+ workflow\$1state
+ sys\$1mod\$1count
+ attiva
+ testo
+ sys\$1updated\$1on
+ più recente
+ sys\$1id
1. Scegli **Next (Successivo)**.
1. Rivedi le impostazioni, modificale se necessario, quindi scegli **Aggiungi integrazione**.
### Creazione di un’integrazione con Zendesk
**Prerequisiti**
Per connettersi a Zendesk è necessario disporre dei seguenti elementi:
+ Un client ID e un segreto client. Puoi ottenere l'ID e il segreto registrando la tua applicazione con Zendesk e abilitando un OAuth flusso di autorizzazione. Per ulteriori informazioni, consulta [Usare OAuth l'autenticazione con l'applicazione sul sito](https://support.zendesk.com/hc/en-us/articles/4408845965210-Using-OAuth-authentication-with-your-application) di assistenza di Zendesk.
+ In Zendesk, un URL di reindirizzamento configurato con la `https://[AWS REGION].console.aws.amazon.com/connect/v2/oauth`. Ad esempio, `https://ap-southeast-2.console.aws.amazon.com/connect/v2/oauth`.
Dopo aver ottenuto questi elementi, procedi nel seguente modo:
1. In **Configurazione dell’integrazione**, seleziona le caselle di controllo e inserisci un nome per l’integrazione.
**Suggerimento**
Se crei più integrazioni dalla stessa origine, può essere utile sviluppare una convenzione di denominazione per distinguerne più facilmente i nomi.
1. Seleziona **Usa una connessione esistente**, apri l’elenco **Seleziona una connessione esistente** e scegli una connessione, quindi scegli **Avanti**.
- OPPURE -
Seleziona **Crea una nuova connessione** e segui questi passaggi:
1. Inserisci un ID client valido, un segreto client, un nome account e un nome di connessione nelle rispettive caselle, quindi scegli **Connetti**.
1. Inserisci il tuo indirizzo e-mail e la tua password, quindi scegli **Accedi**.
1. Nella finestra pop-up che appare, seleziona **Consenti**.
1. In **Crittografia**, apri l’elenco delle **Chiavi AWS KMS** e scegli una chiave.
- OPPURE -
Scegli **Crea una chiave AWS KMS** e segui i passaggi elencati in [Crea una chiave AWS KMS](#q-create-key) precedenza in questa sezione.
1. (Facoltativo) In **Frequenza di sincronizzazione**, apri l’elenco delle **Frequenze di sincronizzazione** e seleziona un intervallo di sincronizzazione. L’impostazione predefinita del sistema è un’ora.
1. (Facoltativo) In **Data di inizio dell’importazione** scegli **Importa i record creati dopo**, quindi seleziona una data di inizio. Per impostazione predefinita, il sistema importa tutti i record.
1. Scegli **Next (Successivo)**.
1. Seleziona i campi per la knowledge base, quindi scegli **Avanti**.
1. Rivedi le impostazioni, modificale se necessario, quindi scegli **Aggiungi integrazione**.
Dopo aver creato l’integrazione, puoi solo modificarne l’URL.
### Crea un'integrazione SharePoint online
**Prerequisiti**
È necessario disporre del seguente elemento a cui connettersi SharePoint:
+ In SharePoint, un URL di reindirizzamento configurato con`https://[AWS REGION].console.aws.amazon.com/connect/v2/oauth`. Ad esempio, `https://ap-southeast-2.console.aws.amazon.com/connect/v2/oauth`.
**Nota**
Per le connessioni online è supportato solo AUTHORIZATION\$1CODE. SharePoint CLIENT\$1CREDENTIALS non è supportato.
Dopo aver ottenuto questo elemento, procedi nel seguente modo:
1. In **Configurazione dell’integrazione**, seleziona la casella di controllo e inserisci un nome per l’integrazione.
**Suggerimento**
Se crei più integrazioni dalla stessa origine, può essere utile sviluppare una convenzione di denominazione per distinguerne più facilmente i nomi.
1. In **Connessione con S3**, apri l’elenco **Seleziona una connessione esistente** e scegli una connessione, quindi scegli **Avanti**.
- OPPURE -
Seleziona **Crea una nuova connessione** e segui questi passaggi:
1. Inserisci il tuo ID tenant in entrambe le caselle, inserisci un nome della connessione, quindi scegli **Connetti**.
1. Inserisci il tuo indirizzo e-mail e la password per accedere. SharePoint
1. In **Crittografia**, apri l’elenco delle **Chiavi AWS KMS** e scegli una chiave.
- OPPURE -
Scegli **Crea una chiave AWS KMS** e segui i passaggi elencati in [Crea una chiave AWS KMS](#q-create-key) precedenza in questa sezione.
1. In **Frequenza di sincronizzazione**, accetta l’impostazione predefinita o apri l’elenco delle **Frequenze di sincronizzazione** e seleziona un intervallo di sincronizzazione.
1. Scegli **Next (Successivo)**.
1. In **Seleziona sito Microsoft SharePoint Online**, apri l'elenco e seleziona un sito.
1. In **Seleziona le cartelle dal** *nome del sito*, seleziona le cartelle che desideri includere nel tuo dominio, quindi scegli **Avanti**.
1. Rivedi le impostazioni, modificale se necessario, quindi scegli **Aggiungi integrazione**.
### Creazione di un’integrazione con Amazon Simple Storage Service
1. Nella casella **Nome dell’integrazione**, inserisci un nome per l’integrazione.
**Suggerimento**
Se crei più integrazioni dalla stessa origine, può essere utile sviluppare una convenzione di denominazione per distinguerne più facilmente i nomi.
1. In **Connessioni con Microsoft SharePoint Online**, apri l'elenco **Seleziona una connessione esistente** e scegli una connessione, quindi scegli **Avanti**.
- OPPURE -
In **Connessione con S3**, inserisci l’URI del tuo bucket Amazon S3, quindi scegli **Avanti**.
- OPPURE -
Scegli **Sfoglia S3**, utilizza la casella di ricerca per trovare il tuo bucket, seleziona il pulsante accanto ad esso, quindi seleziona **Scegli**.
1. In **Crittografia**, apri l’elenco delle **Chiavi AWS KMS** e scegli una chiave.
- OPPURE -
Scegli **Crea una chiave AWS KMS** e segui i passaggi elencati in [Crea una chiave AWS KMS](#q-create-key) precedenza in questa sezione.
1. Scegli **Next (Successivo)**.
1. Rivedi le impostazioni, modificale se necessario, quindi scegli **Aggiungi integrazione**.
### Creazione di un’integrazione con web crawler
Web crawler si connette alle pagine HTML e le scansiona a partire dall’URL iniziale, attraversando tutti i link secondari all’interno dello stesso dominio e percorso primari. Se una delle pagine HTML fa riferimento a documenti supportati, il web crawler recupererà tali documenti, indipendentemente dal fatto che si trovino all’interno dello stesso dominio primario.
**Funzionalità supportate**
+ Seleziona più elementi URLs da scansionare.
+ Rispetta le direttive robots.txt standard come “Allow” and “Disallow”.
+ Limita l'ambito di ricerca URLs per indicizzazione ed escludi, facoltativamente, quelli URLs che corrispondono a uno schema di filtro.
+ Limita la velocità di scansione. URLs
+ Visualizza lo stato dei URLs visitatori durante la scansione in Amazon. CloudWatch
#### Prerequisiti
+ Verifica di essere autorizzato a scansionare la tua fonte. URLs
+ Verifica che il percorso di robots.txt corrispondente alla tua fonte URLs non ne impedisca la URLs scansione. Il web crawler aderisce agli standard di robots.txt: disabilita per impostazione predefinita se robots.txt non viene trovato per il sito web. Il web crawler rispetta robots.txt in conformità con lo standard [RFC 9309](https://www.rfc-editor.org/rfc/rfc9309.html)
+ Verifica se le pagine URL di origine sono generate JavaScript dinamicamente, poiché la scansione dei contenuti generati dinamicamente non è attualmente supportata. Puoi verificarlo inserendo quanto segue nel browser: `view-source:https://examplesite.com/site/`. Se l’elemento body contiene solo un elemento `div` e pochi o nessun elemento `a href`, allora è probabile che la pagina venga generata in modo dinamico. Puoi disattivarlo JavaScript nel tuo browser, ricaricare la pagina web e verificare se il contenuto è visualizzato correttamente e contiene link alle tue pagine web di interesse.
**Nota**
Le ricerche per indicizzazione sul Web hanno un timeout predefinito di un'ora e verranno interrotte automaticamente quando viene raggiunto questo limite.
**Nota**
Quando selezioni i siti web da sottoporre al crawling, devi rispettare la [Policy di utilizzo accettabile di Amazon](https://aws.amazon.com/aup/) e tutti gli altri termini di Amazon. Ricorda che puoi utilizzare il crawler web solo per indicizzare pagine web di tua proprietà o di cui hai l’autorizzazione a eseguire il crawling.
#### Configurazione della connessione
Per riutilizzare un’integrazione esistente con i campi oggetto, scegli **Utilizza una connessione esistente**, apri l’elenco **Seleziona una connessione esistente** e scegli una connessione, quindi scegli **Avanti**.
Utilizzare la procedura seguente per creare una nuova integrazione:
1. Scegli **Crea una nuova connessione**.
1. Nella casella **Nome dell’integrazione** assegna un nome descrittivo all’integrazione.
![\[Pagina di configurazione dell’integrazione con web crawler che mostra il campo Nome dell’integrazione in cui gli utenti inseriscono un nome per la nuova connessione.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/web-crawler-ai-agent-config-1.png)
1. Nella URLs sezione **Connessione con Web Crawler > Sorgente, fornisci l'origine URLs** **del file che desideri sottoporre** a scansione. URLs **Puoi aggiungerne altri 9 URLs selezionando Aggiungi sorgente. URLs** Fornendo un URL di origine, confermi di avere l’autorizzazione a eseguire il crawling del relativo dominio.
![\[La URLs sezione Source per configurare la connessione del Web Crawler con i campi da inserire URLs per la scansione.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/web-crawler-q-config-2.png)
1. In Impostazioni avanzate, puoi facoltativamente configurare l’utilizzo della chiave KMS predefinita o di una chiave gestita dal cliente (CMK).
1. In **Ambito della sincronizzazione**
1. Seleziona un'opzione per l'**ambito della scansione della tua fonte**. URLs Puoi limitare l'ambito della scansione in base URLs alla relazione specifica tra l'URL di ogni pagina e il seme. URLs Per scansioni più rapide, puoi limitarti URLs a quelle con lo stesso host e lo stesso percorso URL iniziale dell'URL iniziale. Per indicizzazioni più ampie, puoi scegliere di eseguire la scansione URLs con lo stesso host o all'interno di qualsiasi sottodominio dell'URL iniziale.
**Nota**
Assicurati di non eseguire il crawling di pagine web potenzialmente eccessive. Non è consigliabile eseguire il crawling di siti web di grandi dimensioni, come wikipedia.org, senza filtri o limiti di ambito. Il crawling di siti web di grandi dimensioni richiederà molto tempo.
I [tipi di file supportati](https://docs.aws.amazon.com/bedrock/latest/userguide/knowledge-base-ds.html) vengono sottoposti a crawling indipendentemente dall’ambito e se non esiste uno schema di esclusione per il tipo di file.
1. Immetti la **Limitazione (della larghezza di banda della rete) massima della velocità di crawling**. Inserisci URLs tra 1 e 300 per host al minuto. URLs Una velocità di crawling più elevata aumenta il carico ma richiede meno tempo.
1. Per i modelli **Regex URL** (facoltativo) puoi aggiungere **Includi modelli** o **Escludi modelli** inserendo il modello di espressione regolare nella casella. Puoi aggiungere fino a 25 modelli di filtro di inclusione e 25 di esclusione selezionando **Aggiungi nuovo modello**. I modelli di inclusione ed esclusione vengono sottoposti a crawling in base all’ambito. In caso di conflitto, il modello di esclusione ha la precedenza.
1. È possibile includerne o escluderne alcuni URLs in base al proprio ambito. I [tipi di file supportati](https://docs.aws.amazon.com/bedrock/latest/userguide/knowledge-base-ds.html) vengono sottoposti a crawling indipendentemente dall’ambito e se non esiste uno schema di esclusione per il tipo di file. Se specifichi un filtro di inclusione ed esclusione ed entrambi corrispondono a un URL, il filtro di esclusione ha la precedenza e il contenuto web non viene sottoposto a crawling.
**Importante**
Vengono rifiutati i filtri problematici basati su modelli di espressioni regolari che portano a [backtracking e previsioni](https://docs.aws.amazon.com/codeguru/detector-library/python/catastrophic-backtracking-regex/) catastrofiche.
1. Di seguito è riportato un esempio di modello di filtro per espressioni regolari per escludere URLs che termina con allegati di pagine Web «.pdf» o PDF: `.*\.pdf$`
![\[La sezione dei modelli URL Regex che mostra un esempio dei modelli di esclusione dei file PDF.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/web-crawler-q-config-3.png)
1. Scegli **Next (Successivo)**.
1. Rivedi tutti i dettagli dell'integrazione.
![\[La pagina di revisione che mostra tutti i dettagli di integrazione per la configurazione del web crawler prima dell’invio finale.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/web-crawler-q-config-4.png)
1. Seleziona **Aggiungi integrazione**.
1. L’integrazione verrà aggiunta all’elenco.
### Crea un'integrazione con la knowledge base di Bedrock
Ora con Orchestration Type AI Agent, puoi utilizzare la tua Bedrock Knowledge Base per lavorare senza problemi con Connect AI Agents.
**Nota**
Il tipo di integrazione della knowledge base Bedrock è compatibile solo con i tipi di agenti di orchestrazione.
**Nota**
L'integrazione della knowledge base Bedrock è disponibile solo per le chiamate in contatto e non supporta la ricerca manuale fuori contatto.
1. Aggiungi una nuova integrazione
![\[La pagina Aggiungi integrazione.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/add-integration-page-ai-agents.png)
1. Scegli Bedrock Knowledge Base
![\[Selezione della knowledge base Bedrock dall'elenco delle fonti di dati\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/ai-agents-select-byobkb-data-source.png)
1. Seleziona la Bedrock Knowledge Base esistente
![\[Selezione della Bedrock Knowledge Base esistente\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/ai-agents-selecting-bedrock-knowledge-base.png)
1. Rivedi e aggiungi l'integrazione
![\[Pagina di revisione e integrazione di BYOBKB\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/ai-agents-byobkb-review-and-integrate.png)
Hai integrato con successo una Bedrock Knowledge Base esistente con gli agenti AI di Connect
**Nota**
Se elimini oggetti dalle applicazioni SaaS, come SalesForce e ServiceNow, le knowledge base di Amazon Connect non elaborano tali eliminazioni. È necessario archiviare gli oggetti SalesForce e ritirare gli articoli ServiceNow per rimuoverli da tali knowledge base.
Per Zendesk, le knowledge base di Amazon Connect non elaborano eliminazioni fisse o archivi di articoli. È necessario annullare la pubblicazione degli articoli in Zendesk per rimuoverli dalla knowledge base.
Per Microsoft SharePoint Online, puoi selezionare un massimo di 10 cartelle.
Amazon Connect aggiunge automaticamente un `AmazonConnectEnabled:True` tag alle risorse dell'agente Connect AI associate alla tua istanza Amazon Connect, come una knowledge base e un assistente. Lo fa per autorizzare l'accesso dalle risorse degli agenti Amazon Connect a Connect AI. Questa azione è il risultato del controllo degli accessi basato su tag nella policy gestita del ruolo collegato al servizio Amazon Connect. Per ulteriori informazioni, consulta [Autorizzazioni del ruolo collegato ai servizi per Amazon Connect](connect-slr.md#slr-permissions).
## Passaggio 4: configura il flusso per gli agenti Connect AI
1. Aggiungi un blocco [Assistente Connect](connect-assistant-block.md) al tuo flusso. Il blocco associa un dominio Connect AI agents al contatto corrente. Ciò consente di visualizzare informazioni da un dominio specifico, in base a criteri relativi al contatto.
Se scegli di [personalizzare](customize-connect-ai-agents.md) l'esperienza, creerai invece una Lambda e poi utilizzerai un [Funzione AWS Lambda ](invoke-lambda-function-block.md) blocco per aggiungerla ai flussi.
1. Per utilizzare gli agenti Connect AI con le chiamate, devi abilitare l'analisi Contact Lens conversazionale nel flusso aggiungendo un [Set recording and analytics behavior (Imposta comportamento registrazione e analisi)](set-recording-behavior.md) blocco configurato per l'analisi Contact Lens conversazionale in tempo reale. La sezione del flusso in cui viene aggiunto il blocco [Set recording and analytics behavior (Imposta comportamento registrazione e analisi)](set-recording-behavior.md) non è importante.
## Cosa succede se dispongo di più basi di conoscenza?
È possibile configurare l'agente di orchestrazione per utilizzare più knowledge base [configurando](https://docs.aws.amazon.com/connect/latest/adminguide/multiple-knowledge-base-setup-and-content-segmentation.html) più strumenti di recupero.
## Data dell'ultimo aggiornamento della knowledge base
Per confermare la data e l'ora dell'ultimo aggiornamento della knowledge base (ovvero una modifica dei contenuti disponibili), utilizza l'API come riferimento. [GetKnowledgeBase](https://docs.aws.amazon.com/amazon-q-connect/latest/APIReference/API_GetKnowledgeBase.html)`lastContentModificationTime`
## Servizio di inferenza tra Regioni
Gli agenti Connect AI utilizzano [l'inferenza interregionale](https://docs.aws.amazon.com/bedrock/latest/userguide/cross-region-inference.html) per selezionare automaticamente la AWS regione ottimale per l'elaborazione dei dati, migliorando l'esperienza del cliente massimizzando le risorse disponibili e la disponibilità del modello. Se non desideri che i tuoi dati vengano elaborati in una Regione diversa da quella selezionata, puoi contattare il Supporto AWS .
**Nota**
Sebbene i prompt personalizzati esistenti continueranno a utilizzare l’inferenza tra Regioni, suggeriamo di passare ai modelli più recenti supportati per sfruttare le funzionalità di inferenza tra Regioni. Puoi contattare il Supporto AWS per ricevere assistenza sulla migrazione dei prompt esistenti.