Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Intégrez les agents Connect AI à des step-by-step guides
Pour aider les agents à trouver des solutions plus rapidement, vous pouvez associer des [step-by-step guides](step-by-step-guided-experiences.md) au contenu de la base de connaissances, tel que des articles de connaissances. Ensuite, lorsque les agents Connect AI fournissent une solution recommandée à un agent, ils lui offrent également la possibilité de démarrer le step-by-step guide que vous avez associé au contenu.
Cette rubrique explique comment associer des step-by-step guides au contenu de la base de connaissances.
## Étape 1 : identifier les ressources que vous souhaitez intégrer
La première étape consiste à rassembler les informations nécessaires pour exécuter la commande d'intégration à l'[étape 2 : associer le step-by-step guide au contenu de la base de connaissances](#associate-guide-content) :
+ ID de la base de connaissances qui contient la ressource de contenu que vous souhaitez associer aux step-by-step guides.
+ L’ID de la ressource de contenu dans la base de connaissances.
+ L'ARN du step-by-step guide que vous souhaitez associer au contenu.
Les sections suivantes expliquent comment obtenir ces informations.
### Obtenir l’ID de la base de connaissances
Pour obtenir l'ID de la base de connaissances que vous souhaitez associer aux step-by-step guides, vous pouvez appeler l'[ListKnowledgeBases](https://docs.aws.amazon.com/connect/latest/APIReference/API_amazon-q-connect_ListKnowledgeBases.html)API ou exécuter la commande `list-knowledge-bases` CLI.
Voici un exemple de commande `list-knowledge-bases` répertoriant toutes les bases de connaissances :
```
aws qconnect list-knowledge-bases
```
Identifiez la base de connaissances qui contient les ressources de contenu que vous souhaitez associer. Copiez et enregistrez le `knowledgeBaseId`. Vous en aurez besoin à l’[Étape 2](#associate-guide-content).
### Obtenir l’ID du contenu
Pour répertorier les ressources de contenu de la base de connaissances, vous pouvez appeler l'[ListContents](https://docs.aws.amazon.com/connect/latest/APIReference/API_amazon-q-connect_ListContents.html)API ou exécuter la commande `list-contents` CLI.
Voici un exemple de commande `list-contents` répertoriant les ressources de contenu et leur ID de contenu.
```
aws qconnect list-contents \
--knowledge-base-id knowledgeBaseId
```
Identifiez les ressources de contenu que vous souhaitez associer à un step-by-step guide. Copiez et enregistrez le `contentId`. Vous en aurez besoin à l’[Étape 2](#associate-guide-content).
### Téléchargez `flowARN` le step-by-step guide
Vous devez obtenir `flowARN` le step-by-step guide que vous souhaitez associer au contenu. Vous pouvez l'obtenir de deux manières `flowARN` : utilisez le site Web Amazon Connect d'administration ou la CLI.
------
#### [ Amazon Connect admin website ]
1. Sur le site Web de l' Amazon Connect administrateur, dans le menu de navigation, choisissez **Routing**, **Flows**.
1. Sur la page **Flux**, choisissez le step-by-step guide pour l'ouvrir dans le concepteur de flux.
1. Dans le concepteur de flux, choisissez **À propos de ce flux**, puis **Afficher l’ARN**.
1. Copiez et enregistrez le `flowARN`. Il s’agit de la chaîne entière, comme illustré dans l’image suivante.
![\[Boîte de dialogue affichant le FlowArn complet (Amazon Resource Name) pour un step-by-step guide, indiquant l'identifiant unique nécessaire à l'intégration.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/qic-flow-id.png)
Vous utiliserez le `flowARN` à l’[Étape 2](#associate-guide-content).
------
#### [ AWS CLI ]
1. Vous pouvez appeler l'[ListInstances](https://docs.aws.amazon.com/connect/latest/APIReference/API_ListInstances.html)API Amazon Connect ou exécuter la commande `list-instances` CLI pour obtenir `instanceId` l'instance que vous souhaitez utiliser.
Voici un exemple de commande `list-instances` :
```
aws connect list-instances
```
Copiez et enregistrez le `instanceId`.
1. Vous pouvez appeler l'[ListContactFlows](https://docs.aws.amazon.com/connect/latest/APIReference/API_ListContactFlows.html)API Amazon Connect ou exécuter la commande `list-contact-flows` CLI pour déterminer le step-by-step guide à utiliser.
Voici un exemple de `list-contact-flows` commande répertoriant tous les flux et step-by-step guides, ainsi que leurs `flowARNs` :
```
aws connect list-contact-flows \
--instance-id instanceId
```
Identifiez le step-by-step guide que vous souhaitez associer à la base de connaissances, copiez-le et enregistrez-le`flowARN`. Vous utiliserez le `flowARN` à l’[Étape 2](#associate-guide-content).
------
## Étape 2 : associer le step-by-step guide au contenu de la base de connaissances
### Création de l’association de contenu
Pour terminer cette étape, vous avez besoin du `knowledgeBaseId`, `contentId` et `flowARN` que vous avez obtenu à l’Étape 1.
Vous pouvez appeler l'[CreateContentAssociation](https://docs.aws.amazon.com/connect/latest/APIReference/API_amazon-q-connect_CreateContentAssociation.html)API ou exécuter la commande `create-content-association` CLI pour lier la ressource de contenu au step-by-step guide.
+ Vous ne pouvez créer qu’une seule association de contenu pour chaque ressource de contenu.
+ Vous pouvez associer un step-by-step guide à plusieurs ressources de contenu.
Voici un exemple de `create-content-association` commande permettant de créer une association de contenu entre la ressource de contenu et un step-by-step guide :
```
aws qconnect create-content-association \
--knowledge-base-id knowledgeBaseId \
--content-id contentId \
--association-type AMAZON_CONNECT_GUIDE \
--association '{"amazonConnectGuideAssociation":{"flowId":"flowArn"}}'
```
Par exemple, la commande peut ressembler à l’exemple suivant lorsque des valeurs sont ajoutées :
```
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"}}'
```
### Vérification de l’association de contenu
Vous pouvez appeler l'[ListContentAssociations](https://docs.aws.amazon.com/connect/latest/APIReference/API_amazon-q-connect_ListContentAssociations.html)API ou exécuter la commande `list-content-associations` CLI pour répertorier toutes les associations de contenu pour le contenu spécifié.
Voici un exemple de commande `list-content-associations` qui renvoie une liste d’associations de contenu afin que vous puissiez vérifier que l’association que vous avez créée existe :
```
aws qconnect list-content-associations \
--knowledge-base-id knowledgebaseId \
--content-id contentId
```
Par exemple, la commande peut ressembler à l’exemple suivant lorsque des valeurs sont ajoutées :
```
aws qconnect list-content-associations \
--knowledge-base-id 00000000-0000-0000-0000-000000000000 \
--content-id 11111111-1111-1111-1111-111111111111
```
### Attribuez des autorisations afin que les agents puissent consulter les recommandations et les step-by-step guides
Attribuez les autorisations de profil de sécurité des **applications d'agent** suivantes aux agents afin qu'ils puissent consulter le contenu de la base de connaissances et les step-by-step guides.
+ **Connect AI agents - View** : permet aux agents de rechercher et de consulter du contenu. Ils peuvent également recevoir des recommandations automatiques pendant les appels si l’analytique conversationnelle Contact Lens est activée.
+ **Vues personnalisées - Accès** : permet aux agents de consulter step-by-step des guides dans leur espace de travail.
Pour en savoir plus sur l’ajout d’autorisations à un profil de sécurité existant, consultez [Mise à jour de profils de sécurité dans Amazon Connect](update-security-profiles.md).