Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Integre los agentes de Connect AI con step-by-step guías
Para ayudar a los agentes a encontrar soluciones con mayor rapidez, puedes asociar las [step-by-step guías](step-by-step-guided-experiences.md) al contenido de la base de conocimientos, como los artículos de conocimiento. Luego, cuando los agentes de Connect AI proporcionan una solución recomendada a un agente, también les ofrece la opción de iniciar la step-by-step guía que asociaste al contenido.
En este tema se explica cómo asociar las step-by-step guías con el contenido de la base de conocimientos.
## Paso 1: identificar los recursos que desea integrar
El primer paso consiste en recopilar la información necesaria para ejecutar el comando de integración en el [paso 2: asociar la step-by-step guía al contenido de la base de conocimientos](#associate-guide-content):
+ El ID de la base de conocimientos que contiene el recurso de contenido que desea asociar a step-by-step las guías.
+ El ID del contenido de la base de conocimientos.
+ El ARN de la step-by-step guía que desea asociar al contenido.
En las secciones siguientes se explica cómo obtener esta información.
### Cómo obtener el ID de la base de conocimientos
Para obtener el ID de la base de conocimientos que desea asociar a las step-by-step guías, puede llamar a la [ListKnowledgeBases](https://docs.aws.amazon.com/connect/latest/APIReference/API_amazon-q-connect_ListKnowledgeBases.html)API o ejecutar el comando `list-knowledge-bases` CLI.
A continuación, se muestra un comando `list-knowledge-bases` de ejemplo que muestra todas las bases de conocimiento:
```
aws qconnect list-knowledge-bases
```
Identifique la base de conocimientos que contiene los recursos de contenido que desea asociar. Copie y guarde el `knowledgeBaseId`. Lo necesitará en el [Paso 2](#associate-guide-content).
### Cómo obtener el ID del contenido
Para enumerar los recursos de contenido en la base de conocimientos, puede llamar a la [ListContents](https://docs.aws.amazon.com/connect/latest/APIReference/API_amazon-q-connect_ListContents.html)API o ejecutar el comando `list-contents` CLI.
A continuación se muestra un ejemplo del comando `list-contents` que muestra los recursos de contenido y su ID de contenido.
```
aws qconnect list-contents \
--knowledge-base-id {{knowledgeBaseId}}
```
Identifique qué recursos de contenido desea asociar a una step-by-step guía. Copie y guarde el `contentId`. Lo necesitará en el [Paso 2](#associate-guide-content).
### Obtenga la información `flowARN` de la step-by-step guía
Debe obtener `flowARN` la step-by-step guía que desea asociar al contenido. Hay dos formas de obtenerlo`flowARN`: mediante el sitio web de Connect Customer administración o la CLI.
------
#### [ Connect Customer admin website ]
1. En el sitio web de Connect Customer administración, en el menú de navegación, selecciona **Routing**, **Flows**.
1. En la página **Flujos**, elige la step-by-step guía para abrirla en el diseñador de flujos.
1. En el diseñador de flujos, elija **Acerca de este flujo** y, a continuación, elija **Ver ARN**.
1. Copie y guarde el `flowARN`. Es la cadena completa, como se muestra en la siguiente imagen.
Utilizará el `flowARN` en el [Paso 2](#associate-guide-content).
------
#### [ AWS CLI ]
1. Puede llamar a la [ListInstances](https://docs.aws.amazon.com/connect/latest/APIReference/API_ListInstances.html)API Amazon Connect o ejecutar el comando `list-instances` CLI para obtener `instanceId` la instancia que quiere usar.
A continuación, se muestra un comando `list-instances` de ejemplo:
```
aws connect list-instances
```
Copie y guarde el `instanceId`.
1. Puede llamar a la [ListContactFlows](https://docs.aws.amazon.com/connect/latest/APIReference/API_ListContactFlows.html)API Amazon Connect o ejecutar el comando `list-contact-flows` CLI para determinar la step-by-step guía que debe utilizarse.
A continuación, se muestra un `list-contact-flows` comando de ejemplo que muestra todos los flujos y step-by-step guías, así como sus respectivos flujos`flowARNs`:
```
aws connect list-contact-flows \
--instance-id {{instanceId}}
```
Identifique la step-by-step guía que desee asociar a la base de conocimientos y cópiela y guárdela`flowARN`. Utilizará el `flowARN` en el [Paso 2](#associate-guide-content).
------
## Paso 2: Asocie la step-by-step guía al contenido de la base de conocimientos
### Creación de la asociación de contenido
Para completar este paso necesita los parámetros `knowledgeBaseId`, `contentId` y `flowARN` que obtuvo en el Paso 1.
Puede llamar a la [CreateContentAssociation](https://docs.aws.amazon.com/connect/latest/APIReference/API_amazon-q-connect_CreateContentAssociation.html)API o ejecutar el comando `create-content-association` CLI para vincular el recurso de contenido y la step-by-step guía.
+ Solo puede crear una asociación de contenido para cada recurso de contenido.
+ Puede asociar una step-by-step guía a varios recursos de contenido.
A continuación se muestra un ejemplo de `create-content-association` comando para crear una asociación de contenido entre el recurso de contenido y una step-by-step guía:
```
aws qconnect create-content-association \
--knowledge-base-id {{knowledgeBaseId}} \
--content-id {{contentId}} \
--association-type AMAZON_CONNECT_GUIDE \
--association '{"amazonConnectGuideAssociation":{"flowId":"{{flowArn}}"}}'
```
Por ejemplo, el comando podría parecerse al siguiente ejemplo cuando se añaden valores:
```
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}}"}}'
```
### Confirmación de que existe la asociación de contenido
Puede llamar a la [ListContentAssociations](https://docs.aws.amazon.com/connect/latest/APIReference/API_amazon-q-connect_ListContentAssociations.html)API o ejecutar el comando `list-content-associations` CLI para enumerar todas las asociaciones de contenido del contenido especificado.
A continuación, se muestra un comando `list-content-associations` de ejemplo que devuelve una lista de asociaciones de contenido para que pueda comprobar que la asociación que ha creado existe:
```
aws qconnect list-content-associations \
--knowledge-base-id {{knowledgebaseId}} \
--content-id {{contentId}}
```
Por ejemplo, el comando podría parecerse al siguiente ejemplo cuando se añaden valores:
```
aws qconnect list-content-associations \
--knowledge-base-id {{00000000-0000-0000-0000-000000000000}} \
--content-id {{11111111-1111-1111-1111-111111111111}}
```
### Asigne permisos para que los agentes puedan ver las recomendaciones y las step-by-step guías
Asigne los siguientes permisos de perfil de seguridad de **Agent Applications** a los agentes para que puedan ver el contenido de la base de conocimientos y las step-by-step guías.
+ **Connect AI agents - Ver**: permite a los agentes buscar y ver contenido. También pueden recibir recomendaciones automáticas durante las llamadas si se ha habilitado el análisis de conversación de Contact Lens.
+ **Vistas personalizadas: Acceso**: permite a los agentes ver las step-by-step guías en su espacio de trabajo.
Para obtener información acerca de cómo agregar más permisos a un perfil de seguridad existente, consulte [Actualización de los perfiles de seguridad predeterminados en Amazon Connect](update-security-profiles.md).