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

# 自定义内容
<a name="customizations"></a>

使用 Amazon Quick，您可以为使用应用程序中嵌入的 Amazon Web Services 管理控制台 或 Quick 控制台的用户创建自定义体验。

目前，控制台和 Quick API 中分别提供了用于自定义 Quick 的不同选项。接下来，您将了解有关可用选项的信息。

目前可使用以下自定义选项：
+ 您可以自定义 Quick 为新用户提供的欢迎内容：
  + 您可以接受或拒绝示例资产。这些资产包括用户首次登录时添加的示例数据集和分析。
  + 您可以显示或隐藏默认的简介视频。这些视频包括为新用户显示的动画以及在 Amazon Quick 主页上显示的教程视频。
+ 您可以创建和指定默认主题。
+ 您可以通过编辑电子邮件模板来自定义仪表板报告电子邮件、像素完美报告电子邮件和提醒电子邮件。

**重要**  
所有自定义设置仅适用于您在 Amazon Web Services 区域 API 中使用的或在 Amazon Quick 控制台中选择的。

要查看区域设置，可以使用以下过程之一。

**要 Amazon Web Services 区域 在 Amazon Quick 控制台上查看你的**

1. 选择右上角的配置文件图标打开菜单。

1. 在位置图标旁边查看您当前 Amazon Web Services 区域的列表。

1. （可选） Amazon Web Services 区域 从菜单中选择另一个以切换到该区域。完成自定义后，请记得改回原来的区域。

**要检查您的 Amazon Web Services 区域 使用情况 Amazon CLI**
+ 在命令行上，输入以下命令并按 Enter 查看当前设置。

  ```
  aws configure list
  ```

  要重新配置默认区域，请使用 `aws configure` 命令。

要保留默认区域，可以向大多数 CLI 命令中添加 `--region` 参数。

**Topics**
+ [

# Amazon Quick 品牌定制
](brand-customization.md)
+ [

# 在 Amazon Quick 中自定义聊天代理
](manage-agent.md)

# Amazon Quick 品牌定制
<a name="brand-customization"></a>

Amazon Quick 允许账户管理员自定义其应用程序的品牌和视觉主题，使其符合其组织的指导方针。此自定义包括以下视觉元素，用于在所有非管理的 Amazon Quick 控制台页面、日程安排、提醒和电子邮件报告中创建统一的外观。
+ Logo
+ 网页图标
+ 视觉资产的关联替代文本

以下列表显示了可自定义主题颜色所分组的不同区域。

**品牌颜色**
+ **全局导航栏**的颜色应用于 Amazon Quick 用户界面中最顶部的栏，包括标准和嵌入式 Amazon Quick 控制台中显示的公司徽标。
+ **应用程序栏**颜色应用于包含上下文操作的辅助导航栏。

**交互颜色**
+ **强调**颜色应用于按钮、边框和图标等交互元素。

**表面颜色**
+ **原色**应用于高强度表面，例如主页背景和文本。
+ **间色**应用于实际表面，例如边框、背景和表单域。间色与原色一起使用。

**状态颜色**
+ **成功**颜色应用于成功消息。
+ **危险**颜色应用于错误消息。
+ **警告**颜色应用于警告消息。
+ **信息**颜色应用于信息性消息。

**数据可视化颜色**
+ **维度**颜色用于标识具有相同角色的数据列之间的关联。
+ **度量**颜色用于标识指标或测量值。

**功能**
+ **可视化**颜色应用于**可视化**图标。
+ “**洞察**” 颜色应用于 “**洞察**” 图标。
+ **连接**颜色应用于 “**连接**” 图标。
+ **自动化**颜色应用于 “**自动化**” 图标。

使用以下章节开始在 Amazon Quick 中进行品牌定制。

**Topics**
+ [

## Amazon Quick 品牌定制权限
](#brand-customization-permissions)
+ [

## 在 Amazon Quick 中创建自定义品牌
](#brand-customization-create)
+ [

# 使用 Amazon Quick 为 Amazon Quick 分析设置默认主题 APIs
](customizing-quicksight-default-theme.md)

## Amazon Quick 品牌定制权限
<a name="brand-customization-permissions"></a>

要设置品牌，必须通过 IAM Identity Center 或 IAM 向您授予管理员角色。在 Amazon Quick 中被授予角色的管理员无法创建品牌。要详细了解如何将您的账户与 IAM 身份中心集成，请参阅使用 IAM [身份中心配置您的 Amazon Quick 账户](https://docs.amazonaws.cn/quicksight/latest/user/sec-identity-management-identity-center.html)。有关管理员角色和权能的信息，请参阅[了解 Amazon Quick 订阅和角色](https://docs.amazonaws.cn/quicksight/latest/user/user-types.html#subscription-role-mapping)。

管理员用户只能管理与其 Amazon Quick 账户位于相同容量区域的品牌。

您用于在 Amazon Quick 中创建品牌的 IAM 角色必须包含`quicksight:*`或精细的操作权限，才能在管理员控制台中管理品牌。管理员需要以下精细权限才能使用 Amazon Quick 品牌：
+ `quicksight:CreateBrand`
+ `quicksight:UpdateBrand`
+ `quicksight:DescribeBrand`
+ `quicksight:DescribeBrandPublishedVersion`
+ `quicksight:UpdateBrandPublishedVersion`
+ `quicksight:DeleteBrand`
+ `quicksight:ListBrands`
+ `quicksight:UpdateBrandAssignment`
+ `quicksight:DescribeBrandAssignment`
+ `quicksight:DeleteBrandAssignment`

确认您的管理员角色包含所需权限后，您可以在 Amazon Quick 管理控制台中[创建自定义品牌](https://docs.amazonaws.cn/quicksight/latest/user/brand-customization-create.html)。

## 在 Amazon Quick 中创建自定义品牌
<a name="brand-customization-create"></a>

使用以下步骤在 Amazon Quick 中创建自定义品牌。

1. 打开 [Quick 控制台](https://quicksight.aws.amazon.com/)。

1. 选择右上角的用户图标，然后选择**快速管理**。

1. 选择**自定义应用程序**。

1. 在打开的**自定义应用程序**页面上，选择**添加品牌**。将打开**品牌设置**页面。

1. 导航至**品牌信息**部分。

1. 对于**品牌名称**，输入品牌的名称。品牌名称最多可包含 512 个字符。

1. （可选）在**品牌描述**中，输入自定义品牌的描述。品牌描述最多可包含 512 个字符。

1. 导航到**徽**标部分。  
![\[品牌信息页面的徽标部分。\]](http://docs.amazonaws.cn/quick/latest/userguide/images/logo.png)

1. 对于 “**主要**”，选择主图标旁边的省略号（三个点），然后选择 “**替换图像**”。

1. 在打开的**选择图像**弹出窗口中，执行以下操作之一：

   1. 将图像拖放到**将图像拖到此处**框中。

   1. 选择**选择文件**从您的计算机中选择一个文件。

   1. 在文本栏中输入公共 URL 或 Amazon S3 URI。

   您选择的图像必须是 `.jpeg`、`.png` 或 `.svg` 格式，且大小不能超过 1MB。

   选择完图像后，选择**应用**。

1. 对于**网页图标**，选择网页图标旁边的省略号（三个点），然后选择**替换图像**。

1. 在打开的**选择图像**弹出窗口中，执行以下操作之一：

   1. 将图像拖放到**将图像拖到此处**框中。

   1. 选择**选择文件**从您的计算机中选择一个文件。

   1. 在文本栏中输入公共 URL 或 Amazon S3 URI。

   您选择的图像必须是 `.jpeg`、`.png` 或 `.svg` 格式，且大小不能超过 1MB。

   选择完图像后，选择**应用**。

1. （可选）对于**替代文本**，请输入要与徽标一起显示的替代文本。替代文本最多可包含 512 个字符。

1. 要更改品牌的主题颜色，请导航至左侧的**外观**窗格并选择**主题**。

1. **模版设置**页面将出现，并显示可自定义的 Amazon Quick 主题的所有部分。下图显示了全局导航栏的配置设置。  
![\[全局导航栏的配置设置。使用背景和前景色板来自定义主题设置页面上列出的每个主题项目的颜色。\]](http://docs.amazonaws.cn/quick/latest/userguide/images/navigation-bar.png)

1. 要更改某个区域的背景颜色，请导航到要更改的项，然后选择**背景**颜色样本。

1. 在出现的**自定义颜色**弹出窗口中，从颜色渐变中选择一种颜色或在**十六进制**栏中输入十六进制代码值，然后选择**应用**。

1. 要更改某个区域的前景颜色，请导航到要更改的项，然后选择**前景**颜色样本。

1. 在出现的**自定义颜色**弹出窗口中，从颜色渐变中选择一种颜色或在**十六进制**栏中输入十六进制代码值，然后选择**应用**。

1. 配置完自定义品牌后，选择 PUBLISH 进行**发布**，并将品牌自定义应用于所有 Amazon Quick 用户账户。如果您不想发布品牌，请选择 “**保存**” 以保存品牌以备后用。

在 Amazon Quick 中完成品牌创建后，新品牌将显示在 Quick 管理控制台的 “**自定义” 应用程序**页面的品牌表中。品牌表的**状态**列显示了当前发布到Quick账户的品牌。要更改自定义品牌，请在品牌表中找到要更改的品牌，选择**操作**列中的省略号（三个点）图标，然后选择**发布**、**编辑**或**删除**。

发布品牌后，新品牌最多可能需要 10 分钟才能在所有用户中传播。

# 使用 Amazon Quick 为 Amazon Quick 分析设置默认主题 APIs
<a name="customizing-quicksight-default-theme"></a>

**使用 API 设置默认主题**

1. 确定要用作默认主题的自定义主题，并找到其主题 ID。如果您想使用其中一个 QuickSight 入门主题，请跳过此步骤。

   要获取自定义主题的主题 ID，请使用该主题所在区域的 [ListThemes](https://docs.amazonaws.cn//quicksight/latest/APIReference/API_ListThemes.html)API 操作。确保主题与需要使用该主题的用户或组位于同一区域。

   以下示例显示了 Amazon CLI中使用 `list-themes` 命令的 shell 脚本。它设置 Amazon 账户 ID 和 a Amazon Web Services 区域 s 变量。如果您之前曾使用 `aws configure` 设置默认区域，则在命令中添加 `--region` 变量会覆盖您的默认设置。

   ```
   #declare variables
   awsacct1='111122223333'
   region='us-west-2'
   
   aws quicksight list-themes \
   --region $region \
   --aws-account-id $awsacct1 \
   --type 'CUSTOM'
   ```

   

1. 使用[ListUsers](https://docs.amazonaws.cn//quicksight/latest/APIReference/API_ListUsers.html)或 [ListGroups](https://docs.amazonaws.cn//quicksight/latest/APIReference/API_ListGroups.html)API 操作收集需要使用默认主题的用户或群组的 Amazon 资源名称 (ARNs)。您只需要顶级 ARN。如果您的所有用户都属于同一个组，请使用组 ARN。

   有关 Amazon Quick 的更多信息 ARNs，请参阅快*速 API* 参考中的 [ARN 格式](https://docs.amazonaws.cn//quicksight/latest/APIReference/qs-arn-format.html)。

1. 如果您使用的是自定义主题，请授予您在上一步中收集 ARNs 的主题的访问权限。如果您使用的是入门主题，请跳过此步骤，因为所有用户都有权访问入门主题。

   以下示例显示了使用[update-theme-permissions](https://docs.amazonaws.cn//quicksight/latest/APIReference/API_UpdateThemePermissions.html)命令的 shell 脚本。`grant-permissions`参数使用速记语法显示。您可以使用 JSON 或 YAML。有关更多信息，请参阅《Amazon Command Line Interface 用户指南》**中的[指定参数值](https://docs.amazonaws.cn/cli/latest/userguide/cli-usage-parameters.html)。

   ```
   #declare variables
   awsacct1='111122223333'
   namespace='default'
   region='us-west-2'
   theme-id='bdb844d0-0fe9-4d9d-b520-0fe602d93639' #Find this with list-themes
   
   aws quicksight update-theme-permissions \
   #Specify region if necessary: --region $region \
   --aws-account-id $awsacct1 \
   --theme-id $theme-id \
   --grant-permissions Principal="arn:aws:quicksight:$region:$awsacct1:group/$namespace/QuickSight_Group_Name",Actions="quicksight:DescribeTheme","quicksight:ListThemeVersions","quicksight:ListThemeAliases","quicksight:DescribeThemeAlias"
   ```

1. 将主题指定为相同 ARN 的默认主题或。 ARNs

   ```
   #declare variables
   awsacct1='111122223333'
   namespace='default'
   region='us-west-2'
   theme-id='bdb844d0-0fe9-4d9d-b520-0fe602d93639'
   
   aws quicksight create-account-customization \
   #Specify region if necessary: --region $region \
   --aws-account-id $awsacct1 \
   --namespace $namespace \
   --account-customization DefaultTheme="arn:aws:quicksight:$region:$awsacct1:theme/$theme-id"
   ```

目前，有三个入门主题：Classic、Midnight 和 Seaside。它们 ARNs 是主题名称的大写拼写。如果您使用的是入门主题而不是自定义主题，请使用以下主题之一 ARNs：
+ `arn:aws:quicksight::aws:theme/CLASSIC`
+ `arn:aws:quicksight::aws:theme/MIDNIGHT`
+ `arn:aws:quicksight::aws:theme/SEASIDE`
+ `arn:aws:quicksight::aws:theme/RAINIER`

# 在 Amazon Quick 中自定义聊天代理
<a name="manage-agent"></a>

当用户帐户订阅 Quick 时，该服务会自动创建系统默认聊天代理。该代理支持默认聊天体验，允许 Amazon Quick 用户开箱即用地利用所有聊天功能（例如上传文件进行聊天、使用大型语言模型 (LLM) 参数知识以及从企业数据中回答）。管理员指定为代理所有者的一组精选用户可以在 Amazon Quick 代理部分更新系统默认聊天代理。

所有聊天代理（包括系统和自定义）以及流量还配备了护栏和安全控制装置，以确保负责任地使用。您与之聊天的任何代理或流程都将使用以下默认护栏来支持聊天互动：
+ **提示泄漏保护**-自动启用以防止提示注入和其他破坏 LLM 的攻击。
+ **即时安全** — 防范常见的安全威胁，例如恶意指令、忽略护栏的指令等。
+ **屏蔽的单词和短语** — 针对聊天请求和回复提供防范不当内容，包括侮辱、仇恨言论、色情内容、暴力和不当行为。

作为管理员，您可以为所有 Amazon Quick 聊天代理定义屏蔽的短语。如果您这样做，Amazon Quick 会确保聊天代理和 Amazon Quick 实例上的流响应不包含这些单词或短语。默认情况下，不会将任何被屏蔽的单词或短语分配给您的聊天代理或流程。您最多可以选择 50 个要屏蔽的单词或短语。

管理员还可以配置聊天回复是显示为可点击的超链接还是 URLs 纯文本。此设置适用于实例中的所有聊天代理和聊天流程，允许您控制向用户显示链接的方式。

**注意**  
管理员还可以控制用户是否可以创建和使用聊天代理和聊天流程的权限。有关如何执行此操作的说明，请参阅[自定义权限](https://docs.amazonaws.cn/quicksuite/latest/userguide/create-custom-permissions-profile.html)。

以下各节概述了如何编辑系统默认代理以及如何为聊天添加屏蔽词以影响所有代理的响应和流程。

**Topics**
+ [

## 授予用户编辑系统默认聊天代理的权限
](#edit-default-agent-permissions)
+ [

## 编辑系统聊天代理设置
](#edit-default-agent)
+ [

## 在聊天回复中配置可点击的外部链接
](#configure-clickable-links)
+ [

## 为聊天代理添加屏蔽的单词和短语
](#general-agent-settings)
+ [

## 为聊天代理和聊天流程编辑屏蔽的单词和短语
](#edit-general-agent-settings)

## 授予用户编辑系统默认聊天代理的权限
<a name="edit-default-agent-permissions"></a>

管理员指定为该代理所有者的用户可以在管理员控制台中编辑系统默认聊天代理。以下过程说明如何向用户授予管理员权限，以便他们可以编辑系统默认代理。

**授予编辑系统默认代理的权限**

1. 登录 Amazon Quick 控制台。

1. 从 Amazon **Quick 管理**控制台中选择 “快速管理”。

1. 在管理员控制台的左侧导航菜单中，选择**账户**，然后选择**管理资产**。

1. 在**管理资产**中，选择**聊天代理**。

1. 从显示的聊天代理列表中选择 “**我的助手**”。然后，从 “**操作**” 菜单中选择 “**共享**”。

1. 在**共享资产**模式中，使用**用户或群组**搜索栏查找要指定为系统代理所有者的用户或群组。

1. 然后，从 “**权限**” 中选择 “**所有者**”。然后，选择 “**共享**”。

## 编辑系统聊天代理设置
<a name="edit-default-agent"></a>

要自定义您的系统聊天代理，指定为所有者的用户需要登录 Amazon Quick 并访问代理库页面。管理员可以直接访问此页面，方法是点击管理员控制台中**聊天**代理自定义下的转到**代理**链接。进入 Amazon Quick 后，请按照以下步骤编辑系统默认聊天代理的属性。您可以在配置系统代理时预览和测试其工作原理。

**更新系统聊天代理设置**

1. 登录 Amazon Quick 控制台。

1. 从 Amazon **Quick 管理**控制台中选择 “快速管理”。

1. 在管理员控制台的左侧导航菜单中，选择**自定义**，然后选择**聊天代理自定义**。

1. 在 “**聊天代理自定义**” 中，在 “**系统聊天代理**” 中，选择 “**前往聊天代理**”。

1. 在 “**我的助手**” 页面的 “**配置聊天代理**” 中，自定义以下部分：

   1. 在**聊天代理角色中，**配置聊天代理的个性、身份、语气和回应风格。有关代理自定义选项的详细信息，请参阅《*Amazon 快速用户指南*》中的[使用聊天代理](https://docs.amazonaws.cn/quicksuite/latest/userguide/working-with-agents.html)。
**注意**  
该代理允许该账户的所有用户进行默认的聊天互动，并具有聊天功能访问权限。确保您的指示（例如身份和回复方式）适用于该账户的所有用户。

   1. 在**参考文档**中，上传聊天代理内存中保持活跃状态的文件，以指导所有互动。有关文件上传选项的详细信息，请参阅《*Amazon 快速用户指南*》中的[使用聊天代理](https://docs.amazonaws.cn/quicksuite/latest/userguide/working-with-agents.html)。
**注意**  
由于此代理旨在广泛使用，因此这里是上传企业级响应模板和指南的地方。  
系统默认代理未链接到特定的知识来源、操作或空间，以确保它适用于所有用户，无论其访问权限如何。无法更改此设置。

1. 在 “**自定义**” 中，配置详细信息以帮助识别聊天代理。有关自定义选项的详细信息，请参阅《*Amazon 快速用户指南*》中的[使用聊天代理](https://docs.amazonaws.cn/quicksuite/latest/userguide/working-with-agents.html)。

## 在聊天回复中配置可点击的外部链接
<a name="configure-clickable-links"></a>

管理员可以配置聊天代理 URLs 中的回复是否显示为可点击的超链接。以下过程向您展示如何为 Amazon Quick 实例中的所有聊天代理启用可点击的超链接。

**启用可点击的外部链接**

1. 登录 Amazon Quick 控制台。

1. 从 Amazon **Quick 管理**控制台中选择 “快速管理”。

1. 在管理员控制台的左侧导航菜单中，选择**自定义**，然后选择**聊天代理自定义**。

1. 在 **“可点击的外部链接”** 下，打开开关。

## 为聊天代理添加屏蔽的单词和短语
<a name="general-agent-settings"></a>

默认的护栏和管理员提供的屏蔽词是所有聊天代理和流程在用户与他们聊天时都会考虑的常规设置。管理员配置的屏蔽单词会从聊天代理和您的 Amazon Quick 实例中的流程中的回复中过滤掉。

要了解有关聊天代理的更多信息，请参阅《*Amazon 快速用户指南*》中的[使用聊天代理](https://docs.amazonaws.cn/quicksuite/latest/userguide/working-with-agents.html)。

**为所有聊天代理分配屏蔽的单词和短语**

1. 登录 Amazon Quick 控制台。

1. 选择 “**快速管理**”。

1. 从左侧导航菜单中选择 “**自定义**”，然后选择 “**聊天代理自定义**”。

1. 在 **Chat 代理自定义设置**中，对于**护栏和安全控件**，请执行以下操作：

   1. **添加屏蔽的单词和短语**-选择 “**添加**” 以添加屏蔽的单词和短语。您最多可以添加 50 个单词和短语。

## 为聊天代理和聊天流程编辑屏蔽的单词和短语
<a name="edit-general-agent-settings"></a>

要编辑添加到聊天代理和聊天流程中的屏蔽单词和短语，请按以下步骤操作。

**为所有聊天代理和聊天流程编辑屏蔽的单词和短语**

1. 登录 Amazon Quick 控制台。

1. 选择 “**快速管理**”。

1. 从左侧导航菜单中选择 “**自定义**”，然后选择 “**聊天代理自定义**”。

1. 在**聊天代理自定义**中，对于**护栏和安全控件**，请执行以下操作：

   1. **添加屏蔽的单词和短语**-选择 “**删除**” 可删除现有的屏蔽单词和短语。或者，选择 “**添加**” 以添加新的。您最多可以添加 50 个单词和短语。