Integre o Amazon Q no Connect com step-by-step guias

Para ajudar os agentes a encontrar soluções mais rapidamente, você pode associar step-by-step guias ao conteúdo da base de conhecimento, como artigos de conhecimento. Então, quando o Amazon Q in Connect fornece uma solução recomendada para um agente, ele também oferece a opção de iniciar o step-by-step guia que você associou ao conteúdo.

Este tópico explica como associar step-by-step guias ao conteúdo da base de conhecimento.

Etapa 1: identificar os recursos que você deseja integrar

A primeira etapa é reunir as informações necessárias para executar o comando de integração na Etapa 2: Associar o step-by-step guia ao conteúdo da base de conhecimento:

• O ID da base de conhecimento que contém o recurso de conteúdo que você deseja associar aos step-by-step guias.

• O ID do recurso de conteúdo na base de conhecimento.

• O ARN do step-by-step guia que você deseja associar ao conteúdo.

As seções a seguir explicam como obter essas informações.

Obtenha o ID da base de conhecimento

Para obter a ID da base de conhecimento que você deseja associar aos step-by-step guias, você pode chamar ListKnowledgeBasesAPIou executar o list-knowledge-bases CLI comando.

Veja a seguir um exemplo de list-knowledge-bases comando que lista todas as bases de conhecimento:

aws qconnect list-knowledge-bases

Identifique a base de conhecimento que contém os recursos de conteúdo que você deseja associar. Copie e salve knowledgeBaseId o. Você o usará na Etapa 2.

Obtenha o ID do conteúdo

Para listar os recursos de conteúdo na base de conhecimento, você pode chamar ListContentsAPIou executar o list-contents CLI comando.

Veja a seguir um exemplo de list-contents comando que lista os recursos de conteúdo e seu ID de conteúdo.

aws qconnect list-contents \
--knowledge-base-id knowledgeBaseId

Identifique quais recursos de conteúdo você deseja associar a um step-by-step guia. Copie e salve contentId o. Você o usará na Etapa 2.

Obtenha flowARN o step-by-step guia completo

Você precisa obter flowARN o step-by-step guia que deseja associar ao conteúdo. Há duas maneiras de obter oflowARN: use o site de Amazon Connect administração ou CLI o.

Amazon Connect admin website

1. No site do Amazon Connect administrador, no menu de navegação, escolha Roteamento, Fluxos.

2. Na página Fluxos, escolha a step-by-step guia para abri-la no designer de fluxo.

3. No designer de fluxo, escolha Sobre esse fluxo e escolha Exibir ARN.

4. Copie e salve flowARN o. É a string inteira, conforme mostrado na imagem a seguir.

   

   Você usará o flowARN na Etapa 2.

AWS CLI

1. Você pode chamar o Amazon Connect ListInstancesAPIou executar o list-instances CLI instanceId comando para obter a instância que deseja usar.

   Veja a seguir um exemplo de list-instances comando:

   aws connect list-instances

   Copie e salve instanceId o.

2. Você pode ligar para o Amazon Connect ListContactFlowsAPIou executar o list-contact-flows CLI comando para determinar o step-by-step guia a ser usado.

   Veja a seguir um exemplo de list-contact-flows comando que lista todos os fluxos e step-by-step guias, e seusflowARNs:

   aws connect list-contact-flows \
   --instance-id instanceId

   Identifique o step-by-step guia que você deseja associar à base de conhecimento, copie e salve-oflowARN. Você usará o flowARN na Etapa 2.

Etapa 2: associar o step-by-step guia ao conteúdo da base de conhecimento

Crie a associação de conteúdo

Para concluir esta etapaknowledgeBaseId, você precisa do contentId e flowARN obtido na Etapa 1.

Você pode chamar o comando CreateContentAssociationAPIou executar o create-content-association CLI comando para vincular o recurso de conteúdo e o step-by-step guia.

• Você pode criar somente uma associação de conteúdo para cada recurso de conteúdo.

• Você pode associar um step-by-step guia a vários recursos de conteúdo.

Veja a seguir um exemplo de create-content-association comando para criar uma associação de conteúdo entre o recurso de conteúdo e um step-by-step guia:

aws qconnect create-content-association \
--knowledge-base-id knowledgeBaseId \
--content-id contentId \
--association-type AMAZON_CONNECT_GUIDE \
--association '{"amazonConnectGuideAssociation":{"flowId":"flowArn"}}'

Por exemplo, o comando pode se parecer com o exemplo a seguir quando os valores são adicionados:

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"}}' 

Confirme se a associação de conteúdo existe

Você pode chamar ListContentAssociationsAPIou executar o list-content-associations CLI comando para listar todas as associações de conteúdo para o conteúdo especificado.

Veja a seguir um exemplo de list-content-associations comando que retorna uma lista de associações de conteúdo para que você possa verificar se a associação criada existe:

aws qconnect list-content-associations \
--knowledge-base-id knowledgebaseId \
--content-id contentId

Por exemplo, o comando pode se parecer com o exemplo a seguir quando os valores são adicionados:

aws qconnect list-content-associations \
--knowledge-base-id 00000000-0000-0000-0000-000000000000 \
--content-id 11111111-1111-1111-1111-111111111111

Atribua permissões para que os agentes possam ver recomendações e step-by-step guias

Atribua as seguintes permissões de perfil de segurança dos Aplicativos do Agente aos agentes para que eles possam visualizar o conteúdo da base de conhecimento e os step-by-step guias.

• Amazon Q in Connect - View: permite que os agentes pesquisem e visualizem conteúdo. Eles também podem receber recomendações automáticas durante as chamadas se o Contact Lens estiver habilitado. O Contact Lens não é necessário para usar o Amazon Q com chats.

• Visualizações personalizadas - Acesso: permite que os agentes vejam step-by-step guias no espaço de trabalho do agente.

Para obter informações sobre como adicionar mais permissões a um perfil de segurança existente, consulte Atualize perfis de segurança no Amazon Connect.