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

# 自定义聊天代理
<a name="custom-agents"></a>

自定义聊天代理使 Amazon Quick 用户能够针对特定的业务需求创建量身定制的对话界面。与默认情况下所有具有聊天权限的用户都可以使用系统聊天代理不同，自定义聊天代理可以由授权用户有选择地共享和配置。

具有聊天代理创建功能的用户可以通过自然语言界面或代理生成器配置流程自定义聊天代理的个性、响应风格和功能。这些用户还可以为这些聊天代理配置特定的知识来源（如空间）和工作流程（如操作），同时分别控制每个资源的共享和访问权限。或者，聊天代理可以取消链接以供一般使用，这样最终用户就可以将代理与其全部或部分资源一起使用。

快速管理员必须向用户授予创建聊天代理的权限。有关哪些角色可以创建聊天代理的信息，请参阅 [Amazon Quick 定价](https://aws.amazon.com/quicksuite/pricing/)文档。有关如何提供或限制对这些功能的访问权限的信息，请参阅《快速管理指南》中的[自定义权限](https://docs.aws.amazon.com/quicksuite/latest/userguide/create-custom-permissions-profile.html)。

**Topics**
+ [创建和预览自定义聊天代理](#create-custom-agents)
+ [共享自定义聊天代理](#share-custom-agents)
+ [嵌入自定义聊天代理](#embed-custom-agents)
+ [更新自定义聊天代理](#update-custom-agents)
+ [管理对自定义聊天代理的访问权限](#remove-access-custom-agents)
+ [查看聊天代理](#view-agents)
+ [查看聊天代理详情](#view-agent-details)
+ [重复的自定义聊天代理](#duplicate-agents)
+ [删除聊天代理](#delete-agents)

## 创建和预览自定义聊天代理
<a name="create-custom-agents"></a>

您可以通过 Amazon Quick 主页上的**聊天代理**菜单在 Amazon Quick 中创建自定义聊天代理。您可以在构建聊天代理时对其进行预览和测试。创建自定义聊天代理时，默认情况下，系统会将您指定为其所有者。以下过程概述了如何创建自定义聊天代理。

------
#### [ Using natural language ]

**使用自然语言提示创建自定义聊天代理**

1. 登录 Amazon Quick 控制台。

1. 在左侧导航菜单中，选择**聊天代理**，然后选择**创建聊天代理**。

1. 在 “**新建聊天代理**” 中，执行以下操作：

   1. 在文本输入框中，输入要创建的聊天代理类型的自然语言描述。这是 Amazon Quick 在你创建聊天代理时使用的提示。您也可以使用页面上建议的示例说明来创建聊天代理。

   1. 然后，选择 “**生成**”。选择 “**生成**” 将获取提供的说明或目标，并将其扩展为聊天代理说明和配置。它还会扫描用户的可用资源（空格和操作连接器），并根据提供的聊天代理意图找到最相关的匹配项。使用这些配置打开扩展的构建器用户界面，供用户查看、自定义、测试和启动。

1. 在 “**配置聊天代理**” 页面上，确保您的聊天代理设置正确，并进一步自定义您的聊天代理。点击**更新预览**以确保在预览版中试用聊天代理之前保存所有更改。

1.  准备就绪后，选择 “**启动聊天代理**”，将您的自定义聊天代理发布到聊天代理库并在聊天中使用。
**注意**  
在您选择 “**启动聊天代理**” 之前，您的聊天代理在聊天代理库中不可用。如果您在未启动的情况下退出创建过程，则预览版将被删除，聊天代理也不会保存。
当您启动聊天代理时，它默认保持私密状态。只有在您共享聊天代理后，该聊天代理才会在其他用户的资源库中可用。共享后，后续的编辑和启动将向所有有权访问的用户发布对同一个聊天代理的更改。

------
#### [ Using builder view directly ]

**使用生成器模式创建自定义聊天代理**

1. 登录 Amazon Quick 控制台。

1. 在左侧导航菜单中，选择**聊天代理**，然后选择**创建聊天代理**。

1. 在**代理创建器**中，选择**跳过**。这将打开聊天代理配置页面，您可以从中构建和自定义聊天代理。

1. 为您的自定义聊天代理添加一个名称。这是用来识别您的聊天代理的名字。

1. （可选）为您的自定义聊天代理添加描述，以帮助用户了解聊天代理的用途。

1. （可选）为您的聊天代理选择一个图标。

1. 在**配置聊天代理**中，自定义以下部分：

   1. 在 **AGENT PERSONA** 中，配置聊天代理的个性、身份、语气和回应风格：
      + 对于**代理身份** — 定义聊天代理的身份。例如，你可以给它说明它的名字和个性。如果留空，Amazon Quick 将使用默认值。
      + 有关**角色配置说明** — 添加有关聊天代理在聊天期间如何与用户互动的说明。例如，您可以定义聊天代理的主要任务是什么。Amazon Quick 使用它们来自定义你的聊天代理的角色。

   1. 在 “**沟通风格**” 中，对于 “**选择回应样式” 预设** — 选择回应风格。您可以在以下响应样式预设之间进行选择，也可以添加自定义说明：
      + **高管** — 针对高级业务沟通和战略见解进行了优化。
      + **技术**-针对详细的技术解释和技术问题解决进行了优化。
      + **创意**-通用交互的标准配置。

      每个预设都有以下设置：
      + Fo **r Ton** e — 添加自然语言提示来定义代理的语气。Amazon Quick 将使用它来定制你的聊天代理的角色。
      + 对于**响应格式**-添加自然语言提示以定义聊天代理的响应风格。Amazon Quick 将使用它来定制你的聊天代理的回复风格。定义聊天代理回复的格式，例如：“对于长于 3 个项目的列表，使用要点”。
      + 长**度** — 指定聊天代理的回复时长。定义聊天代理回复的长度，例如：“将答案保持在 100 字以内”。

      当您选择要使用的预设时，Amazon Quick 会根据所选的样式自动填充聊天代理回复的**语气**、**响应格式**和**长度**说明。您可以使用自然语言进一步自定义现有提示，也可以创建新的提示。

   1. 在**参考文档**中，上传聊天代理内存中保持活跃状态的文件，以指导所有互动。有关参考文档如何与其他上下文类型配合使用的更多信息，请参阅[代理上下文的类型](quicksuite/latest/userguide/agent-knowledge-sources-best-practices.html)。
      + 选择 “**上传文件**” 或拖放您的文档以附加文件，这些文件将指导您的聊天代理的回复。
      + 您可以附加.pdf、.txt、.html、.md、.csv、.doc 或.docx 格式的文档。将从上传的文档中提取并接受多达 100,000 个字符的文本。

1. （可选）在**知识源**中，在以下选项之间进行选择：
   + 在不链接知识来源的情况下继续
     + 您的聊天代理将根据大型语言模型 (LLM) 知识以及互动用户可以访问的所有 Amazon Quick 资源生成响应。您可以选择在聊天期间选择要重点关注的特定知识来源。如果您想创建通用聊天代理，请选择此选项。
   + 链接特定的现有空间
     + 选择 “**链接**”。
     + 在 “**链接空间**” 模式中，选择要链接到聊天代理的空间，然后选择 “**链接**”。

       系统会显示一条成功消息，表示链接成功。

       如果您将聊天代理链接到知识来源，则聊天代理将仅根据大型语言模型 (LLM) 知识生成响应，并仅从链接的资源生成数据。在聊天过程中，您最多可以向该聊天代理再添加 1 个知识源作为临时上下文。
   + 创建和链接新空间
     + 选择**创建**。
     + 在打开的 “**创建空间**” 窗口中，选择要添加到空间的资源，然后选择 “**创建**”。

       如果您将聊天代理链接到知识来源，则聊天代理将仅根据大型语言模型 (LLM) 知识生成响应，并仅从链接的资源生成数据。在聊天过程中，您最多可以向该聊天代理再添加 1 个知识源作为临时上下文。
**注意**  
有关创建和使用空间的更多信息，请参阅 [Amazon Quick 中使用空间](https://docs.aws.amazon.com/quicksuite/latest/userguide/working-with-spaces.html)。

       系统将显示一条成功消息，表示空间创建成功。返回聊天代理创建窗口。
     + 在聊天代理创建窗口中，从**知识源**中选择**链接**。
     + 从 “**链接空间**” 模式中，选择您刚刚创建的空间，然后选择 “**链接**”。

       系统会显示一条成功消息，表示链接成功。

1. （可选）在 “**操作**” 中，对于 “**操作**”-在以下选项中进行选择：
   + 链接特定的现有操作
     + 选择 “**链接**”。
     + 在 “**链接操作连接器**” 模式中，选择要链接到聊天代理的操作连接器，然后选择 “**下一步**”。
     + 在 “**操作**” 中，选择要添加的操作，然后选择 “**链接**”。

       系统会显示一条成功消息，表示链接成功。
   + 创建操作连接器并链接新操作
     + 选择**创建**。
     + 在 “**操作**” 主页上，选择 “**新建操作**”。
     + 在 “**新建” 操作**窗口中，为 “**源**” 选择要添加的操作连接器，然后选择 “**下一步**”。
     + 在 “**操作**” 中，查看可用的操作，然后选择 “**下一步**”。
     + 在**连接详细信息**中，输入所需的连接详细信息，然后选择**添加**。
**注意**  
有关创建和使用操作连接器的更多信息，请参阅 [Amazon Quick 中的操作](https://docs.aws.amazon.com/quicksuite/latest/userguide/qbs-actions.html)。

       系统将显示一条成功消息，表示成功添加了操作。返回聊天代理创建窗口。
     + 在聊天代理创建窗口中，从 “**操作**” 中选择 “**链接**”。
     + 从 “**链接操作连接器**” 模式中，选择您刚刚创建的操作连接器，然后选择 “**链接**”。

       系统会显示一条成功消息，表示链接成功。

1. 在 “**自定义**” 中，执行以下操作：

   1. 对于**欢迎消息** — 添加一条欢迎消息，让聊天代理向最终用户显示。

   1. 对于**建议的提示** — 添加示例提示作为对话开头，告知最终用户聊天代理功能。

1. 选择 “**启动聊天代理**” 以创建您的自定义聊天代理。
**注意**  
在您选择 “**启动聊天代理**” 之前，您的聊天代理在聊天代理库中不可用。如果您在未启动的情况下退出创建过程，则预览版将被删除，聊天代理也不会保存。
当您启动聊天代理时，它默认保持私密状态。只有在您共享聊天代理后，该聊天代理才会在其他用户的资源库中可用。共享后，后续的编辑和启动将向所有有权访问的用户发布对同一个聊天代理的更改。

------

## 共享自定义聊天代理
<a name="share-custom-agents"></a>

创建聊天代理时，默认情况下，系统会将您指定为其所有者。您可以使用以下权限选择与其他 Amazon Quick 用户共享您拥有的聊天代理：
+ *所有者*权限-用户可以编辑、共享、使用和删除聊天代理。
+ *查看者*权限-用户可以查看和使用聊天代理。

您还可以全局定义聊天代理的访问权限，授予所有用户访问聊天代理的权限，然后为特定用户和群组定义更精细的访问权限。

以下过程向您展示如何共享聊天代理并向其分配权限。

**共享自定义聊天代理**

1. 登录 Amazon Quick 控制台。

1. 从左侧导航菜单中，选择**聊天代理**

1. 然后，在要共享的聊天代理的 “**操作**” 列中，选择菜单图标，然后选择 “**共享**”。

1. 在打开的**共享聊天代理**模式中，输入您要与之共享聊天代理的用户或群组名称。当出现用户名或组名时，将其选中。对要与之共享聊天代理的所有群组或用户重复该操作。该模式显示您要添加的用户和群组。

1. 使用用户名或群组名称旁边的下拉菜单，为您与之共享聊天代理的每个用户或群组分配权限和访问信息。您可以分配以下两个角色之一：
   + **所有者**-用户可以编辑、共享和删除聊天代理。
   + **查看器**-用户可以查看和使用聊天代理。

1. 选择**共享**。

## 嵌入自定义聊天代理
<a name="embed-custom-agents"></a>

您可以在外部网站或应用程序中嵌入自定义聊天代理，以便用户可以在 Amazon Quick 控制台之外与其进行互动。要嵌入聊天代理，您必须先在 Amazon Quick 管理员设置中允许托管域，然后通过聊天代理的共享选项生成嵌入代码。

嵌入聊天代理涉及两个步骤：

1. **允许托管域** — Amazon Quick 管理员必须将托管嵌入式聊天代理的域（以及可选的子域）添加到域允许列表中。

1. **生成嵌入代码**-聊天代理所有者或授权用户通过聊天代理的共享选项生成嵌入代码。

### 允许嵌入式聊天代理使用域名
<a name="embed-agents-allow-domain"></a>

在将聊天代理嵌入外部网站之前，Amazon Quick 管理员必须将托管域添加到允许列表中。要完成此过程，您必须是 Amazon Quick 管理员。这样可以确保只有经过批准的域才能托管嵌入式聊天代理。

**允许嵌入域**

1. 登录 Amazon Quick 控制台。

1. 选择个人资料图标。

1. 选择 “**管理账户**”。

1. 在导航窗格中的 “**安全**” 下，选择 “**管理域**”。

1. 在 “**域**” 字段中，输入要托管嵌入式聊天代理的域名（例如`https://example.com`）。

1. （可选）选择 “**包括子域**”，允许在指定域的所有子域上嵌入聊天代理。

1. 选择**添加**。

该域现在出现在允许的域名列表中。您可以通过选择列表中每个域名旁边的编辑或删除图标来编辑或删除现有域名。

### 为聊天代理生成嵌入代码
<a name="embed-agents-generate-code"></a>

允许托管域名后，您可以为聊天代理生成嵌入代码。

**为聊天代理生成嵌入代码**

1. 登录 Amazon Quick 控制台。

1. 在导航窗格中，选择**聊天代理**。

1. 在要嵌入的聊天代理的 “**操作**” 列中，选择菜单图标，然后选择**编辑**。

1. 在聊天代理编辑器中，选择**共享**。

1. 在共享选项中，选择**通过嵌入共享**。

1. 复制提供的嵌入代码并将其粘贴到您希望聊天代理出现的网站或应用程序的 HTML 中。

嵌入式聊天代理现在可以在您的网站上使用。访问该页面的用户可以直接与聊天代理互动。

## 更新自定义聊天代理
<a name="update-custom-agents"></a>

您可以从 Amazon Quick 主页上的 “代**理**” 菜单中更新 Amazon Quick 中的自定义聊天代理。以下过程概述了如何执行此操作。

**注意**  
配置聊天代理时，您可以在预览聊天界面中预览聊天代理自定义更新的表现。在测试更改之前，请务必选择 “**更新预览**”。在预览中测试完所有更改后，选择**启动**将更改发布到当前正在使用的聊天代理。

**更新自定义聊天代理**

1. 登录 Amazon Quick 控制台。

1. 从左侧导航菜单中，选择**聊天代理**

1. 然后，在要共享的聊天代理的 “**操作**” 列中，选择菜单图标，然后选择 “**编辑**”。这将创建聊天代理的预览版本，以便在发布之前进行更新和测试。

1. 在**编辑代理**中，更新您的聊天代理设置，然后选择**启动**。

## 管理对自定义聊天代理的访问权限
<a name="remove-access-custom-agents"></a>

如果您是聊天代理的所有者，则可以选择更改聊天代理的用户访问权限。您还可以删除用户和群组对聊天代理的访问权限。具体操作方法详见以下步骤。

**管理对自定义聊天代理的访问权限**

1. 登录 Amazon Quick 控制台。

1. 从左侧导航菜单中，选择**聊天代理**

1. 然后，在要共享的聊天代理的 “**操作**” 列中，选择菜单图标，然后选择 “**共享**”。

1. 在打开的**共享聊天代理**模式中，选择要更改权限的用户和群组。当出现用户名或组名时，将其选中并更改权限。对要更改权限的所有群组或用户重复该操作。该模式显示您正在更改的用户和群组权限。您可以采取以下三个操作：
   + 更改为**所有者**-用户可以编辑、共享和删除聊天代理。
   + 切换到**查看器**-用户可以查看和使用聊天代理。
   + **删除访问权限**-删除用户或群组对聊天代理的访问权限。
**注意**  
您还可以全局定义聊天代理的访问权限，授予所有用户访问聊天代理的权限，然后为特定用户和群组定义更精细的访问权限。为此，请选择 “**设置”**，然后使用 **“全局设置”** 来开启或关闭此功能。

1. 选择**共享**。

## 查看聊天代理
<a name="view-agents"></a>

您可以查看已创建或有权访问的聊天代理的列表。具体操作方法详见以下步骤。

**查看自定义聊天代理**

1. 登录 Amazon Quick 控制台。

1. 从左侧导航菜单中，选择**聊天代理**

1. 您已创建或有权访问的聊天代理将显示在**聊天代理**主页上。

## 查看聊天代理详情
<a name="view-agent-details"></a>

您可以查看由您创建或与您共享的聊天代理的详细信息，包括每个聊天代理关联的所有空间和操作。

**查看聊天代理详情**

1. 登录 Amazon Quick 控制台。

1. 从左侧导航菜单中，选择**聊天代理**

1. 然后，从聊天代理列表的**名称**列中，单击要查看其详细信息的聊天代理的名称。详情模式将打开。
**注意**  
您还可以通过导航到要共享的聊天代理的 “**操作**” 列，选择菜单图标，然后选择 “查看聊天代理详细信息” 来**查看聊天代理的详细信息**。

1. 在打开的聊天代理详情模式中，您将看到以下详细信息：

   1. **描述**-聊天代理的描述。

   1. **说明摘要**-为聊天代理定义的说明摘要。

   1. **创建**者-有关聊天代理是由您还是他人创建的详细信息。

   1. **上次修改**时间-聊天代理上次修改的时间。

   1. 在 “**能力**” 下：
      + **知识**-聊天代理所连接或可以访问的知识来源。如果您的聊天代理已链接到某个空间，则可以看到该聊天代理链接到哪个空间。
      + **操作**-聊天代理已连接或有权访问的操作。您也可以通过单击聊天界面代理选择器中代理名称旁边的**信息**来查看此信息。

## 重复的自定义聊天代理
<a name="duplicate-agents"></a>

您可以复制现有的自定义聊天代理，而无需从头开始构建聊天代理。用户可以使用 “复制” 操作按钮从列表页面**复制**聊天代理。当您复制聊天代理时，Amazon Quick 会创建一个名称格式为 “[原始姓名]（副本）” 的新聊天代理，您可以对其进行编辑。原始聊天代理中的所有字段和配置都将复制到新版本的聊天代理中。复制后，您可以为复制的聊天代理分配自定义用户访问权限并进行共享。

以下步骤概述了如何复制聊天代理。

**复制自定义聊天代理**

1. 登录 Amazon Quick 控制台。

1. 从左侧导航菜单中，选择**聊天代理**

1. 然后，在要共享的聊天代理的 “**操作**” 列中，选择菜单图标，然后选择 “**复制**”。

   您将被重定向到带有预填字段的聊天代理复制模式。

1. 根据需要进行任何更改，包括添加正确的用户和群组权限，并将其关联到所需的资产，然后选择 La **unch** 以启动复制的聊天代理。

## 删除聊天代理
<a name="delete-agents"></a>

您可以删除自己拥有的 Amazon Quick 聊天代理。以下步骤将说明如何操作。

**删除自定义聊天代理**

1. 登录 Amazon Quick 控制台。

1. 从左侧导航菜单中，选择**聊天代理**

1. 然后，在要共享的聊天代理的 “**操作**” 列中，选择菜单图标，然后选择**删除**。