As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Integre agentes do Connect AI com step-by-step guias
Para ajudar os agentes a encontrar soluções com mais rapidez, você pode associar [step-by-step guias](step-by-step-guided-experiences.md) ao conteúdo da base de conhecimento, como artigos de conhecimento. Então, quando os agentes do Connect AI fornecem 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: identifique 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](#associate-guide-content):
+ 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 do 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 ter essas informações.
### Obter o ID da base de conhecimento
Para obter o ID da base de conhecimento que você deseja associar aos step-by-step guias, você pode chamar a [ListKnowledgeBases](https://docs.aws.amazon.com/connect/latest/APIReference/API_amazon-q-connect_ListKnowledgeBases.html)API ou executar o comando da `list-knowledge-bases` CLI.
Veja a seguir um exemplo de comando `list-knowledge-bases` que lista todas as bases de conhecimento:
```
aws qconnect list-knowledge-bases
```
Identifique a base de conhecimento que contém os recursos do conteúdo que você deseja associar. Copie e salve o `knowledgeBaseId`. Você vai usá-lo na [Etapa 2](#associate-guide-content).
### Obter o ID do conteúdo
Para listar os recursos de conteúdo na base de conhecimento, você pode chamar a [ListContents](https://docs.aws.amazon.com/connect/latest/APIReference/API_amazon-q-connect_ListContents.html)API ou executar o comando da `list-contents` CLI.
Veja a seguir um exemplo de comando `list-contents` que lista os recursos do conteúdo e o respectivo ID.
```
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 o `contentId`. Você vai usá-lo na [Etapa 2](#associate-guide-content).
### 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 o`flowARN`: usar o site de Connect Customer administração ou a CLI.
------
#### [ Connect Customer admin website ]
1. No site do Connect Customer administrador, no menu de navegação, escolha **Roteamento**, **Fluxos**.
1. Na página **Fluxos**, escolha a step-by-step guia para abri-la no designer de fluxo.
1. No designer de fluxo, escolha **Sobre esse fluxo** e escolha **Visualizar ARN**.
1. Copie e salve o `flowARN`. É a string inteira, conforme mostrado na imagem a seguir.
Você vai usar o `flowARN` na [Etapa 2](#associate-guide-content).
------
#### [ AWS CLI ]
1. Você pode chamar a [ListInstances](https://docs.aws.amazon.com/connect/latest/APIReference/API_ListInstances.html)API Amazon Connect ou executar o comando da `list-instances` CLI para obter a `instanceId` instância que deseja usar.
Veja a seguir um exemplo de comando `list-instances`:
```
aws connect list-instances
```
Copie e salve o `instanceId`.
1. Você pode chamar a [ListContactFlows](https://docs.aws.amazon.com/connect/latest/APIReference/API_ListContactFlows.html)API do Amazon Connect ou executar o comando da `list-contact-flows` CLI 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 seus`flowARNs`:
```
aws connect list-contact-flows \
--instance-id {{instanceId}}
```
Identifique o step-by-step guia que você deseja associar à base de conhecimento, copie e salve-o`flowARN`. Você vai usar o `flowARN` na [Etapa 2](#associate-guide-content).
------
## Etapa 2: associar o step-by-step guia ao conteúdo da base de conhecimento
### Criar a associação de conteúdo
Para concluir esta etapa, você precisa do `knowledgeBaseId`, `contentId` e `flowARN` obtidos na Etapa 1.
Você pode chamar a [CreateContentAssociation](https://docs.aws.amazon.com/connect/latest/APIReference/API_amazon-q-connect_CreateContentAssociation.html)API ou executar o comando `create-content-association` CLI para vincular o recurso de conteúdo e step-by-step o 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 perfil pode ter esta aparência 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}}"}}'
```
### Confirmar se a associação de conteúdo existe
Você pode chamar a [ListContentAssociations](https://docs.aws.amazon.com/connect/latest/APIReference/API_amazon-q-connect_ListContentAssociations.html)API ou executar o comando da `list-content-associations` CLI para listar todas as associações de conteúdo para o conteúdo especificado.
Veja a seguir um exemplo de comando `list-content-associations` 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 perfil pode ter esta aparência 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.
+ **Connect AI agents - View**: permite que os agentes pesquisem e visualizem conteúdo. Eles também podem receber recomendações automáticas durante as chamadas se a análise de conversação do Contact Lens estiver habilitada.
+ **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 [Atualizar perfis de segurança no Amazon Connect](update-security-profiles.md).