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

# 使用提示管理器测试提示
<a name="prompt-management-test"></a>

要了解如何测试在提示管理器中创建的提示，请选择与您的首选方法对应的选项卡，然后按照以下步骤操作：

------
#### [ Console ]

**在提示管理器中测试提示**

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

1. 从左侧导航窗格中选择**提示管理器**。然后，在**提示**部分中选择一个提示。

1. 在**提示草稿**部分中选择**在提示生成器中编辑**，或者在**版本**部分中选择提示的版本。

1. （可选）要在提示中为变量提供值，您需要先在**配置**窗格中选择一个模型。然后，在**测试变量**窗格中为每个变量输入**测试值**。
**注意**  
这些测试值是临时的，如果您保存提示，则不会保存这些值。

1. 要测试提示，请在**测试窗口**窗格中选择**运行**。

1. 修改提示或其配置，然后根据需要再次运行提示。如果您对提示感到满意，可以选择**创建版本**来创建可在生产环境中使用的提示快照。有关更多信息，请参阅 [使用提示管理器中的版本将提示部署到应用程序](prompt-management-deploy.md)。

您也可以通过以下方式测试提示：
+ 要测试流中的提示，请在流中添加提示节点。有关更多信息，请参阅[在 Amazon Bedrock 中创建和设计流](flows-create.md)和[流的节点类型](flows-nodes.md)。
+ 如果没有为提示配置代理，您仍然可以通过在测试代理时导入提示，来使用代理测试提示。有关更多信息，请参阅 [测试代理行为并进行问题排查](agents-test.md)。

------
#### [ API ]

您可以通过以下方式测试提示：
+ 要对提示进行推理，请使用 A [mazon Bedrock 运行时终端节点](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#br-rt)发送、C [onverse](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)请求，并在参数中指定提示的 ARN。[InvokeModel[InvokeModelWithResponseStream](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_InvokeModelWithResponseStream.html)](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_InvokeModel.html)`modelId`要传递提示变量的值，请在`promptVariables`字段中添加变量名称与其值的映射：

  ```
  response = bedrock_runtime.converse(
      modelId="arn:aws:bedrock:us-east-1:123456789012:prompt/PROMPT_ID:VERSION",
      promptVariables={
          "{{variable_name}}": {"text": "{{value}}"}
      }
  )
  ```

  调用托管提示时，您无需指定`messages`或`system`字段，这些字段是在提示模板中定义的。您只需要为提示中定义的变量提供值即可。有关完整示例，请参阅[运行提示管理器示例代码](prompt-management-code-ex.md)。
**注意**  
当您将提示管理器提示与 `Converse` 或 `ConverseStream` 结合使用时，以下限制适用：  
您不能包含 `additionalModelRequestFields`、`inferenceConfig`、`system` 或 `toolConfig` 字段。
如果您包含 `messages` 字段，则消息将附加到在提示中定义的消息之后。
如果包含 `guardrailConfig` 字段，则护栏将应用于整个提示。如果您在[ContentBlock](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_ContentBlock.html)字段中包含`guardContent`方块，则护栏将仅应用于这些方块。
+ 要在流程中测试您的提示，请使用[适用于 Amazon Bedrock 的代理构建](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt)时终端节点发送[CreateFlow](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_CreateFlow.html)或[UpdateFlow](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_UpdateFlow.html)请求来创建或编辑流程。为该`PromptNode`类型的 JavaScript in Node.js 添加一个 SDK，并在字段中包含提示的 ARN。`promptArn`然后，使用[适用于 Amazon Bedrock 运行时终端节点的代理](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-rt)发送[InvokeFlow](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeFlow.html)请求。有关更多信息，请参阅[在 Amazon Bedrock 中创建和设计流](flows-create.md)和[流的节点类型](flows-nodes.md)。
+ 要使用代理测试提示，请使用 Amazon Bedrock 控制台（请参阅**控制台**选项卡），或将提示文本输入到 [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeAgent.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeAgent.html) 请求的 `inputText` 字段。

------