As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Testar um prompt usando o Gerenciamento de Prompts
<a name="prompt-management-test"></a>

Para saber como testar um prompt usando o Gerenciamento de Prompts, escolha a guia correspondente ao método de sua preferência e siga as etapas:

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

**Como testar um prompt no Gerenciamento de Prompts**

1. Faça login no Console de gerenciamento da AWS com uma identidade do IAM que tenha permissões para usar o console Amazon Bedrock. Em seguida, abra o console Amazon Bedrock em [https://console.aws.amazon.com/bedrock](https://console.aws.amazon.com/bedrock).

1. No painel de navegação à esquerda, selecione **Gerenciamento de prompts**. Em seguida, escolha um prompt na seção **Prompts**.

1. Escolha **Editar no construtor de prompts** na seção **Rascunho do prompt** ou escolha uma versão do prompt na seção **Versões**.

1. (Opcional) Para fornecer valores para variáveis no prompt, selecione um modelo no painel **Configurações**. Insira um **Valor de teste** para cada variável no painel **Testar variáveis**.
**nota**  
Esses valores de teste são temporários e não serão salvos se você salvar o prompt.

1. Para testar o prompt, escolha **Executar** no painel **Janela de teste**.

1. Modifique o prompt ou suas configurações e execute o prompt novamente conforme necessário. Se o prompt estiver adequado, você poderá escolher **Criar versão** para criar um snapshot do prompt que possa ser usado na produção. Para obter mais informações, consulte [Implantar um prompt em sua aplicação usando versões no Gerenciamento de Prompts](prompt-management-deploy.md).

Também é possível testar o prompt das seguintes maneiras:
+ Para testar o prompt em um fluxo, inclua um nó de prompt no fluxo. Para obter mais informações, consulte [Criar e planejar um fluxo no Amazon Bedrock](flows-create.md) e [Tipos de nó para o fluxo](flows-nodes.md).
+ Se você não configurou seu prompt com um agente, ainda pode testar o prompt com um agente importando-o ao testar um agente. Para obter mais informações, consulte [Testar e solucionar problemas de comportamento do agente](agents-test.md).

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

Você pode invocar um prompt das seguintes maneiras:
+ Para executar inferência no prompt, envie uma [ConverseStream](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_ConverseStream.html)solicitação [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), [Converse](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_Converse.html) ou com um [endpoint de tempo de execução do Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#br-rt) e especifique o ARN do prompt no parâmetro. `modelId` Para passar valores para variáveis de prompt, inclua o `promptVariables` campo com um mapa dos nomes das variáveis para seus valores:

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

  Ao invocar um prompt gerenciado, você não precisa especificar `messages` nenhum `system` campo — eles são definidos no modelo de prompt. Você só precisa fornecer valores para as variáveis definidas no prompt. Para obter um exemplo completo, consulte[Executar exemplos de código do Gerenciamento de Prompts](prompt-management-code-ex.md).
**nota**  
As seguintes restrições se aplicam quando você usa um prompt do Gerenciamento de Prompts com `Converse` ou `ConverseStream`:  
Não é possível incluir os campos `additionalModelRequestFields`, `inferenceConfig`, `system` ou `toolConfig`.
Se você incluir o campo `messages`, as mensagens serão anexadas após as mensagens definidas no prompt.
Se você incluir o campo `guardrailConfig`, a barreira de proteção será aplicada a todo o prompt. Se você incluir `guardContent` blocos no [ContentBlock](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_ContentBlock.html)campo, a grade de proteção só será aplicada a esses blocos.
+ Para testar sua solicitação em um fluxo, crie ou edite um fluxo enviando uma [UpdateFlow](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_UpdateFlow.html)solicitação [CreateFlow](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_CreateFlow.html)ou com um endpoint de tempo de [construção do Agents for Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt). Inclua um SDK para JavaScript in Node.js do `PromptNode` tipo e inclua o ARN do prompt no `promptArn` campo. Em seguida, envie uma [InvokeFlow](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeFlow.html)solicitação com um [endpoint de tempo de execução do Agents for Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-rt). Para obter mais informações, consulte [Criar e planejar um fluxo no Amazon Bedrock](flows-create.md) e [Tipos de nó para o fluxo](flows-nodes.md).
+ Para testar o prompt com um agente, use o console do Amazon Bedrock (consulte a guia **Console**) ou insira o texto do prompt no campo `inputText` de uma solicitação [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).

------