Deploy prompts using Prompt management by creating versions

Note

Prompt management is in preview and is subject to change.

When you save your prompt, you create a draft version of it. You can keep iterating on the draft version by modifying the prompt and its configurations and saving it.

When you're ready to deploy a prompt to production, you create a version of it to use in your application. A version is a snapshot of your prompt that you create at a point in time when you are iterating on the working draft of the prompt. Create versions of your prompt when you are satisfied with a set of configurations. Versions allow you to easily switch between different configurations for your prompt and update your application with the most appropriate version for your use-case.

Create a version of a prompt

To learn how to create a version of your prompt, select the tab corresponding to your method of choice and follow the steps.

Console

If you're in the prompt builder, you can create a version of your prompt by choosing Create version. Otherwise, do the following:

To create a version of your prompt

1. Sign in to the AWS Management Console using an IAM role with Amazon Bedrock permissions, and open the Amazon Bedrock console at Getting Started with the AWS Management Console.

2. Select Prompt management from the left navigation pane. Then, choose a prompt in the Prompts section.

3. In the Prompt versions section, choose Create version to take a snapshot of your draft version.

API

To create a version of your prompt, send a CreatePromptVersion request (see link for request and response formats and field details) with an Agents for Amazon Bedrock build-time endpoint and specify the ARN or ID of the prompt as the promptIdentifier.

The response returns an ID and ARN for the version. Versions are created incrementally, starting from 1.

View information about a version of a prompt

To learn how to view information about a version of your prompt, select the tab corresponding to your method of choice and follow the steps.

Console

To view information about a version of your prompt

1. Sign in to the AWS Management Console using an IAM role with Amazon Bedrock permissions, and open the Amazon Bedrock console at Getting Started with the AWS Management Console.

2. Select Prompt management from the left navigation pane. Then, choose a prompt in the Prompts section.

3. In the Prompt versions section, choose a version.

4. In the Version details page, you can see information about the version, the prompt message, and its configurations. For more information about testing a version of the prompt, see Test a prompt using Prompt management.

API

To get information about a version of your prompt, send a GetPrompt request (see link for request and response formats and field details) with an Agents for Amazon Bedrock build-time endpoint and specify the ARN or ID of the prompt as the promptIdentifier. In the promptVersion field, specify DRAFT or the version number.

Delete a version of a prompt using Prompt management

To learn how to delete a version of your prompt, select the tab corresponding to your method of choice and follow the steps.

Console

To delete a version of your prompt

1. Sign in to the AWS Management Console using an IAM role with Amazon Bedrock permissions, and open the Amazon Bedrock console at Getting Started with the AWS Management Console.

2. Select Prompt management from the left navigation pane. Then, choose a prompt in the Prompts section.

3. In the Prompt versions section, select a version and choose Delete.

4. In the Version details page, you can see information about the version, the prompt message, and its configurations. For more information about testing a version of the prompt, see Test a prompt using Prompt management.

5. Review the warning that appears, type confirm, and then choose Delete.

API

To delete a version of your prompt, send a GetPrompt request (see link for request and response formats and field details) with an Agents for Amazon Bedrock build-time endpoint and specify the ARN or ID of the prompt as the promptIdentifier. In the promptVersion field, specify the version number to delete.