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

# プロンプト管理を使用してプロンプトを作成する
<a name="prompt-management-create"></a>

プロンプトを作成する際、以下のオプションを選択できます。
+ FM が出力を生成するための入力として機能するプロンプトメッセージを書き込みます。
+ 二重中括弧を使用して、プロンプトを呼び出すときに入力できるプロンプトメッセージに変数 (*\$1\$1variable\$1\$1* など) を含めます。
+ プロンプトを呼び出すモデルを選択するか、エージェントでプロンプトを使用する予定がある場合は指定しないままにします。モデルを選択した場合は、使用する推論設定を変更することもできます。さまざまなモデルの推論パラメータを確認するには、「[Inference request parameters and response fields for foundation models](model-parameters.md)」を参照してください。

すべてのプロンプトは、以下の基本推論パラメータをサポートしています。
+ **maxTokens** – 生成されたレスポンスで許可するトークンの最大数。
+ **stopSequences** – ストップシーケンスのリスト。停止シーケンスは、モデルがレスポンスの生成を停止する一連の文字です。
+ **temperature** – モデルがレスポンスの生成中に確率の高いオプションを選択する可能性。
+ **topP** — モデルが次のトークンについて考慮する最も可能性の高い候補のパーセンテージ。

モデルが追加の推論パラメータをサポートしている場合は、それらをプロンプトの*追加フィールド*として指定できます。JSON オブジェクトに追加フィールドを指定します。次の例は、Anthropic Claude モデルで使用可能ですが、基本推論パラメータではない `top_k` を設定する方法を示しています。

```
{
    "top_k": 200
}
```

モデル推論パラメータの詳細については、「[基盤モデルの推論リクエストパラメータとレスポンスフィールド](https://docs.aws.amazon.com/bedrock/latest/userguide/model-parameters.html)」を参照してください。

基本推論パラメータを追加フィールドとして設定しても、コンソールで設定した値は上書きされません。

プロンプトに選択したモデルが [Converse](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_Converse.html) API をサポートしている場合 (詳細については、「[Converse API オペレーションを使用して会話を実行する](conversation-inference.md)」を参照)、プロンプトを作成するときに以下を含めることができます。
+ モデルに指示またはコンテキストを提供するシステムプロンプト。
+ 以前のプロンプト (ユーザーメッセージ) とモデルレスポンス (アシスタントメッセージ) を、最後のユーザーメッセージのレスポンスを生成する際にモデルが考慮する会話履歴として使用します。
+ (モデルでサポートされている場合) レスポンスの生成時に使用するモデル用の[ツール](tool-use.md)。
+ (モデルでサポートされている場合) [プロンプトキャッシュ](prompt-caching.md)を使用すると、大規模または頻繁に使用されるプロンプトをキャッシュすることでコストを削減できます。モデルに応じて、システムの指示、ツール、メッセージ (ユーザーとアシスタント) をキャッシュできます。プロンプトキャッシュは、プロンプトプレフィックスの合計がモデルに必要なトークンの最小数を満たしている場合、プロンプトのキャッシュチェックポイントを作成します。プロンプトで変数の変更が発生すると、プロンプトキャッシュは新しいキャッシュチェックポイントを作成します (入力トークンの数がモデルが必要とする最小値に達した場合)。

プロンプト管理を使用してプロンプトを作成する方法については、任意の方法のタブを選択して手順に従ってください。

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

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

1. Amazon Bedrock コンソールを使用するためのアクセス許可を持つ IAM ID を使用して、AWS マネジメントコンソールにサインインします。Amazon Bedrock コンソール ([https://console.aws.amazon.com/bedrock](https://console.aws.amazon.com/bedrock)) を開きます。

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

1. プロンプトの名前と説明 (オプション) を入力します。

1. カスタマーマネージドキーでプロンプトを暗号化するには、**[KMS キーの選択]** セクションで **[暗号化設定をカスタマイズ (高度)]** を選択します。このフィールドを省略すると、プロンプトは AWS マネージドキー で暗号化されます。詳細については、「[AWS KMS キー](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html)」を参照してください。

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

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

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

1. プロンプトビルダーにまだ進んでいない場合は、次のようにします。

   1. Amazon Bedrock コンソールを使用するためのアクセス許可を持つ IAM ID を使用して、AWS マネジメントコンソールにサインインします。Amazon Bedrock コンソール ([https://console.aws.amazon.com/bedrock](https://console.aws.amazon.com/bedrock)) を開きます。

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

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

1. **[プロンプト]** ペインを使用してプロンプトを作成します。最後の **[ユーザーメッセージ]** ボックスにプロンプトを入力します。モデルが [Converse](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_Converse.html) API または [AnthropicClaude Messages API](model-parameters-anthropic-claude-messages.md) をサポートしている場合は、コンテキストの**システムプロンプト**と以前の**ユーザーメッセージ**、**アシスタントメッセージ**を含めることもできます。

   プロンプトを記述するときは、二重中括弧 (*\$1\$1variable\$1\$1* のように) に変数を含めることができます。含める各変数は、**[テスト変数]** セクションに表示されます。

1. (オプション) プロンプトは、次の方法で変更できます。
   + **[詳細設定]** ペインで、次の操作を行います。

     1. 推論を実行するための **[生成 AI のリソース]** を選択します。
**注記**  
エージェントを選択した場合は、コンソールでのみプロンプトをテストできます。API でエージェントを使用してプロンプトをテストする方法については、「[プロンプト管理を使用してプロンプトをテストする](prompt-management-test.md)」を参照してください。

     1. **[推論パラメータ]** で、使用する推論パラメータを設定します。

     1. モデルが[推論](inference-reasoning.md)をサポートしている場合は、**[推論]** をオンにしてモデルの推論をレスポンスに含めます。**[推論トークン]** では、モデルが使用できる推論トークンの数を設定できます。

     1. **[追加モデルリクエストフィールド]** で、**[設定]** を選択して、**[推論パラメータ]** で指定したもの以外の追加の推論パラメータを指定します。

     1. 選択したモデルがツールをサポートしている場合は、**[ツールを設定]** を選択して、プロンプトでツールを使用するようにします。

     1. 選択したモデルが[プロンプトキャッシュ](prompt-caching.md)をサポートしている場合は、次のいずれかのオプションを選択します (可用性はモデルによって異なります)。
        + **なし** – プロンプトキャッシュは行われません。
        + **ツール** – プロンプト内のツールのみがキャッシュされます。
        + **ツール、システム命令** – プロンプトのツールとシステム命令がキャッシュされます。
        + **ツール、システム命令、メッセージ** – プロンプトのツール、システム命令、メッセージ (ユーザーとアシスタント) がキャッシュされます。
   + プロンプトのさまざまなバリアントを比較するには、**[バリアントを比較]** を選択します。比較ページで、以下のことができます。
     + バリアントを追加するには、プラス記号を選択します。最大 3 つのバリアントを追加できます。
     + バリアントの詳細を指定したら、任意の **[テスト変数]** を指定し、**[実行]** を選択してバリアントの出力をテストできます。
     + バリアントを削除するには、3 つのドットを選択し、**[比較から削除]** を選択します。
     + 作業ドラフトを置き換えて比較モードを終了するには、**[ドラフトとして保存]** を選択します。他のすべてのバリアントは削除されます。
     + 比較モードを終了するには、**[比較モードを終了]** を選択します。

1. プロンプトの設定が完了したら、次のオプションがあります。
   + プロンプトを保存するには、**[下書きを保存]** を選択します。下書きのバージョンの詳細については、「[プロンプト管理でバージョンを使用して、アプリケーションにプロンプトをデプロイする](prompt-management-deploy.md)」を参照してください。
   + プロンプトを削除するには、**[削除]** を選択します。詳細については、「[プロンプト管理でプロンプトを削除する](prompt-management-delete.md)」を参照してください。
   + プロンプトのバージョンを作成するには、**[バージョンを作成]** を選択します。プロンプトのバージョニングの詳細については、「[プロンプト管理でバージョンを使用して、アプリケーションにプロンプトをデプロイする](prompt-management-deploy.md)」を参照してください。

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

プロンプトを作成するには、[Amazon Bedrock エージェントのビルドタイムエンドポイント](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt)を使用して、[CreatePrompt](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_CreatePrompt.html) リクエストを送信します。

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


****  

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

`variants` リスト内の各バリアントは、次の一般的な構造の [PromptVariant](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_PromptVariant.html) オブジェクトです。

```
{
        "name": "string",
        # modelId or genAiResource (see below)
        "templateType": "TEXT",
        "templateConfiguration": # see below,
        "inferenceConfiguration": {
            "text": {
                "maxTokens": int,
                "stopSequences": ["string", ...],
                "temperature": float,
                "topP": float
            }
        },
        "additionalModelRequestFields": {
            "key": "value",
            ...
        },
        "metadata": [
            {
                "key": "string",
                "value": "string"
            },
            ...
        ]
}
```

次のようにフィールドに入力します。
+ name – バリアントの名前を入力します。
+ 使用するモデル呼び出しリソースに応じて、以下のフィールドのいずれかを含めます。
  + modelId – プロンプトで使用する[基盤モデル](models-supported.md)または[推論プロファイル](cross-region-inference.md)を指定するには、その ARN または ID を入力します。
  + genAiResource – [エージェント](agents.md)を指定するには、その ID または ARN を入力します。`genAiResource` の値は以下の形式の JSON オブジェクトです。

    ```
    {
        "genAiResource": {
        "agent": {
            "agentIdentifier": "string"
        }   
    }
    ```
**注記**  
`genAiResource` フィールドを含めると、コンソールでのみプロンプトをテストできます。API でエージェントを使用してプロンプトをテストするには、プロンプトのテキストを [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` フィールドに直接入力する必要があります。
+ templateType – `TEXT` または `CHAT` を入力します。`CHAT` は [Converse](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_Converse.html) API をサポートするモデルとのみ互換性があります。プロンプトキャッシュを使用する場合は、`CHAT` テンプレートタイプを使用する必要があります。
+ templateConfiguration – 値は、指定したテンプレートタイプによって異なります。
  + テンプレートタイプとして `TEXT` を指定した場合、値は [TextPromptTemplateConfiguration](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_TextPromptTemplateConfiguration.html.html) JSON オブジェクトである必要があります。
  + テンプレートタイプとして `CHAT` を指定した場合、値は [ChatPromptTemplateConfiguration](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_ChatPromptTemplateConfiguration.html.html) JSON オブジェクトである必要があります。
+ inferenceConfiguration – `text` フィールドは [PromptModelInferenceConfiguration](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_PromptModelInferenceConfiguration.html.html) にマッピングされます。このフィールドには、すべてのモデルに共通の推論パラメータが含まれています。推論パラメータの詳細については、「[推論パラメータでレスポンスの生成に影響を与える](inference-parameters.md)」を参照してください。
+ additionalModelRequestFields – このフィールドを使用して、推論を実行しているモデルに固有の推論パラメータを指定します。モデル固有の推論パラメータの詳細については、「[Inference request parameters and response fields for foundation models](model-parameters.md)」を参照してください。
+ metadata – プロンプトバリアントに関連付けるメタデータ。キーと値のペアを配列に追加して、プロンプトバリアントにメタデータをタグ付けできます。

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


****  

| フィールド | ユースケース | 
| --- | --- | 
| description | プロンプトの説明を入力するには。 | 
| clientToken | API リクエストが 1 回だけ完了するようにします。詳細については、「[べき等性の確保](https://docs.aws.amazon.com/ec2/latest/devguide/ec2-api-idempotency.html)」を参照してください。 | 
| tags | タグをエイリアスに関連付ける場合に指定します。詳細については、「[Amazon Bedrock リソースにタグ付け](tagging.md)」を参照してください。 | 

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

------