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 grâce à des guides étape par étape
Pour aider les agents à trouver des solutions plus rapidement, vous pouvez associer des [guides pas à pas](step-by-step-guided-experiences.md) au contenu de la base de connaissances, tels que des articles de connaissances. Ensuite, lorsque les agents Connect AI fournissent une solution recommandée à un agent, ils ont également la possibilité de démarrer le guide étape par étape que vous avez associé au contenu.
Cette rubrique explique comment associer des guides pas à pas 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 guide pas à pas au contenu de la base de connaissances](#associate-guide-content) :
+ L’ID de la base de connaissances qui contient la ressource de contenu que vous souhaitez associer à des guides pas à pas.
+ L’ID de la ressource de contenu dans la base de connaissances.
+ L’ARN du guide pas à pas 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 guides étape par étape, 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 guide pas à pas. Copiez et enregistrez le `contentId`. Vous en aurez besoin à l’[Étape 2](#associate-guide-content).
### Téléchargez le `FlowArn` du guide étape par étape
Vous devez obtenir le `flowARN` du guide pas à pas que vous souhaitez associer au contenu. Vous pouvez l'obtenir de deux manières `flowARN` : utilisez le site Web Connect Customer d'administration ou la CLI.
------
#### [ Connect Customer admin website ]
1. Sur le site Web de l' Connect Customer administrateur, dans le menu de navigation, choisissez **Routing**, **Flows**.
1. Sur la page **Flux**, choisissez le guide pas à pas 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.
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 Connect Customer 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 Connect Customer ou exécuter la commande `list-contact-flows` CLI pour déterminer le guide étape par étape à utiliser.
Voici un exemple de commande `list-contact-flows` qui répertorie tous les flux et les guides pas à pas, ainsi que leurs `flowARNs` :
```
aws connect list-contact-flows \
--instance-id {{instanceId}}
```
Identifiez le guide pas à pas que vous souhaitez associer à la base de connaissances, copiez-le et enregistrez son `flowARN`. Vous utiliserez le `flowARN` à l’[Étape 2](#associate-guide-content).
------
## Étape 2 : associer le guide pas à pas 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 guide étape par étape.
+ Vous ne pouvez créer qu’une seule association de contenu pour chaque ressource de contenu.
+ Vous pouvez associer un guide pas à pas à plusieurs ressources de contenu.
Voici un exemple de commande `create-content-association` permettant de créer une association de contenu entre la ressource de contenu et un guide pas à pas :
```
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}}
```
### Attribuer des autorisations afin que les agents puissent consulter les recommandations et les guides pas à pas
Attribuez les autorisations de profil de sécurité d’**applications d’agents** suivantes aux agents afin qu’ils puissent consulter le contenu de la base de connaissances et les guides pas à pas.
+ **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 des guides pas à pas dans leur espace de travail de l’agent.
Pour en savoir plus sur l’ajout d’autorisations à un profil de sécurité existant, consultez [Mettre à jour les profils de sécurité dans Connect Customer](update-security-profiles.md).