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

# 詳細プロンプトを設定する
<a name="configure-advanced-prompts"></a>

詳細プロンプトは、 AWS マネジメントコンソール または API を使用して設定できます。

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

コンソールでは、エージェントを作成した後で詳細プロンプトを設定できます。これらはエージェントの編集中に設定します。

**エージェントの詳細プロンプトを表示または編集するには**

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

1. 左のナビゲーションペインの [**エージェント**] を選択します。次に、**[エージェント]** セクションでエージェントを選択します。

1. エージェントの詳細ページでの **[作業用のドラフト]** セクションで、**[作業用のドラフト]** を選択します。

1. **[作業中のドラフト]** ページの **[オーケストレーション戦略]** セクションで、**[編集]** を選択します。

1. **オーケストレーション戦略**ページ **[オーケストレーション戦略の詳細]** セクションで、**[デフォルトオーケストレーション]** が選択されていることを確認してから、編集するエージェントシーケンスのステップに対応するタブを選択します。

1. テンプレートの編集を有効化するには、**[テンプレートのデフォルトを上書き]** をオンにします。**[テンプレートのデフォルトを上書き]** ダイアログボックスで、**[確認]** を選択します。
**警告**  
**[テンプレートのデフォルトを上書き]** をオフにしたり、モデルを変更すると、デフォルトの Amazon Bedrock テンプレートが使用され、テンプレートはすぐに削除されます。確認するには、テキストボックスに **confirm** を入力し、表示されるメッセージを確認します。

1. エージェントがレスポンスを生成する際にテンプレートの使用を許可するには、**[テンプレートを有効化]** をオンします。この設定がオフの場合、エージェントはテンプレートを使用しません。

1. サンプルのプロンプトテンプレートを変更するには、**プロンプトテンプレートエディター** を使用します。

1. **[設定]** で、プロンプトの推論パラメータを変更できます。推論パラメータの定義や、さまざまなモデルのパラメータの詳細については、「[Inference request parameters and response fields for foundation models](model-parameters.md)」を参照してください。

1. (オプション) 定義した Lambda 関数を使用して未加工の基盤モデル出力を解析するには、次のアクションを実行します。
**注記**  
1 つの Lambda 関数がすべてのプロンプトテンプレートに使用されます。

   1. **[設定]** セクションで **[解析には Lambda 関数を使用する]** を選択します。この設定をオフにすると、エージェントはプロンプトにデフォルトのパーサーを使用します。

   1. **[パーサー Lambda 関数]** で、ドロップダウンメニューから Lambda 関数を選択します。
**注記**  
Lambda 関数にアクセスできるように、エージェントにアクセス許可をアタッチする必要があります。詳細については、「[Amazon Bedrock がアクショングループの Lambda 関数を呼び出すことを許可するリソースベースのポリシー](agents-permissions.md#agents-permissions-lambda)」を参照してください。

1. 設定を保存するには、次のいずれかのオプションを選択します。

   1. 更新されたエージェントのテスト中にプロンプト設定を動的に更新できるように、同じウィンドウにとどまるには、**[保存]** を選択します。

   1. 設定を保存して **[作業用のドラフト]** ページに戻るには、**[保存して終了]** を選択します。

1. 更新した設定をテストするには、**[テスト]** ウィンドウで **[準備]** を選択します。

![コンソールで詳細プロンプトを設定します。](http://docs.aws.amazon.com/ja_jp/bedrock/latest/userguide/images/agents/advanced-prompts.png)


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

API オペレーションを使用して詳細プロンプトを設定するには、[UpdateAgent](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_UpdateAgent.html) 呼び出しを送信するか、次の `promptOverrideConfiguration` オブジェクトを変更します。

```
"promptOverrideConfiguration": { 
    "overrideLambda": "string",
    "promptConfigurations": [ 
        { 
            "basePromptTemplate": "string",
            "inferenceConfiguration": { 
                "maximumLength": int,
                "stopSequences": [ "string" ],
                "temperature": float,
                "topK": float,
                "topP": float
            },
            "parserMode": "DEFAULT | OVERRIDDEN",
            "promptCreationMode": "DEFAULT | OVERRIDDEN",
            "promptState": "ENABLED | DISABLED",
            "promptType": "PRE_PROCESSING | ORCHESTRATION | KNOWLEDGE_BASE_RESPONSE_GENERATION | POST_PROCESSING | MEMORY_SUMMARIZATION"
        }
    ],
    promptCachingState: {
        cachingState: "ENABLED | DISABLED"
    }
}
```

1. `promptConfigurations`リストには、編集する各プロンプトテンプレートの `promptConfiguration` オブジェクトを含めます。

1. 変更するプロンプトを `promptType` フィールドで指定します。

1. 次の手順でプロンプトテンプレートを変更します。

   1. プロンプトテンプレートで `basePromptTemplate` フィールドを指定します。

   1. 推論パラメータを `inferenceConfiguration` オブジェクトに含めます。推論の設定の詳細については、「[Inference request parameters and response fields for foundation models](model-parameters.md)」を参照してください。

1. プロンプトテンプレートを有効にするには、`promptCreationMode` を `OVERRIDDEN` に設定します。

1. エージェントが `promptType` フィールドでステップを実行することを許可または禁止するには、`promptState` 値を変更します。この設定は、エージェントの動作のトラブルシューティングに役立ちます。
   + `PRE_PROCESSING`、`KNOWLEDGE_BASE_RESPONSE_GENERATION` または `POST_PROCESSING` ステップの `promptState` を `DISABLED` に設定すると、そのステップはエージェントによってスキップされます。
   + `ORCHESTRATION` ステップの `promptState` を `DISABLED` に設定すると、エージェントはオーケストレーションで基盤モデルにユーザー入力のみを送信します。さらに、エージェントは API オペレーションとナレッジベース間の呼び出しをオーケストレーションすることなく、そのままレスポンスを返します。
   + デフォルトでは、`POST_PROCESSING` ステップは `DISABLED` です。デフォルトでは、`PRE_PROCESSING`、`ORCHESTRATION`、および `KNOWLEDGE_BASE_RESPONSE_GENERATION` ステップは `ENABLED` です。
   + デフォルトでは、メモリが有効になっている場合、`MEMORY_SUMMARIZATION` ステップは `ENABLED` になり、メモリが無効になっている場合、`MEMORY_SUMMARIZATION` ステップは `DISABLED` になります。

1. 定義した Lambda 関数を使用して未加工の基盤モデル出力を解析するには、次のステップを実行します。

   1. Lambda 関数を有効にする各プロンプトテンプレートについて、`parserMode` を `OVERRIDDEN` に設定します。

   1. `promptOverrideConfiguration` オブジェクトの `overrideLambda` フィールドで Lambda 関数の Amazon リソースネーム (ARN) を指定します。

------