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à.
# Integra gli agenti Connect AI con step-by-step le guide
Per aiutare gli agenti a trovare soluzioni più rapidamente, puoi associare [step-by-step le guide](step-by-step-guided-experiences.md) ai contenuti della knowledge base, come gli articoli della knowledge base. Quindi, quando gli agenti di Connect AI forniscono una soluzione consigliata a un agente, gli offre anche la possibilità di avviare la step-by-step guida associata al contenuto.
Questo argomento spiega come associare step-by-step le guide ai contenuti della knowledge base.
## Fase 1: identificare le risorse da integrare
Il primo passaggio consiste nel raccogliere le informazioni necessarie per eseguire il comando di integrazione nel [Passaggio 2: Associare la step-by-step guida al contenuto della knowledge base](#associate-guide-content):
+ L'ID della knowledge base che contiene la risorsa di contenuto da associare alle step-by-step guide.
+ L’ID dell’origine del contenuto nella knowledge base.
+ L'ARN della step-by-step guida che desideri associare al contenuto.
Nelle sezioni seguenti viene illustrato come ottenere queste informazioni.
### Ottenere l’ID della knowledge base
Per ottenere l'ID della knowledge base che desideri associare alle step-by-step guide, puoi chiamare l'[ListKnowledgeBases](https://docs.aws.amazon.com/connect/latest/APIReference/API_amazon-q-connect_ListKnowledgeBases.html)API o eseguire il comando `list-knowledge-bases` CLI.
Di seguito è riportato un comando di esempio `list-knowledge-bases` che elenca tutte le knowledge base:
```
aws qconnect list-knowledge-bases
```
Identifica la knowledge base contenente le risorse di contenuto che desideri associare. Copia e salva il `knowledgeBaseId`. Servirà nella [Fase 2](#associate-guide-content).
### Ottenere l’ID del contenuto
Per elencare le risorse di contenuto nella knowledge base, puoi chiamare l'[ListContents](https://docs.aws.amazon.com/connect/latest/APIReference/API_amazon-q-connect_ListContents.html)API o eseguire il comando `list-contents` CLI.
Di seguito è riportato un comando di esempio `list-contents` che elenca le risorse del contenuto e il relativo ID del contenuto.
```
aws qconnect list-contents \
--knowledge-base-id {{knowledgeBaseId}}
```
Identifica quali risorse di contenuto desideri associare a una step-by-step guida. Copia e salva il `contentId`. Servirà nella [Fase 2](#associate-guide-content).
### Scarica `flowARN` la step-by-step guida
È necessario scaricare `flowARN` la step-by-step guida che si desidera associare al contenuto. Esistono due modi per ottenerlo`flowARN`: utilizzare il sito Web di Connect Customer amministrazione o la CLI.
------
#### [ Connect Customer admin website ]
1. **Nel sito web di Connect Customer amministrazione, nel menu di navigazione scegli **Routing, Flows**.**
1. Nella pagina **Flows**, scegli la step-by-step guida per aprirla nel Flow Designer.
1. Nel designer di flussi, scegli **Informazioni su questo flusso**, quindi **Visualizza ARN**.
1. Copia e salva il `flowARN`. È l’intera stringa, come mostrato nell’immagine seguente.
`flowARN` servirà nella [Fase 2](#associate-guide-content).
------
#### [ AWS CLI ]
1. Puoi chiamare l'[ListInstances](https://docs.aws.amazon.com/connect/latest/APIReference/API_ListInstances.html)API Amazon Connect o eseguire il comando `list-instances` CLI per ottenere l'`instanceId`istanza che desideri utilizzare.
Di seguito è riportato un comando `list-instances` di esempio.
```
aws connect list-instances
```
Copia e salva il `instanceId`.
1. Puoi chiamare l'[ListContactFlows](https://docs.aws.amazon.com/connect/latest/APIReference/API_ListContactFlows.html)API Amazon Connect o eseguire il comando `list-contact-flows` CLI per determinare la step-by-step guida da utilizzare.
Di seguito è riportato un `list-contact-flows` comando di esempio che elenca tutti i flussi e le step-by-step guide e i relativi`flowARNs`:
```
aws connect list-contact-flows \
--instance-id {{instanceId}}
```
Identificate la step-by-step guida che desiderate associare alla knowledge base, copiatela e salvatela`flowARN`. `flowARN` servirà nella [Fase 2](#associate-guide-content).
------
## Fase 2: Associare la step-by-step guida al contenuto della knowledge base
### Creare l’associazione del contenuto
Per completare questo passaggio è necessario il `knowledgeBaseId`, il `contentId` e il `flowARN` che hai ottenuto nella Fase 1.
Puoi chiamare l'[CreateContentAssociation](https://docs.aws.amazon.com/connect/latest/APIReference/API_amazon-q-connect_CreateContentAssociation.html)API o eseguire il comando `create-content-association` CLI per collegare la risorsa di contenuto e step-by-step la guida.
+ È possibile creare una sola associazione di contenuto per ogni risorsa di contenuto.
+ È possibile associare una step-by-step guida a più risorse di contenuto.
Di seguito è riportato un `create-content-association` comando di esempio per creare un'associazione di contenuto tra la risorsa di contenuto e una step-by-step guida:
```
aws qconnect create-content-association \
--knowledge-base-id {{knowledgeBaseId}} \
--content-id {{contentId}} \
--association-type AMAZON_CONNECT_GUIDE \
--association '{"amazonConnectGuideAssociation":{"flowId":"{{flowArn}}"}}'
```
Ad esempio, il comando potrebbe avere il seguente aspetto quando vengono aggiunti valori:
```
aws qconnect create-content-association \
--knowledge-base-id {{00000000-0000-0000-0000-000000000000}} \
--content-id {{11111111-1111-1111-1111-111111111111}} \
--association-type AMAZON_CONNECT_GUIDE \
--association '{"amazonConnectGuideAssociation":{"flowId":"arn:aws:connect:{{us-west-2}}:{{111111111111}}:instance/{{22222222-2222-2222-2222-222222222222}}/contact-flow/{{00711358-cd68-441d-8301-2e847ca80c82}}"}}'
```
### Conferma che l’associazione di contenuti esiste
Puoi chiamare l'[ListContentAssociations](https://docs.aws.amazon.com/connect/latest/APIReference/API_amazon-q-connect_ListContentAssociations.html)API o eseguire il comando `list-content-associations` CLI per elencare tutte le associazioni di contenuto per il contenuto specificato.
Di seguito è riportato un comando di esempio `list-content-associations` che restituisce un elenco di associazioni di contenuto in modo da poter verificare l’esistenza dell’associazione creata:
```
aws qconnect list-content-associations \
--knowledge-base-id {{knowledgebaseId}} \
--content-id {{contentId}}
```
Ad esempio, il comando potrebbe avere il seguente aspetto quando vengono aggiunti valori:
```
aws qconnect list-content-associations \
--knowledge-base-id {{00000000-0000-0000-0000-000000000000}} \
--content-id {{11111111-1111-1111-1111-111111111111}}
```
### Assegna le autorizzazioni in modo che gli agenti possano visualizzare consigli e guide step-by-step
Assegna le seguenti autorizzazioni relative al profilo di sicurezza di **Agent Applications** agli agenti in modo che possano visualizzare il contenuto della knowledge base e le guide. step-by-step
+ **Connect AI Agents - View**: consente agli agenti di cercare e visualizzare contenuti. Possono anche ricevere suggerimenti automatici durante le chiamate se l’analisi conversazionale Contact Lens è abilitata.
+ **Visualizzazioni personalizzate - Accesso**: consente agli agenti di visualizzare le step-by-step guide nell'area di lavoro degli agenti.
Per informazioni su come aggiungere altre autorizzazioni a un profilo di sicurezza esistente, consulta [Aggiornare i profili di sicurezza in Amazon Connect](update-security-profiles.md).