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

# 在 Amazon Quick 中创建、自定义和部署人工智能支持的聊天代理
<a name="working-with-agents"></a>

Amazon Quick 中的聊天代理可帮助用户浏览数据、分析信息并采取行动。用户可以使用快速聊天界面与聊天代理互动。聊天代理通过开放式对话提供帮助，这些对话由特定目标、知识来源和任何关联工具提供支持。聊天代理可以从简单的问答界面演变为协调复杂工作流程的更高级的功能。

您可以使用聊天代理来：
+ 通过自然语言对话生成内容并提供答案
+ 分析和汇总来自互联空间、仪表板、主题、数据集和上传文件的信息
+ 调用操作来执行预定义的步骤，以获得一致、可重复的结果

**注意**  
要了解有关使用聊天代理聊天的更多信息，请参阅[使用 Amazon 快速聊天](https://docs.aws.amazon.com/quicksuite/latest/userguide/using-quick-chat.html)。

**Topics**
+ [聊天代理类型](#agent-types)
+ [Amazon 用户与聊天代理的快速互动](#user-agent-actions)
+ [聊天代理的 Amazon Quick 用户权限](#user-agent-permissions)
+ [聊天代理的自定义权限](#custom-permissions-chat-agents)
+ [系统聊天代理](default-assistant.md)
+ [自定义聊天代理](custom-agents.md)
+ [聊天代理上下文来源和最佳实践](agent-knowledge-sources-best-practices.md)
+ [使用聊天代理](use-agents.md)

## 聊天代理类型
<a name="agent-types"></a>

Amazon Quick 支持两种类型的聊天代理：
+ **系统聊天代理**-默认情况下，此聊天代理（“我的助手”）自动可供所有用户使用。系统聊天代理充当基本计划器，没有自己的固有数据或操作，它可以在聊天期间动态访问每个用户可用的资源，从而可以根据个人用户权限和可用内容进行定制。管理员用户通过将特定用户指定为所有者来控制系统聊天代理设置，这样他们就可以自定义聊天代理的角色和其他设置。

  系统聊天代理启用了所有聊天功能，包括文件上传功能、法学硕士知识访问、毒性和其他护栏、网络搜索。它还包括聊天数据范围界定机制，可根据用户权限提供对空间、主题、仪表板、知识库和操作的访问权限。
+ **自定义聊天代理** — 这些聊天代理可由在 Amazon Quick 中具有聊天代理创建功能的用户根据特定用例进行创建和定制，并与任何人共享。管理员可以选择限制特定用户和群组创建自定义聊天代理，同时仍允许用户通过聊天使用聊天代理。聊天代理返回的响应范围仅限于其调用用户有权访问的内容。

自定义聊天代理可以通过以下方式与 Amazon Quick 资源进行交互：
+ **预配置资源**-这些聊天代理在寻找答案或将操作编排为默认行为时，仅使用已配置的资源（例如，空间作为知识来源，操作连接器作为工具）。聊天时，用户可以根据需要附加其他资源或直接调用操作。例如，除非用户明确调用聊天代理，否则默认情况下，仅配置了包含文件的空格的聊天代理无法执行操作。同样，除非用户附加空间或仪表板来获取企业特定的答案，否则仅配置了操作的聊天代理依赖于法学硕士的知识。但是，用户可以在聊天界面中附加其他空格或直接调用他们可能有权访问的其他操作。
+ **在构建时不固执己见** — 这些聊天代理在构建时最初没有配置资源（空格或操作连接器，或两者兼而有之）。聊天决定聊天代理的资源边界。例如，如果没有为聊天代理配置任何空间，则聊天将默认为所有空间或 LLM 知识，直到用户进行更改。如果没有为聊天代理配置任何操作连接器，则在聊天期间，在用户选择不包括操作的资源之前，代理将可以使用用户有权访问的所有操作。

  聊天期间的用户资源选择会影响聊天代理的行为。如果用户选择空间，聊天代理将只使用该空间内的数据进行回答，并在该空间内采取可用的操作（如果在构建时没有固执己见）。如果用户选择仪表板、主题或知识库，则聊天代理将仅从该来源回答，并且不会采取任何行动，因为焦点已更改为特定的数据源。用户需要在聊天中选择所有相关资源以获得全面帮助。
**注意**  
从设计上讲，系统聊天代理是一个不固执己见的聊天代理。如果您希望聊天代理可以访问所有操作，而不考虑数据焦点，请使用操作连接器配置聊天代理。

## Amazon 用户与聊天代理的快速互动
<a name="user-agent-actions"></a>

下表显示了与使用 Amazon Quick 用户相比，您可以在管理员控制台中使用聊天代理执行哪些操作。有关哪些角色可以访问这些功能的更多信息，请参阅 [Amazon Quick 定价](https://aws.amazon.com/quicksuite/pricing/)文档。


| 访问级别 | 功能 | 
| --- | --- | 
| 管理员控制台 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/quick/latest/userguide/working-with-agents.html)  | 
| Amazon Quick 用户 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/quick/latest/userguide/working-with-agents.html)  | 

## 聊天代理的 Amazon Quick 用户权限
<a name="user-agent-permissions"></a>

您可以使用聊天代理执行的操作还取决于您为其分配的权限。可以为用户分配两种权限类型：
+ **所有者**-所有者可以编辑、共享和删除聊天代理。
+ **查看器**-查看者可以查看和使用聊天代理。

**注意**  
如果您无法以查看者或所有者的身份访问链接的资源，则其他所有者添加到聊天代理的资源将显示为 “资源不可用”。您可以以所有者的身份删除这些资源，但不能列出或添加它们，因为需要资源级共享。

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

下表概述了用户权限如何决定您可以使用 Amazon Quick 聊天代理执行的操作：


| 权限类型 | Permissions | 
| --- | --- | 
| 所有者 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/quick/latest/userguide/working-with-agents.html)  | 
| 观众 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/quick/latest/userguide/working-with-agents.html)  | 

## 聊天代理的自定义权限
<a name="custom-permissions-chat-agents"></a>

默认情况下，Amazon Quick 会启用 Amazon Quick 账户可用的所有新功能，因此用户可以根据自己的订阅立即使用这些功能。您可以使用[自定义权限](https://docs.aws.amazon.com/quicksuite/latest/userguide/create-custom-permissions-profile.html)来限制特定功能。作为管理员，在创建自定义权限配置文件时，您可以为聊天代理创建两种类型的限制：
+ 您可以完全禁用用户的所有聊天代理功能，包括与默认代理聊天、与自定义代理聊天以及创建新代理。这可以通过限制**聊天代理**功能来实现。
+ 您还可以特别限制在不影响与客服聊天的情况下创建代理的能力。这可以通过创建自定义权限配置文件并仅限制 “**创建聊天代理” 功能来**完成。

**注意**  
如果您希望用户能够使用系统代理聊天，但又不希望他们创建聊天代理，请仅限制他们的聊天代理创建权限。

Amazon Quick 中的代理权限可以按各种组合进行配置，以满足贵组织的需求。为了帮助您了解如何配置权限，以下部分提供了一种以用例为导向的方法，将常见场景分组：


| 使用案例场景 | 用户可以做什么 | 
| --- | --- | 
| 具有所有能力的代理（对聊天代理、空间、知识库、操作或流程没有限制） | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/quick/latest/userguide/working-with-agents.html) | 
| 仅限聊天的代理访问权限（已启用代理功能，但聊天代理的创建受到限制） | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/quick/latest/userguide/working-with-agents.html) | 
| 对其他功能的访问权限有限（聊天代理已启用，但特定功能受到限制） | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/quick/latest/userguide/working-with-agents.html) | 
| 没有聊天代理访问权限（代理功能完全受限） | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/quick/latest/userguide/working-with-agents.html) | 

# 系统聊天代理
<a name="default-assistant"></a>

Amazon Quick 系统聊天代理是在您注册 Quick 时自动创建的。它是所有用户在 Quick 环境中与其数据交互和执行各种任务的主要接口。它配备了默认的护栏。

系统聊天代理的所有权由 Quick 管理员管理。管理员可以使用[自定义权限](https://docs.aws.amazon.com/quicksuite/latest/userguide/create-custom-permissions-profile.html)禁用与聊天代理（包括系统聊天代理）的聊天。如果启用，具有非管理员角色（作者和读者）的用户可以查看、列出、调用和使用快速聊天代理。其响应是根据用户对资产的权限进行筛选的。

Quick 系统聊天代理设置为开箱即用所有聊天功能，只需进行最少的自定义。虽然这些功能也适用于自定义聊天代理，但必须在聊天代理创建期间对其进行配置。系统聊天代理包括：
+ 默认角色为 Quick 助手，具有专业的语气和回应风格
+ 已启用聊天文件上传功能
+ 已启用大型语言模型 (LLM) 知识聊天
+ 使用管理员控制台中为聊天配置的默认护栏
+ 基于用户权限访问所有空间、主题、仪表板、知识库和操作
+ 网络搜索功能

要了解如何以管理员所有者的身份自定义系统聊天代理，请参阅[管理聊天代理自定义](https://docs.aws.amazon.com/quicksuite/latest/userguide/manage-agent.html)。要了解如何控制对系统聊天代理的访问权限，请参阅[管理资产](https://docs.aws.amazon.com/quicksuite/latest/userguide/manage-qs-assets.html)。

# 自定义聊天代理
<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. 然后，在要共享的聊天代理的 “**操作**” 列中，选择菜单图标，然后选择**删除**。

# 聊天代理上下文来源和最佳实践
<a name="agent-knowledge-sources-best-practices"></a>

在 Amazon Quick 中创建自定义聊天代理时，您可以通过多种选项来影响聊天代理行为和框架聊天代理工作流程。配置聊天代理上下文和说明的方式会显著影响聊天代理的表现和对用户交互的响应。了解何时使用说明、参考文档和空间，对于创建有效的聊天代理以满足您的特定业务需求并提供一致、可靠的结果至关重要。以下各节概述了如何最好地将聊天代理上下文和知识用于您的用例。

**Topics**
+ [代理上下文的类型](#knowledge-source-types)

## 代理上下文的类型
<a name="knowledge-source-types"></a>

Amazon Quick 提供了三种不同的方法来配置聊天代理行为，每种方法在聊天代理开发中都有不同的用途。了解每种方法如何处理内容以及何时使用它们构成了有效的聊天代理配置的基础。

Amazon Quick 中提供的三种上下文类型是：
+ **角色说明** — Amazon Quick 使用生成式增强的高级指导 AI
+ **参考文档** — 提供准确说明并在聊天代理记忆中保持活跃状态的文档
+ **空间** — 可搜索的 Amazon Quick 资源和文档的集合，聊天代理可以从中检索信息来回答问题

下一节将详细介绍这些内容以及使用它们的最佳实践。

**Topics**
+ [聊天代理角色说明](#agent-instructions)
+ [聊天代理参考文档](#in-context-files)
+ [聊天代理和聊天室](#spaces)

### 聊天代理角色说明
<a name="agent-instructions"></a>

创建自定义聊天代理时，您可以在**角色说明**字段中提供聊天代理角色说明。这些角色说明使用生成式 AI 进行完善，以确保它适用于为聊天代理配置的所有聊天功能和资源。当你想让系统建立在你的基本方向上时，这种方法是理想的选择。当您使用角色说明时，Amazon Quick 使用生成式AI在后端解释和扩展您的角色指令，通过其他背景和功能来增强简单指导，优化提示以提高聊天代理性能，并通过AI以此为导向的改进来提高效率。

**使用角色说明来：**
+ 提供有关行为和目标的高级指导，Amazon Quick AI 增强了这些指导以自定义代理响应
+ 指导如何利用参考文档进行详细互动
+ 在回复中提供有关使用空格和动作连接器的一般指导

这种方法最适合通用聊天代理和探索性用例，在这些用例中，您希望从聊天代理设计AI方面的帮助中受益。

**注意**  
AI增强过程可能会修改您的原始措辞和结构，以提高聊天代理的性能。必须保持不变的关键指导方针应改为放在参考文件中。

### 聊天代理参考文档
<a name="in-context-files"></a>

参考文档提供了聊天代理需要遵循的特定流程和响应模板。这些参考文档是聊天代理永久上下文的一部分，并 hand-in-hand附有角色说明和响应风格，为其整体行为提供信息。

参考文档通过完全按照书面内容保留您的内容，从而完全控制聊天代理的行为。当精度和一致性至关重要时，这种方法是必不可少的。当您上传参考文档时，Amazon Quick 会保留精确的措辞和具体说明，保持精确的格式和结构，直接控制聊天代理行为，并确保所有互动的一致性。

**需要时使用参考文档：**
+ 精确控制必须保留精确措辞和具体说明的地方
+ 品牌与特定语气、术语或回应格式的一致性
+ 复杂的工作流程，包含多步流程，必须遵循精确的顺序
+ 行为可预测，在所有互动中都具有一致的响应

**支持的文件格式：**
+ `.pdf`, `.txt``.html`, `.md` — 说明、模板和指南
+ `.csv`— 参考数据、查询表和示例
+ `.doc`，`.docx`— 详细的流程文档

您最多可以附加 10 个总大小为 50 MB 的文件作为参考文档。Amazon Quick 从这些文档中提取文本，并在处理后应用 10 万个字符的限制。

**文件优先级和行为**  
即使用户附加了替代内容，行为框架和文件中的参考数据仍处于活动状态。
如果用户提供的格式说明相互冲突，则可以临时调整响应模板。

参考文档充当聊天代理的操作手册，提供了在用户与聊天代理的所有交互中保持不变的行为框架。

### 聊天代理和聊天室
<a name="spaces"></a>

Spaces 提供动态、可搜索的知识库，聊天代理可在对话期间查询以检索特定信息。当您将聊天室链接到聊天代理时，Amazon Quick 聊天代理会在空间中寻找答案以生成回复。Spaces 擅长管理随着时间的推移而演变的组织知识，允许多个团队成员贡献和更新信息，同时通过 Amazon Quick 的权限系统保持适当的安全边界。

使用带有聊天代理的空间用于：
+ 使聊天代理能够搜索和检索当前的业务数据
+ 为聊天代理提供对组织知识库的访问权限
+ 允许聊天代理尊重现有的权限边界
+ 将聊天代理连接到协作文档集
+ 允许聊天代理访问定期更新的信息
+ 允许聊天代理查询实时仪表板和数据集

空间充当聊天代理的动态知识层，允许实时访问组织信息，同时保持安全边界和协作工作流程。

# 使用聊天代理
<a name="use-agents"></a>

您可以使用 Amazon Quick 聊天代理提问和完成任务。当您提问时，聊天代理会分析与您共享的最新批准数据，以生成全面的回复。

您可以用通俗易懂的语言提出复杂的问题并得到详细的回复。您还可以使用快速聊天代理为您执行任务，例如起草电子邮件、创建工单或使用流程。

**使用自定义聊天代理**

1. 登录 Quick 控制台。

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

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

   这将打开一个聊天界面，您可以使用该界面与聊天代理进行交互。

您可以通过以下方式与聊天代理互动：
+ 查看和访问示例提示以演示可能的问题和任务
+ 从组织数据源获取情境响应
+ 继续或开始新的对话
+ 分析数据，包括汇总和比较分析
+ 采取诸如安排会议和创建门票之类的操作
+ 查看带有可点击编号参考文献的回复的源引文
+ 上传文件
+ 查看对话历史记录

**提示**  
您还可以在使用 Quick Flows 自动执行日常任务时使用聊天代理。有关更多信息，请参阅 [聊天代理](ai-response-steps.md#chat-agent-step)。

要了解有关使用聊天代理聊天的更多信息，请参阅[使用 Amazon 快速聊天](https://docs.aws.amazon.com/quicksuite/latest/userguide/using-quick-chat.html)。