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

在 Amazon Connect 中创建人工智能座席

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

Amazon Q in Connect 为每个使用案例提供了一个系统人工智能座席：

系统人工智能座席会为每个使用案例填充默认的人工智能提示。

例如，下图显示了 Amazon Q in Connect 体验，该体验配置为将自定义人工智能座席用于推荐答案和手动搜索，但将系统默认人工智能座席用于自助服务使用案例。

以下是自定义人工智能座席的工作原理：

如何创建人工智能座席

将人工智能座席与流关联

要使用默认的 out-of-the-box Amazon Q in Connect 功能，您需要在流程中添加一个Amazon Q in Connect屏蔽。此数据库块将助手与人工智能座席的默认映射相关联。

要覆盖此默认行为，请创建 Lambda，然后使用 AWS Lambda 函数数据块将其添加到流。

用于创建和管理人工智能座席的示例 CLI 命令

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

创建使用每个自定义人工智能提示版本的人工智能座席

如果为人工智能座席指定了一个人工智能提示版本，Amazon Q in Connect 将使用该人工智能提示版本来实施其功能。否则，它默认为系统行为。

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

aws qconnect create-ai-agent \
  --assistant-id <YOUR_Q_IN_CONNECT_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>"
    }
  }'            

部分配置人工智能座席

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

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

aws qconnect create-ai-agent \
  --assistant-id <YOUR_Q_IN_CONNECT_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>"
    }
  }'

为手动搜索配置人工智能提示版本

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

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

aws qconnect create-ai-agent \
  --assistant-id <YOUR_Q_IN_CONNECT_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>"
    }
  }'            

使用人工智能座席覆盖知识库配置

还可以使用人工智能座席来配置 Amazon Q in Connect 应该使用哪些助手关联以及如何使用它们。支持自定义的关联为支持以下各项的知识库：

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

aws qconnect create-ai-agent \
  --assistant-id <YOUR_Q_IN_CONNECT_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>" }
              }
            }
          }
        }
      ]
    }
  }'  

创建人工智能座席版本

与人工智能提示一样，在创建了人工智能座席后，您可以创建一个版本，该版本是人工智能座席的不可变实例，可在运行时供 Amazon Q in Connect 使用。

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

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

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

 <AI_AGENT_ID>:<VERSION_NUMBER>            

设置与 Amazon Q in Connect 结合使用的人工智能座席

为使用案例创建人工智能提示版本和人工智能座席版本后，您可以将它们设置为与 Amazon Q in Connect 结合使用。

在 Amazon Q in Connect 助手中设置人工智能座席版本

您可以将人工智能座席版本设置为要在 Amazon Q in Connect 助手中使用的默认版本。

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

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

在 Amazon Q in Connect 会话中设置人工智能座席版本

在创建或更新会话时，还可以为每个不同的 Amazon Q in Connect 会话设置人工智能座席版本。

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

aws qconnect update-session \
  --assistant-id <YOUR_Q_IN_CONNECT_ASSISTANT_ID> \
  --session-id <YOUR_Q_IN_CONNECT_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>" }
  }'                

对会话设置的人工智能座席版本优先于在 Amazon Q in Connect 助手级别设置的版本，而后者又优先于系统默认版本。此优先顺序可用于在为特定联络中心业务分部创建的会话上设置人工智能座席版本。例如，通过使用 Lambda 流数据块，使用流来为特定 Amazon Connect 队列自动设置人工智能座席版本。

恢复系统默认设置

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

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

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