Intégrer Amazon Q dans Connect à l'aide de step-by-step guides - Amazon Connect
Étape 1 : identifier les ressources que vous souhaitez intégrerÉtape 2 : associer le step-by-step guide au contenu

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égrer Amazon Q dans Connect à l'aide de step-by-step guides

Pour aider les agents à trouver des solutions plus rapidement, vous pouvez associer des step-by-step guides au contenu de la base de connaissances, tel que des articles de connaissances. Ensuite, lorsqu'Amazon Q in Connect fournit une solution recommandée à un agent, il lui donne é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 :

  • 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'ListKnowledgeBasesAPI 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.

Obtenir l’ID du contenu

Pour répertorier les ressources de contenu de la base de connaissances, vous pouvez appeler l'ListContentsAPI 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.

Obtenez le flowARN contenu du 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.

  2. Sur la page Flux, choisissez le step-by-step guide pour l'ouvrir dans le concepteur de flux.

  3. Dans le concepteur de flux, choisissez À propos de ce flux, puis Afficher l’ARN.

  4. 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.

    Vous utiliserez le flowARN à l’Étape 2.

AWS CLI

  1. Vous pouvez appeler l'ListInstancesAPI 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.

  2. Vous pouvez appeler l'ListContactFlowsAPI 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-leflowARN. Vous utiliserez le flowARN à l’Étape 2.

É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'CreateContentAssociationAPI 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'ListContentAssociationsAPI 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.

  • Amazon Q in Connect - Afficher : 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.

    Note

    Pour utiliser Amazon Q in Connect avec les appels, il est nécessaire d’activer l’analytique conversationnelle Contact Lens. L’analytique conversationnelle Contact Lens en temps réel est utilisée pour recommander du contenu en rapport avec les problèmes des clients détectés pendant l’appel en cours.

    L’analytique conversationnelle Contact Lens n’est pas nécessaire pour utiliser Amazon Q in Connect avec des chats ou des e-mails, ni pour utiliser Amazon Q in Connect en libre-service.

  • 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.