

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 在 Amazon Connect 中创建人工智能座席
<a name="create-ai-agents"></a>

*AI 代理*是一种配置和自定义 end-to-end AI 代理体验的资源。例如，人工智能座席告诉 AI 助手如何处理手动搜索：它应该使用哪些人工智能提示和人工智能护栏，以及要将哪个区域设置用于回复。

Amazon Connect 提供以下开箱即用的系统 AI 代理：
+ 编排
+ 答案推荐
+ 手动搜索
+ 自助服务
+ 电子邮件回复
+ 电子邮件概述
+ 电子邮件生成答案
+ 记笔记
+ 代理协助
+ 案例摘要

每个用例都配置为使用默认 AI 系统代理。这也可以自定义。

例如，下图显示了 Connect AI 代理体验，该体验配置为在代理辅助用例中使用自定义 AI 代理，其余使用系统默认 AI 代理。

![\[为 Amazon Connect 指定的默认和自定义 AI 代理\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/ai-agent-default.png)


以下是自定义人工智能座席的工作原理：
+ 您可以使用自定义的人工智能座席覆盖一个或多个系统人工智能座席。
+ 然后，您的自定义人工智能座席将变为指定使用案例的默认人工智能座席。
+ 创建自定义人工智能座席时，您可以指定一个或多个您自己的自定义人工智能提示和一个护栏。
+ 大多数使用案例（**推荐答案**、**自助服务**、**电子邮件回复**和**电子邮件生成答案**）支持两种类型的人工智能提示。如果您选择为一种类型但不为另一种类型创建新的人工智能提示，则人工智能座席会为您未覆盖的人工智能提示继续使用系统默认值。通过这种方式，您可以选择仅覆盖默认 Connect AI 代理体验的特定部分。

## 如何创建人工智能座席
<a name="howto-create-ai-agents"></a>

1. 登录 Amazon Connect 管理员网站 https://*instance name*.my.connect.aws/。使用管理员帐户或具有 **AI 代理设计器-AI 代理**-**AI 代理**-**在其安全配置文件中创建**权限的帐户。

1. 在导航菜单上，选择 **AI 代理设计器**、**AI 代理**。

1. 在**人工智能座席**页面上，选择**创建人工智能座席**。

1. 在**创建人工智能座席**对话框中，对于**人工智能座席类型**，使用下拉框从以下类型中进行选择：
   + **编排**：具有代理功能的 AI 代理，可根据客户需求编排不同的用例。它可以进行多回合对话并调用预先配置的工具。它使用**编排**类型的 AI 提示。
   + **推荐答案**：一种人工智能座席，当座席与客户联系时，它会自动向座席推送基于意图的建议。它使用以下类型的人工智能提示：
     +  **生成意图标签**人工智能提示，以生成意图供客户服务座席选择，这是第一步。
     + **查询重构**人工智能提示（在选择意图后使用）。它使用此提示来构造适当的查询，然后使用该查询来获取相关的知识库摘录。
     + **生成答案**，生成的查询和摘录分别使用 `$.query` 和 `$.contentExcerpt` 变量输入到此提示中。
   + **手动搜索**：一种可根据座席发起的按需搜索生成解决方案的人工智能座席。它使用**生成答案**类型的人工智能提示。

      
   + **自助服务**：人工智能座席为自助服务生成解决方案。它使用**自助生成答案**和**自助预处理**类型的人工智能提示。
   + **电子邮件回复**：一种人工智能座席，便于向最终客户发送对话脚本的电子邮件回复。
   + **电子邮件概述**：提供电子邮件内容概述的人工智能座席。
   + **电子邮件生成答案**：为电子邮件回复生成答案的人工智能座席。
**重要**  
**推荐答案**和**自助服务**支持两种类型的人工智能提示。如果您选择为一种类型但不为另一种类型创建新的人工智能提示，则人工智能座席会为您未替换的人工智能提示继续使用系统默认值。通过这种方式，您可以选择仅覆盖默认 Connect AI 代理体验的特定部分。

1. 在**座席生成器**页面上，您可以指定要用于回复的区域设置。有关支持的区域设置的列表，请参阅[支持的区域设置代码](ai-agent-configure-language-support.md#supported-locale-codes-q)。

   您可以为 AI 代理的 **Orchestrat** ion、**答案推荐**、**手动搜索**、**电子邮件回复****、电子邮件概述**和**电子邮件生成答案**类型选择区域设置。您无法为**自助服务**选择区域设置；仅支持英语。

1. 选择要覆盖默认设置的人工智能提示。请注意，您选择的是已发布的人工智能提示*版本*，而不只是已保存的人工智能提示。如果需要，请向人工智能座席添加人工智能护栏。
**注意**  
如果您没有专门使用自定义的内容覆盖默认人工智能提示，则将继续使用默认的人工智能提示。

1. 选择**保存**。您可以继续更新和保存人工智能座席，直到其符合您的预期为止。

1. 要将新的人工智能座席版本作为潜在的默认版本提供，请选择**发布**。

## 将人工智能座席与流关联
<a name="ai-agents-flows"></a>

要使用默认的 out-of-the-box Connect AI 代理功能，您需要在流程中添加一个[Connect 助手](connect-assistant-block.md)模块。此数据库块将助手与人工智能座席的默认映射相关联。

要覆盖此默认行为，请创建 Lambda，然后使用 [AWS Lambda 函数](invoke-lambda-function-block.md)数据块将其添加到流。

## 用于创建和管理人工智能座席的示例 CLI 命令
<a name="cli-ai-agents"></a>

本节提供了几个示例 AWS CLI 命令来帮助您创建和管理 AI 代理。

**Topics**
+ [创建使用每个自定义人工智能提示版本的人工智能座席](#cli-ai-agents-sample1)
+ [部分配置人工智能座席](#cli-ai-agents-sample2)
+ [为手动搜索配置人工智能提示版本](#cli-ai-agents-sample3)
+ [使用人工智能座席覆盖知识库配置](#cli-ai-agents-sample4)
+ [创建人工智能座席版本](#cli-ai-agents-sample5)
+ [设置要与 Connect 人工智能代理一起使用的 AI 代理](#cli-ai-agents-sample6)
+ [恢复系统默认设置](#cli-ai-agents-sample6b)

### 创建使用每个自定义人工智能提示版本的人工智能座席
<a name="cli-ai-agents-sample1"></a>

 如果为 AI 代理指定了 AI 提示版本，Connect AI 代理将使用 AI 提示符版本来实现其功能。否则，它默认为系统行为。

使用以下 AWS CLI 命令示例，创建一个 AI 代理，该代理使用每个自定义 AI 提示版本来提供答案建议。

```
aws qconnect create-ai-agent \
  --assistant-id <YOUR_CONNECT_AI_AGENT_ASSISTANT_ID> \
  --name example_answer_recommendation_ai_agent \
  --visibility-status PUBLISHED \
  --type ANSWER_RECOMMENDATION \
  --configuration '{
    "answerRecommendationAIAgentConfiguration": {
      "answerGenerationAIPromptId": "<ANSWER_GENERATION_AI_PROMPT_ID_WITH_VERSION_QUALIFIER>",
      "intentLabelingGenerationAIPromptId": "<INTENT_LABELING_AI_PROMPT_ID_WITH_VERSION_QUALIFIER>",
      "queryReformulationAIPromptId": "<QUERY_REFORMULATION_AI_PROMPT_ID_WITH_VERSION_QUALIFIER>"
    }
  }'
```

### 部分配置人工智能座席
<a name="cli-ai-agents-sample2"></a>

 您可以通过指定人工智能座席应使用一些自定义的人工智能提示版本，来部分配置人工智能座席。如果未指定，它将使用默认的人工智能提示。

使用以下示例 AWS CLI 命令创建答案建议 AI 代理，该代理使用自定义 AI 提示版本，其余部分由系统默认值处理。

```
aws qconnect create-ai-agent \
  --assistant-id <YOUR_CONNECT_AI_AGENT_ASSISTANT_ID> \
  --name example_answer_recommendation_ai_agent \
  --visibility-status PUBLISHED \
  --type ANSWER_RECOMMENDATION \
  --configuration '{
    "answerRecommendationAIAgentConfiguration": {
      "answerGenerationAIPromptId": "<ANSWER_GENERATION_AI_PROMPT_ID_WITH_VERSION_QUALIFIER>"
    }
  }'
```

### 为手动搜索配置人工智能提示版本
<a name="cli-ai-agents-sample3"></a>

手动搜索人工智能座席类型只有一个人工智能提示版本，因此无法进行部分配置。

使用以下 AWS CLI 命令示例，为手动搜索指定 AI 提示符版本。

```
aws qconnect create-ai-agent \
  --assistant-id <YOUR_CONNECT_AI_AGENT_ASSISTANT_ID> \
  --name example_manual_search_ai_agent \
  --visibility-status PUBLISHED \
  --type MANUAL_SEARCH \
  --configuration '{
    "manualSearchAIAgentConfiguration": {
      "answerGenerationAIPromptId": "<ANSWER_GENERATION_AI_PROMPT_ID_WITH_VERSION_QUALIFIER>"
    }
  }'
```

### 使用人工智能座席覆盖知识库配置
<a name="cli-ai-agents-sample4"></a>

 您可以使用 AI 代理来配置 Connect AI 代理应使用哪些助理关联以及应如何使用它们。支持自定义的关联为支持以下各项的知识库：
+  通过使用知识库的 `associationId` 来指定要使用的知识库。
+  使用 `contentTagFilter` 为在关联的知识库上执行的搜索指定内容筛选条件。
+  使用 `maxResults` 指定对知识库进行搜索要使用的结果数量。
+  指定可用于控制对知识库执行的搜索类型的 `overrideKnowledgeBaseSearchType`。选项包括使用向量嵌入的 `SEMANTIC` 和同时使用向量嵌入和原始文本的 `HYBRID`。

 例如，使用以下 AWS CLI 命令创建具有自定义知识库配置的 AI 代理。

```
aws qconnect create-ai-agent \
  --assistant-id <YOUR_CONNECT_AI_AGENT_ASSISTANT_ID> \
  --name example_manual_search_ai_agent \
  --visibility-status PUBLISHED \
  --type MANUAL_SEARCH \
  --configuration '{
    "manualSearchAIAgentConfiguration": {
      "answerGenerationAIPromptId": "<ANSWER_GENERATION_AI_PROMPT_ID_WITH_VERSION_QUALIFIER>",
      "associationConfigurations": [
        {
          "associationType": "KNOWLEDGE_BASE",
          "associationId": "<ASSOCIATION_ID>",
          "associationConfigurationData": {
            "knowledgeBaseAssociationConfigurationData": {
              "overrideKnowledgeBaseSearchType": "SEMANTIC",
              "maxResults": 5,
              "contentTagFilter": {
                "tagCondition": { "key": "<KEY>", "value": "<VALUE>" }
              }
            }
          }
        }
      ]
    }
  }'
```

### 创建人工智能座席版本
<a name="cli-ai-agents-sample5"></a>

 就像 AI 提示一样，创建 AI 代理后，您可以创建一个版本，该版本是 AI 代理的不可变实例，可由 Connect AI 代理在运行时使用。

使用以下 AWS CLI 命令示例，创建 AI 代理版本。

```
aws qconnect create-ai-agent-version \
  --assistant-id <YOUR_CONNECT_AI_AGENT_ASSISTANT_ID> \
  --ai-agent-id <YOUR_AI_AGENT_ID>
```

 创建版本后，可以使用以下格式限定人工智能座席的 ID：

```
 <AI_AGENT_ID>:<VERSION_NUMBER>            
```

### 设置要与 Connect 人工智能代理一起使用的 AI 代理
<a name="cli-ai-agents-sample6"></a>

 为用例创建 AI 提示版本和 AI 代理版本后，可以将其设置为与 Connect AI 代理一起使用。

#### 在 Connect 人工智能代理助手中设置 AI 代理版本
<a name="cli-ai-agents-sample6a"></a>

 您可以将 AI 代理版本设置为 Connect AI 代理助手中使用的默认版本。

使用以下 AWS CLI 命令示例，将 AI 代理版本设置为默认版本。设置 AI 代理版本后，将在创建下一个 Amazon Connect 联系人和关联的 Connect AI 代理会话时使用该版本。

```
aws qconnect update-assistant-ai-agent \
  --assistant-id <YOUR_CONNECT_AI_AGENT_ASSISTANT_ID> \
  --ai-agent-type MANUAL_SEARCH \
  --configuration '{
    "aiAgentId": "<MANUAL_SEARCH_AI_AGENT_ID_WITH_VERSION_QUALIFIER>"
  }'
```

#### 在 Connect AI 代理会话中设置 AI 代理版本
<a name="connect-sessions-setting-ai-agents-for-use-customize-q"></a>

 在创建或更新会话时，您还可以为每个不同的 Connect AI 代理会话设置 AI 代理版本。

使用以下 AWS CLI 命令示例，为每个不同的会话设置 AI 代理版本。

```
aws qconnect update-session \
  --assistant-id <YOUR_CONNECT_AI_AGENT_ASSISTANT_ID> \
  --session-id <YOUR_CONNECT_AI_AGENT_SESSION_ID> \
  --ai-agent-configuration '{
    "ANSWER_RECOMMENDATION": { "aiAgentId": "<ANSWER_RECOMMENDATION_AI_AGENT_ID_WITH_VERSION_QUALIFIER>" },
    "MANUAL_SEARCH": { "aiAgentId": "<MANUAL_SEARCH_AI_AGENT_ID_WITH_VERSION_QUALIFIER>" }
  }'
```

 在会话中设置的 AI 代理版本优先于在 Connect AI 代理助手级别设置的版本，后者反过来又优先于系统默认值。此优先顺序可用于在为特定联络中心业务分部创建的会话上设置人工智能座席版本。例如，通过[使用 Lambda 流数据块](connect-lambda-functions.md)，使用流来为特定 Amazon Connect 队列自动设置人工智能座席版本。

### 恢复系统默认设置
<a name="cli-ai-agents-sample6b"></a>

 如果出于某种原因需要删除自定义，则可以恢复到默认人工智能座席版本。

使用以下 AWS CLI 命令示例，列出 AI 代理版本并恢复到原始版本。

```
aws qconnect list-ai-agents \
  --assistant-id <YOUR_CONNECT_AI_AGENT_ASSISTANT_ID> \
  --origin SYSTEM
```

**注意**  
 `--origin SYSTEM` 已指定为获取系统人工智能座席版本的参数。如果没有此参数，则将列出自定义人工智能座席版本。列出 AI 代理版本后，使用它们在 Connect AI 代理助手或会话级别重置为默认 Connect AI 代理体验；使用中所述的 CLI 命令[设置要与 Connect 人工智能代理一起使用的 AI 代理](#cli-ai-agents-sample6)。