プロンプト管理を使用してプロンプトを作成する - Amazon Bedrock

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

プロンプト管理を使用してプロンプトを作成する

注記

プロンプト管理はプレビュー中であり、変更される可能性があります。

プロンプトを作成するときは、次のオプションがあります。

  • FM が出力を生成する入力として機能するプロンプトメッセージを書き込みます。

  • 実行時に入力できるプロンプトメッセージに変数を含めます。

  • モデルを選択してプロンプトを実行するか、実行時に入力させます。モデルを選択した場合は、使用する推論設定を変更することもできます。さまざまなモデルの推論パラメータを確認するには、「」を参照してください基盤モデルの推論リクエストパラメータとレスポンスフィールド。

  • さまざまなメッセージ、モデル、または設定を使用するプロンプトのバリアントを作成して、出力を比較してユースケースに最適なバリアントを決定できるようにします。

プロンプト管理を使用してプロンプトを作成する方法については、選択した方法に対応するタブを選択し、ステップに従います。

Console
プロンプトを作成するには

  1. IAM Amazon Bedrock アクセス許可 を持つロール AWS Management Console を使用して にサインインし、「 の開始方法 AWS Management Console」で Amazon Bedrock コンソールを開きます。

  2. 左側のナビゲーションペインからプロンプト管理を選択します。次に、プロンプトの作成 を選択します。

  3. （オプション) プロンプトのデフォルト名とその説明 を変更します。

  4. プロンプトの作成 を選択します。プロンプトが作成され、新しく作成されたプロンプトのプロンプトビルダーに移動し、プロンプトを設定できます。

  5. 次の手順に進んでプロンプトを設定するか、後でプロンプトビルダーに戻ります。

プロンプトを設定するには

  1. プロンプトビルダーにまだ参加していない場合は、次の操作を行います。

    1. IAM Amazon Bedrock アクセス許可 を持つロール AWS Management Console を使用して にサインインし、「 の開始方法 AWS Management Console」で Amazon Bedrock コンソールを開きます。

    2. 左側のナビゲーションペインからプロンプト管理を選択します。次に、プロンプトセクションでプロンプトを選択します。

    3. プロンプトドラフトセクションで、プロンプトビルダー で編集 を選択します。

  2. プロンプトペインで、メッセージボックスにプロンプトを入力します。二重中括弧を使用して変数を含めることができます ( {{variable}}）。 プロンプト変数については、次の点に注意してください。

    • 含める各変数は、テスト変数セクションに表示されます。

    • これらの変数は、プロンプトをテストするとき、またはプロンプトフローでプロンプトを設定するときに、実際の値に置き換えることができます。

  3. （オプション) プロンプトは、次の方法で変更できます。

    • 設定ペインで、推論を実行するモデルを選択し、推論パラメータ を設定します。

    • プロンプトのさまざまなバリアントを比較するには、「アクション」を選択し、「プロンプトバリアントの比較」を選択します。比較ページで以下を実行できます。

      • バリアントを追加するには、プラス記号を選択します。最大 3 つのバリアントを追加できます。

      • バリアントの詳細を指定したら、任意のテスト変数を指定し、実行を選択してバリアントの出力をテストできます。

      • バリアントを削除するには、3 つのドットを選択し、比較から削除 を選択します。

      • 作業ドラフトを置き換えて比較モードを終了するには、ドラフトとして保存 を選択します。他のすべてのバリアントは削除されます。

      • 比較モードを終了するには、比較モードの終了 を選択します。

  4. プロンプトの設定が完了したら、次のオプションがあります。

API

プロンプトを作成するには、Agents for Amazon Bedrock ビルドタイムエンドポイント を使用してCreatePromptリクエストを送信します (リクエストとレスポンスの形式とフィールドの詳細についてはリンクを参照）。

以下のフィールドが必要です。

フィールド 簡単な説明
name プロンプトの名前。
バリアント プロンプトのさまざまな設定のリスト (以下を参照）。
defaultVariant デフォルトのバリアントの名前。

variants リスト内の各バリアントは、次の一般的な構造のPromptVariantオブジェクトです。

{
        "name": "string",
        "modelId": "string",
        "templateType": "TEXT",
        "templateConfiguration": {
            "text": {
                "text": "string",
                "inputVariables": [
                    {
                        "name": "string"
                    },
                    ...
                ]
            }
        },
        "inferenceConfiguration": {
            "text": {
                "maxTokens": int,
                "stopSequences": ["string", ...],
                "temperature": float,
                "topK": int,
                "topP": float
            }
        },
        "metadata": [
            {
                "key": "string",
                "value": "string"
            },
            ...
        ]
}

次のようにフィールドに入力します。

  • name – バリアントの名前を入力します。

  • modelId – 推論を実行するモデル ID または推論プロファイルを入力します。

  • templateType – と入力します TEXT (現在、テキストプロンプトのみがサポートされています）。

  • templateConfiguration – textフィールドは にマッピングされますTextPromptTemplateConfiguration。次のフィールドに入力します。

    • text – プロンプトのメッセージ。変数を二重の中括弧で囲みます。{{variable}}.

    • inputVariables – リスト内の各オブジェクトに対して、作成した各変数を name フィールドに入力します。

  • inferenceConfiguration – textフィールドは にマッピングされますPromptModelInferenceConfiguration。推論パラメータの詳細については、「」を参照してください推論パラメータによる影響レスポンスの生成。

  • metadata – プロンプトバリアントに関連付けるメタデータ。キーと値のペアを配列に追加して、プロンプトバリアントにメタデータでタグ付けできます。

次のフィールドはオプションです。

フィールド ユースケース
説明 プロンプトの説明を指定します。
clientToken API リクエストが 1 回だけ完了するようにするには。詳細については、「冪等性の確保」を参照してください。
タグ タグをフローに関連付けるには。詳細については、「Amazon Bedrock リソースのタグ付け」を参照してください。
customerEncryptionKeyArn KMS キーを使用してフローを暗号化します。詳細については、「Amazon Bedrock がフローを暗号化および復号できるようにするキーポリシー」を参照してください。

レスポンスはDRAFTバージョンを作成し、ID を返します。ARNID は、他のプロンプト関連のAPIリクエストのプロンプト識別子として使用できます。