View a markdown version of this page

Testar um prompt usando o Gerenciamento de Prompts - Amazon Bedrock

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

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.

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

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

  4. (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.

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

  6. 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.

Também é possível testar o prompt das seguintes maneiras:

API

Você pode invocar um prompt das seguintes maneiras:

  • Para executar inferência no prompt, envie uma ConverseStreamsolicitação InvokeModelInvokeModelWithResponseStream, Converse ou com um endpoint de tempo de execução do Amazon Bedrock 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, consulteExecutar exemplos de código do Gerenciamento de Prompts.

    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 ContentBlockcampo, 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 UpdateFlowsolicitação CreateFlowou com um endpoint de tempo de construção do Agents for Amazon Bedrock. Inclua um SDK para JavaScript in Node.js do PromptNode tipo e inclua o ARN do prompt no promptArn campo. Em seguida, envie uma InvokeFlowsolicitação com um endpoint de tempo de execução do Agents for Amazon Bedrock. Para obter mais informações, consulte Criar e planejar um fluxo no Amazon Bedrock e Tipos de nó para o fluxo.

  • 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 InvokeAgent.