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