创建自定义聊天代理共享自定义聊天代理更新自定义聊天代理管理员对聊天代理的访问权限查看聊天代理查看聊天代理详情重复的自定义聊天代理删除聊天代理

自定义聊天代理

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

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

Quick Suite 管理员必须向用户授予创建聊天代理的权限。有关哪些角色可以创建聊天代理的信息，请参阅 Amazon Quick Suite 定价文档。有关如何提供或限制对这些功能的访问权限的信息，请参阅 Quick Suite 管理员指南中的自定义权限。

创建和预览自定义聊天代理

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

Using natural language

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

登录 Amazon Quick Suite 控制台。
在左侧导航菜单中，选择聊天代理，然后选择创建聊天代理。
在 “新建聊天代理” 中，执行以下操作：
1. 在文本输入框中，输入要创建哪种聊天代理的自然语言描述。这是 Amazon Quick Suite 用来创建聊天代理的提示。您也可以使用页面上建议的示例说明来创建聊天代理。
2. 然后，选择 “生成”。选择 “生成” 将获取提供的说明或目标，并将其扩展为聊天代理说明和配置。它还会扫描用户的可用资源（空格和操作连接器），并根据提供的聊天代理意图找到最相关的匹配项。使用这些配置打开扩展的构建器用户界面，供用户查看、自定义、测试和启动。
在 “配置聊天代理” 页面上，确保您的聊天代理设置正确，并进一步自定义您的聊天代理。单击 “更新预览”，确保在预览版中试用聊天代理之前，所有更改都已保存。
准备就绪后，选择 “启动聊天代理”，将您的自定义聊天代理发布到聊天代理库并在聊天中使用。
注意
- 在您选择 “启动聊天代理” 之前，您的聊天代理在聊天代理库中不可用。如果您在未启动的情况下退出创建过程，则预览版将被删除，聊天代理也不会保存。
- 当您启动聊天代理时，它默认保持私密状态。只有在您共享聊天代理后，该聊天代理才会在其他用户的资源库中可用。共享后，后续的编辑和启动将向所有有权访问的用户发布对同一个聊天代理的更改。

Using builder view directly

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

登录 Amazon Quick Suite 控制台。
在左侧导航菜单中，选择聊天代理，然后选择创建聊天代理。
在代理创建器中，选择跳过。这将打开聊天代理配置页面，您可以从中构建和自定义聊天代理。
为您的自定义聊天代理添加一个名称。这是用来识别您的聊天代理的名字。
（可选）为您的自定义聊天代理添加描述，以帮助用户了解聊天代理的用途。
（可选）为您的聊天代理选择一个图标。
在配置聊天代理中，自定义以下部分：
1. 在 AGENT PERSONA 中，配置聊天代理的个性、身份、语气和回应风格：
  - 对于代理身份 — 定义聊天代理的身份。例如，你可以给它说明它的名字和个性。如果留空，Amazon Quick Suite 将使用默认值。
  - 有关角色配置说明 — 添加有关聊天代理在聊天期间如何与用户互动的说明。例如，您可以定义聊天代理的主要任务是什么。Amazon Quick Suite 使用它们来自定义聊天代理的角色。
2. 在 “沟通风格” 中，对于 “选择回应样式” 预设 — 选择回应风格。您可以在以下响应样式预设之间进行选择，也可以添加自定义说明：
  - 高管 — 针对高级业务沟通和战略见解进行了优化。
  - 技术-针对详细的技术解释和技术问题解决进行了优化。
  - 创意-通用交互的标准配置。
  每个预设都有以下设置：
  - Fo r Ton e — 添加自然语言提示来定义代理的语气。Amazon Quick Suite 将使用它来自定义你的聊天代理的角色。
  - 对于响应格式-添加自然语言提示以定义聊天代理的响应风格。Amazon Quick Suite 将使用它来定制你的聊天代理的回复风格。定义聊天代理回复的格式，例如：“对于长于 3 个项目的列表，使用要点”。
  - 长度 — 指定聊天代理的回复时长。定义聊天代理回复的长度，例如：“将答案保持在 100 字以内”。
  当您选择要使用的预设时，Amazon Quick Suite 会根据所选样式自动填充聊天代理回复的语气、响应格式和长度说明。您可以使用自然语言进一步自定义现有提示，也可以创建新的提示。
3. 在参考文档中，上传聊天代理内存中保持活跃状态的文件，以指导所有互动。有关参考文档如何与其他上下文类型配合使用的更多信息，请参阅代理上下文的类型。
  - 选择 “上传文件” 或拖放您的文档以附加文件，这些文件将指导您的聊天代理的回复。
  - 您可以附加.pdf、.txt、.html、.md、.csv、.doc 或.docx 格式的文档。将从上传的文档中提取并接受多达 100,000 个字符的文本。
（可选）在知识源中，在以下选项之间进行选择：
- 在不链接知识来源的情况下继续
  - 您的聊天代理将根据大型语言模型 (LLM) 知识以及互动用户可以访问的所有 Amazon Quick Suite 资源生成响应。您可以选择在聊天期间选择要重点关注的特定知识来源。如果您想创建通用聊天代理，请选择此选项。
- 链接特定的现有空间
  - 选择 “链接”。
  - 在 “链接空间” 模式中，选择要链接到聊天代理的空间，然后选择 “链接”。
    
    系统会显示一条成功消息，表示链接成功。
    
    如果您将聊天代理链接到知识来源，则聊天代理将仅根据大型语言模型 (LLM) 知识生成响应，并仅从链接的资源生成数据。在聊天过程中，您最多可以向该聊天代理再添加 1 个知识源作为临时上下文。
- 创建和链接新空间
  - 选择创建。
  - 在打开的 “创建空间” 窗口中，选择要添加到空间的资源，然后选择 “创建”。
    
    如果您将聊天代理链接到知识来源，则聊天代理将仅根据大型语言模型 (LLM) 知识生成响应，并仅从链接的资源生成数据。在聊天过程中，您最多可以向该聊天代理再添加 1 个知识源作为临时上下文。
    
    注意
    有关创建和使用空间的更多信息，请参阅在 Amazon Quick Suite 中使用空间。
    
    系统将显示一条成功消息，表示成功创建了空间。返回聊天代理创建窗口。
  - 在聊天代理创建窗口中，从知识源中选择链接。
  - 从 “链接空间” 模式中，选择您刚刚创建的空间，然后选择 “链接”。
    
    系统会显示一条成功消息，表示链接成功。
（可选）在 “操作” 中，对于 “操作”-在以下选项中进行选择：
- 链接特定的现有操作
  - 选择 “链接”。
  - 在 “链接操作连接器” 模式中，选择要链接到聊天代理的操作连接器，然后选择 “下一步”。
  - 在 “操作” 中，选择要添加的操作，然后选择 “链接”。
    
    系统会显示一条成功消息，表示链接成功。
- 创建操作连接器并链接新操作
  - 选择创建。
  - 在 “操作” 主页上，选择 “新建操作”。
  - 在 “新建” 操作窗口中，为 “源” 选择要添加的操作连接器，然后选择 “下一步”。
  - 在 “操作” 中，查看可用的操作，然后选择 “下一步”。
  - 在连接详细信息中，输入所需的连接详细信息，然后选择添加。
    
    注意
    有关创建和使用操作连接器的更多信息，请参阅 Amazon Quick Suite 中的操作。
    
    系统将显示一条成功消息，表示成功添加了操作。返回聊天代理创建窗口。
  - 在聊天代理创建窗口中，从 “操作” 中选择 “链接”。
  - 从 “链接操作连接器” 模式中，选择您刚刚创建的操作连接器，然后选择 “链接”。
    
    系统会显示一条成功消息，表示链接成功。
在 “自定义” 中，执行以下操作：
1. 对于欢迎消息 — 添加一条欢迎消息，让聊天代理向最终用户显示。
2. 对于建议的提示 — 添加示例提示作为对话开头，告知最终用户聊天代理功能。
选择 “启动聊天代理” 以创建您的自定义聊天代理。
注意
- 在您选择 “启动聊天代理” 之前，您的聊天代理在聊天代理库中不可用。如果您在未启动的情况下退出创建过程，则预览版将被删除，聊天代理也不会保存。
- 当您启动聊天代理时，它默认保持私密状态。只有在您共享聊天代理后，该聊天代理才会在其他用户的资源库中可用。共享后，后续的编辑和启动将向所有有权访问的用户发布对同一个聊天代理的更改。

创建聊天代理时，默认情况下，系统会将您指定为其所有者。您可以使用以下权限选择与其他 Amazon Quick Suite 用户共享您拥有的聊天代理：

所有者权限-用户可以编辑、共享、使用和删除聊天代理。
查看者权限-用户可以查看和使用聊天代理。

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

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

共享自定义聊天代理

登录 Amazon Quick Suite 控制台。
从左侧导航菜单中，选择聊天代理
然后，在要共享的聊天代理的 “操作” 列中，选择菜单图标，然后选择 “共享”。
在打开的共享聊天代理模式中，输入您要与之共享聊天代理的用户或群组名称。当出现用户名或组名时，将其选中。对要与之共享聊天代理的所有群组或用户重复该操作。该模式显示您要添加的用户和群组。
使用用户名或群组名称旁边的下拉菜单，为您与之共享聊天代理的每个用户或群组分配权限和访问信息。您可以分配以下两个角色之一：
- 所有者-用户可以编辑、共享和删除聊天代理。
- 查看器-用户可以查看和使用聊天代理。
选择共享。

更新自定义聊天代理

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

注意

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

更新自定义聊天代理

登录 Amazon Quick Suite 控制台。
从左侧导航菜单中，选择聊天代理
然后，在要共享的聊天代理的 “操作” 列中，选择菜单图标，然后选择 “编辑”。这将创建聊天代理的预览版本，以便在发布之前进行更新和测试。
在编辑代理中，更新您的聊天代理设置，然后选择启动。

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

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

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

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

查看聊天代理

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

查看自定义聊天代理

登录 Amazon Quick Suite 控制台。
从左侧导航菜单中，选择聊天代理
您已创建或有权访问的聊天代理将显示在聊天代理主页上。

查看聊天代理详情

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

查看聊天代理详情

登录 Amazon Quick Suite 控制台。
从左侧导航菜单中，选择聊天代理
然后，从聊天代理列表的 “名称” 列中，单击要查看其详细信息的聊天代理的名称。详情模式将打开。

注意
您还可以通过导航到要共享的聊天代理的 “操作” 列，选择菜单图标，然后选择 “查看聊天代理详细信息” 来查看聊天代理的详细信息。
在打开的聊天代理详情模式中，您将看到以下详细信息：
1. 描述-聊天代理的描述。
2. 说明摘要-为聊天代理定义的说明摘要。
3. 创建者-有关聊天代理是由您还是他人创建的详细信息。
4. 上次修改时间-聊天代理上次修改的时间。
5. 在 “能力” 下：
  - 知识-聊天代理所连接或可以访问的知识来源。如果您的聊天代理已链接到某个空间，则可以看到该聊天代理链接到哪个空间。
  - 操作-聊天代理已连接或有权访问的操作。您也可以通过单击聊天界面代理选择器中代理名称旁边的信息来查看此信息。

重复的自定义聊天代理

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

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

复制自定义聊天代理

登录 Amazon Quick Suite 控制台。
从左侧导航菜单中，选择聊天代理
然后，在要共享的聊天代理的 “操作” 列中，选择菜单图标，然后选择 “复制”。

您将被重定向到带有预填字段的聊天代理复制模式。
根据需要进行任何更改，包括添加正确的用户和群组权限，并将其关联到所需的资产，然后选择 La unch 以启动复制的聊天代理。

删除聊天代理

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

删除自定义聊天代理

登录 Amazon Quick Suite 控制台。
从左侧导航菜单中，选择聊天代理
然后，在要共享的聊天代理的 “操作” 列中，选择菜单图标，然后选择删除。

Javascript 在您的浏览器中被禁用或不可用。

要使用 Amazon Web Services 文档，必须启用 Javascript。请参阅浏览器的帮助页面以了解相关说明。

文档惯例

系统聊天代理

自定义聊天代理上下文配置