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

# 使用操场在控制台中生成响应
<a name="playgrounds"></a>

Amazon Bedrock playgrounds 是一款工具 AWS 管理控制台 ，它提供了一个可视化界面，用于尝试在不同的模型上运行推理并使用不同的配置。您可以在将不同的模型和值集成到应用程序之前，使用操场测试这些模型和值。

在操场上运行提示等同于在 API 中发[InvokeModel](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_InvokeModel.html)出[InvokeModelWithResponseStream](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_InvokeModelWithResponseStream.html)、、[Converse](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_Converse.html) 或[ConverseStream](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_ConverseStream.html)请求。

Amazon Bedrock 提供以下操场供您尝试：
+ **聊天/文本** – 提交文本提示并生成响应，或通过语音进行交互。您可以选择以下一种模式：
  + **聊天** - 提交文本提示或通过语音进行交互。对于文本提示，您还可以添加图像或文档来补充提示的内容。您提交的后续提示将包含您之前的提示作为上下文，因此提示和响应的顺序类似于对话。
  + **单个提示** – 提交单个文本提示并生成对它的响应。
**注意**  
Speech-to-speech 诸如 Amazon Nova Sonic 之类的型号仅在聊天模式下可用。模型不支持比较 speech-to-speech模式。
+ **图像** – 提交文本提示以生成图像。您也可以提交图像提示并指定是对其进行编辑还是生成其变体。
+ **多模式（预览）**-提交文本提示并生成多模式内容。它还支持聊天和单一提示模式。

以下流程介绍了如何在操场中提交提示、您可以调整的选项以及模型生成响应后您可以采取的操作。

**使用操场**

1. 如果您还没有使用过模型，请先针对要使用的模型请求模型访问权限。有关更多信息，请参阅 [访问 Amazon Bedrock 基础模型](model-access.md)。

1. 使用有权使用 Amazon Bedrock 控制台的 IAM 身份登录。 AWS 管理控制台 然后，在 [https://console.aws.amazon.com/](https://console.aws.amazon.com/bedrock)bedrock 上打开 Amazon Bedrock 控制台。

1. 在导航窗格的 “测试” 下，选择 Playgro **und**。

1. 如果您位于**聊天/文本**操场中，请选择**模式**。

1. 选择**选择模型**，然后选择要使用的提供商、模型和吞吐量。有关增加吞吐量的更多信息，请参阅[通过跨区域推理提高吞吐量](cross-region-inference.md)和[利用 Amazon Bedrock 中的预调配吞吐量增加模型调用容量](prov-throughput.md)。

1. 提交以下信息以生成响应：
   + 提示 – 一句或几句文字，用于为模型设定场景、问题或任务。有关创建提示的信息，请参阅[提示工程概念](prompt-engineering-guidelines.md)。

     某些模型（请参阅[支持的模型和模型功能](conversation-inference-supported-models-features.md)）允许您通过以下方式包含文件：
     + 选择附件图标，然后选择要上传的文件。
     + 选择附件图标，然后选择要上传的 Amazon S3 对象。
     + 将文件拖动到提示上。

     添加文件以补充提示内容。您可以在提示文本中引用该文件。例如，您可以编写 **Summarize this document for me** 或 **Tell me what's in this image**。您可以包含以下类型的文件：
     + **文档** – 添加文档以补充提示。有关支持的文件类型的列表，请参阅中的`format`字段[DocumentBlock](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_DocumentBlock.html)。
**警告**  
文档名称容易受到提示注入的影响，因为模型可能会意外将其解读为说明。因此，我们建议您指定一个中性名称。
     + **图像** – 添加图像以补充提示内容（如果模型支持多模态图像和文本输入）。有关支持的文件类型的列表，请参阅中的`format`字段[ImageBlock](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_ImageBlock.html)。
     + **视频** – 添加视频以补充提示内容（如果模型支持多模态视频和文本输入）。有关支持的文件类型的列表，请参阅中的`format`字段[VideoBlock](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_VideoBlock.html)。
**注意**  
内容限制因底层 API 操作和模型而异。有关更多信息，请参阅 [API 限制](inference-api-restrictions.md)。
   + 配置 – 您可以调整来修改模型响应的设置。配置包含以下内容：
     + 推理参数 – 影响或限制模型生成响应的方式的值。有关更多信息，请参阅 [利用推理参数影响响应生成](inference-parameters.md)。要查看特定模型的推理参数，请参阅[基础模型的推理请求参数和响应字段](model-parameters.md)。
     + 系统提示 – 向模型提供有关它应执行的任务或应采用的角色的说明或上下文的提示。有关更多信息以及支持系统提示的模型列表，请参阅[使用 Converse API 操作进行对话](conversation-inference.md)。
     + 防护机制 – 过滤掉提示和模型响应中的有害或不需要的内容。有关更多信息，请参阅 [使用 Amazon Bedrock 护栏检测和筛选掉有害内容](guardrails.md)。

1. （可选）如果模型支持流式传输，则默认行为是流式传输响应。您可以通过选择选项图标（![\[Vertical ellipsis icon representing a menu or more options.\]](http://docs.aws.amazon.com/zh_cn/bedrock/latest/userguide/images/icons/vertical-ellipsis.png)）和修改**流式传输首选项**选项来关闭流式传输。

1. （可选）某些文本生成模型支持比较评估，您可以通过执行以下操作来比较来自不同模型的响应：

   1. 启用**比较模式**。

   1. 选择**选择模型**，然后选择要使用的提供商、模型和吞吐量。

   1. 选择配置图标（![\[Three horizontal sliders with adjustable circular controls for settings or parameters.\]](http://docs.aws.amazon.com/zh_cn/bedrock/latest/userguide/images/icons/configurations.png)）以修改要使用的配置。

   1. 要添加更多模型进行比较，请选择右侧的 \$1 图标，选择一个模型，然后根据需要修改配置。

1. （可选）如果模型支持提示缓存，则可以打开**配置**面板，然后启用**提示缓存**，以允许对输入和模型响应进行缓存，从而降低成本并减少延迟。有关更多信息，请参阅 [用于加快模型推理速度的提示缓存](prompt-caching.md)。

1. 要运行提示，请选择**运行**。Amazon Bedrock 不会存储您提供的任何文本、图像或文档。数据仅用于生成响应。
**注意**  
如果响应违反了内容审核政策，则 Amazon Bedrock 不会显示该响应。如果您已开启流式传输，Amazon Bedrock 会在生成违反政策的内容时清除整个响应。要了解更多详细信息，请导航至 Amazon Bedrock 控制台，选择**提供商**，然后阅读**内容限制**部分下的文本。

1. 模型返回响应。如果您使用的是游乐场的聊天模式，则可以提交提示以回复回复并生成其他响应。

1. 生成响应后，您可以选择以下选项：
   + 要将响应导出为 JSON 文件，请选择选项图标（![\[Vertical ellipsis icon representing a menu or more options.\]](http://docs.aws.amazon.com/zh_cn/bedrock/latest/userguide/images/icons/vertical-ellipsis.png)），然后选择**导出为 JSON**。
   + 要查看您发出的 API 请求，请选择选项图标（![\[Vertical ellipsis icon representing a menu or more options.\]](http://docs.aws.amazon.com/zh_cn/bedrock/latest/userguide/images/icons/vertical-ellipsis.png)），然后选择**查看 API 请求**。
   + 在游乐场的聊天模式下，您可以在 “**模型指标” 部分中查看指标**。可供使用的模型指标如下：
     + **延迟** – Amazon Bedrock 接收到请求的时间点，与返回响应的时间点（针对非流式响应）或响应流完成的时间点（针对流式响应）之间的时长。
     + **输入词元计数** – 在推理期间以输入形式输入到模型中的词元数量。
     + **输出词元计数** – 响应提示时生成的词元数量。更长、更像对话的响应需要更多词元。
     + **成本** – 处理输入和生成输出词元的成本。

     要设置您希望响应匹配的指标标准，请选择**定义指标标准**并定义模型要匹配的条件。应用标准后，**模型指标**部分将显示响应满足的标准数量和标准。

     如果不满足标准，您可以选择其他模型，重写提示，或者修改配置并重新运行提示。