本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 将 Connect 人工智能代理与 step-by-step指南集成
为了帮助客服人员更快地获得解决方案，您可以将[step-by-step 指南](step-by-step-guided-experiences.md)与知识库内容（例如知识文章）关联起来。然后，当 Connect AI 代理向代理提供推荐的解决方案时，它还会为他们提供启动与内容关联的 step-by-step指南的选项。
本主题说明如何将 step-by-step指南与知识库内容相关联。
## 步骤 1：确定要集成的资源
第一步是收集在[步骤 2：将 step-by-step指南与知识库内容关联中](#associate-guide-content)运行集成命令所需的信息：
+ 包含您要与 step-by-step指南关联的内容资源的知识库的 ID。
+ 知识库中内容资源的 ID。
+ 您要与内容关联的 step-by-step指南的 ARN。
下文将介绍如何获取这些信息。
### 获取知识库 ID
要获取要与 step-by-step指南关联的知识库的 ID，可以调用 [ListKnowledgeBases](https://docs.aws.amazon.com/connect/latest/APIReference/API_amazon-q-connect_ListKnowledgeBases.html)API 或运行 `list-knowledge-bases` CLI 命令。
以下是一个列出所有知识库的 `list-knowledge-bases` 命令示例：
```
aws qconnect list-knowledge-bases
```
确定包含您要关联的内容资源的知识库。复制并保存 `knowledgeBaseId`。您将在[步骤 2](#associate-guide-content) 中使用它。
### 获取内容 ID
要在知识库中列出内容资源，可以调用 [ListContents](https://docs.aws.amazon.com/connect/latest/APIReference/API_amazon-q-connect_ListContents.html)API 或运行 `list-contents` CLI 命令。
以下是一个列出内容资源及其内容 ID 的 `list-contents` 命令示例。
```
aws qconnect list-contents \
--knowledge-base-id knowledgeBaseId
```
确定要与 step-by-step指南关联的内容资源。复制并保存 `contentId`。您将在[步骤 2](#associate-guide-content) 中使用它。
### 获取 step-by-step指南`flowARN`中的内容
您需要获取要`flowARN`与内容关联的 step-by-step指南。您可以通过两种方式获取`flowARN`：使用 Amazon Connect 管理网站或 CLI。
------
#### [ Amazon Connect admin website ]
1. 在 Amazon Connect 管理网站的导航菜单上，选择**路由**、**流程**。
1. 在 “**流程**” 页面上，选择要在流程设计器中将其打开的 step-by-step指南。
1. 在流设计器中，选择**关于流**，然后选择**查看 ARN**。
1. 复制并保存 `flowARN`。它是整个字符串，如下图所示。
![\[对话框显示 step-by-step指南的完整 FlowArn（亚马逊资源名称），显示集成所需的唯一标识符。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/qic-flow-id.png)
您将在[步骤 2 ](#associate-guide-content)中使用 `flowARN`。
------
#### [ AWS CLI ]
1. 您可以调用 Amazon Connect [ListInstances](https://docs.aws.amazon.com/connect/latest/APIReference/API_ListInstances.html)AP `list-instances` I 或运行 CLI 命令来获取要使用的实例。`instanceId`
以下是示例 `list-instances` 命令。
```
aws connect list-instances
```
复制并保存 `instanceId`。
1. 您可以调用 Amazon Connect [ListContactFlows](https://docs.aws.amazon.com/connect/latest/APIReference/API_ListContactFlows.html)AP `list-contact-flows` I 或运行 CLI 命令来确定要使用的 step-by-step指南。
以下是列出所有流程和 step-by-step指南的`list-contact-flows`命令示例，以及它们的`flowARNs`：
```
aws connect list-contact-flows \
--instance-id instanceId
```
确定要与知识库关联的 step-by-step指南，然后将其复制并保存`flowARN`。您将在[步骤 2 ](#associate-guide-content)中使用 `flowARN`。
------
## 步骤 2：将 step-by-step指南与知识库内容相关联
### 创建内容关联
要完成此步骤，您需要在步骤 1 中获得的 `knowledgeBaseId`、`contentId` 和 `flowARN`。
您可以调用 [CreateContentAssociation](https://docs.aws.amazon.com/connect/latest/APIReference/API_amazon-q-connect_CreateContentAssociation.html)API 或运行 `create-content-association` CLI 命令来链接内容资源和 step-by-step指南。
+ 您只能为每个内容资源创建一个内容关联。
+ 您可以将一个 step-by-step指南与多个内容资源相关联。
以下是在内容资源和 step-by-step指南之间创建内容关联的`create-content-association`命令示例：
```
aws qconnect create-content-association \
--knowledge-base-id knowledgeBaseId \
--content-id contentId \
--association-type AMAZON_CONNECT_GUIDE \
--association '{"amazonConnectGuideAssociation":{"flowId":"flowArn"}}'
```
例如，添加值后，命令可能与以面示例相似：
```
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"}}'
```
### 确认内容关联存在
您可以调用 [ListContentAssociations](https://docs.aws.amazon.com/connect/latest/APIReference/API_amazon-q-connect_ListContentAssociations.html)API 或运行 `list-content-associations` CLI 命令来列出指定内容的所有内容关联。
以下是一个返回内容关联列表的示例 `list-content-associations` 命令，您可以验证所创建的关联是否存在：
```
aws qconnect list-content-associations \
--knowledge-base-id knowledgebaseId \
--content-id contentId
```
例如，添加值后，命令可能与以面示例相似：
```
aws qconnect list-content-associations \
--knowledge-base-id 00000000-0000-0000-0000-000000000000 \
--content-id 11111111-1111-1111-1111-111111111111
```
### 分配权限，以便代理可以查看建议和 step-by-step指南
为代理分配以下**代理应用程序**安全配置文件权限，以便他们可以查看知识库内容和 step-by-step指南。
+ **Connect AI 代理-查看**：使代理能够搜索和查看内容。如果启用了 Contact Lens 对话分析，座席还可以在通话期间收到自动推荐。
+ **自定义视图-访问权限**：使代理能够在其代理工作区中查看 step-by-step指南。
有关如何为现有安全配置文件添加更多权限的信息，请参阅[在 Amazon Connect 中更新安全配置文件](update-security-profiles.md)。