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

# 実行時にインラインエージェントを設定する
<a name="agents-create-inline"></a>

[InvokeInlineAgent](https://docs.aws.amazon.com//bedrock/latest/APIReference/API_agent-runtime_InvokeInlineAgent.html) API を使用して、実行時にインラインの Amazon Bedrock エージェントを動的に設定して呼び出すことができます。インラインエージェントを使用すると、エージェントを呼び出すと同時に、基盤モデル、指示、アクショングループ、ガードレール、ナレッジベースなどのエージェント機能を柔軟に指定できます。エージェント機能を使用する前に事前定義する必要はありません。

以下は、インラインエージェントを使用することで、呼び出し時にエージェントを柔軟に設定できるユースケースの一部です。
+ 各種エージェント機能をさまざまな設定で試し、エージェントが利用できるツールを、個別のエージェントを作成せずに動的に更新することで、迅速に実験を行う。
+ エージェントを動的に呼び出して、新しいエージェントバージョンを作成したり、エージェントを準備したりすることなく、特定のタスクを実行する。
+ 実行時にエージェントを作成して呼び出すことで、単純なクエリを実行するか、単純なタスクでコードインタプリタを使用する。
+ タスクまたは会話で連携する複数のエージェントを[マルチエージェントコラボレーション](agents-multi-agent-collaboration.md)設定で作成する。

  マルチエージェントコラボレーションを使用する場合、インラインエージェント API を使用して、次の組み合わせでエージェントを作成できます。  
**エージェントのタイプ**    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/bedrock/latest/userguide/agents-create-inline.html)

**サポートされているモデルとリージョン**

Amazon Bedrock エージェントでサポートされている任意の基盤モデルを使用してインラインエージェントを設定し、Amazon Bedrock エージェントがサポートされている任意のリージョンでインラインエージェントを呼び出すことができます。Amazon Bedrock エージェントでサポートされているモデルとリージョンの詳細については、以下を参照してください。
+ [Amazon Bedrock エージェントでサポートされているリージョン](https://docs.aws.amazon.com//bedrock/latest/userguide/agents-supported.html)
+ [機能別のモデルサポート](https://docs.aws.amazon.com//bedrock/latest/userguide/models-features.html)

インラインエージェントでは、モデルを切り替えることができます。同じファミリーに属するモデルに切り替えることをお勧めします。異なるファミリーに属するモデルに切り替えると、動作に一貫性がなくなり、障害が発生する可能性があります。

インラインエージェントの設定と呼び出しは、現在 Amazon Bedrock コンソールではサポートされていません。

## インラインエージェントに詳細プロンプトテンプレートを使用するためのガイドライン
<a name="advanced-prompts-inline-guidelines"></a>
+ **ベースプロンプトテンプレート** – デフォルトでは、Amazon Bedrock はインラインエージェントにデフォルトのベースプロンプトテンプレートを使用しますが、プロンプトはいつでもバックグラウンドで変更できます。これにより、レスポンスに一貫性がなくなる可能性があります。クエリへのレスポンスに一貫性を持たせる必要がある場合は、デフォルトのベースプロンプトテンプレートのロジックを独自の設定で上書きして、インラインエージェントの動作をカスタマイズします。詳細については、「[詳細プロンプトテンプレート](https://docs.aws.amazon.com//bedrock/latest/userguide/advanced-prompts-templates.html)」を参照してください。
+ **暗号化** – `customer managed key ` を使用して保管時のセッションの詳細を暗号化します。カスタマーマネージドキーを使用してセッションを開始した場合、そのカスタマーマネージドキーは同じセッションに対して今後行われるすべてのリクエストに必要です。同じセッションで別のカスタマーマネージドキーを使用すると、例外が発生します。
+ **セッションの共有** – 今後のセッションはすべて、ロールレベルではなくアカウントレベルになります。`agentName` に一意の値を指定することで、エージェントレベルでセッションを分離できます。
+ **インラインセッションの状態** – `InlineSessionState` 内の属性はセッションを通じて保持されます。この属性を使用して、モデルと[数ショットプロンプト](https://docs.aws.amazon.com//bedrock/latest/userguide/what-is-a-prompt.html#few-shot-prompting-vs-zero-shot-prompting)に追加のコンテキストを提供します。