エージェントに分離されたセッションを使用する

Amazon Bedrock AgentCore ランタイムを使用すると、各ユーザーセッションを分離し、ユーザーセッション内の複数の呼び出し間でコンテキストを安全に再利用できます。AI エージェントワークロードには、固有の運用特性があるため、セッション分離が不可欠です。

エフェメラルコンテキストについて

デフォルトでは、セッションに関連付けられたコンピューティング (microVM) はエフェメラルです。メモリに保存されたデータやディスクに書き込まれたデータは、コンピューティングライフサイクルでのみ保持されます。これには、会話履歴、ユーザー設定、中間計算結果、エージェントが保持するその他の状態情報が含まれます。

セッションの停止/再開サイクルにわたってファイルシステムデータを保持するには、コンピューティングの終了後も存続する永続ディレクトリであるセッションストレージを設定します。AgentCore ランタイムのファイルシステム設定」を参照してください。

セッションの存続期間を超えて保持する必要がある構造化データ (ユーザーの会話履歴、学習した設定、重要なインサイトなど) には、AgentCore Memory を使用します。このサービスは、エージェントワークロード専用に設計された専用永続ストレージを提供し、短期メモリ機能と長期メモリ機能の両方を備えています。

拡張会話とマルチステップワークフロー

各リクエストの後に終了する従来のサーバーレス関数とは異なり、AgentCore は、ライフサイクルごとに最大 8 時間持続するエフェメラルコンピューティングによってバックアップされた分離セッションをサポートします。これにより、以前のやり取りによって確立されたコンテキストに基づいて各呼び出しが構築されるため、同じ環境に複数の呼び出しを実行できるため、複数ステップのエージェントワークフローの構築が簡素化されます。InvokeAgentRuntime エージェントの推論と、同じセッション内での決定的なシェルコマンドの実行InvokeAgentRuntimeCommandの両方に使用できます。

AgentCore ランタイムセッションのライフサイクル

セッションの作成

アプリケーションが提供する一意の runtimeSessionId を使用して、最初の呼び出し時に新しいセッションが作成されます。AgentCore ランタイムは、セッションごとに専用の実行環境 (microVM) をプロビジョニングします。コンテキストは、同じセッションへの呼び出し間で保持されます。InvokeAgentRuntime と の両方が同じセッションでInvokeAgentRuntimeCommand動作します。コマンドはエージェントと同じコンテナ、ファイルシステム、および環境を表示します。

セッションの状態

セッション状態はコンピューティングライフサイクルによって決定され、次のいずれかになります。

セッションの使用方法

セッションを効果的に使用するには:

会話にセッションを使用する例

# First message in a conversation

response1 = agent_core_client.InvokeAgentRuntime(
   agentRuntimeArn=agent_arn,
   runtimeSessionId="user-123456-conversation-12345678", # or uuid.uuid4()
   payload=json.dumps({"prompt": "Tell me about AWS"}).encode()
)

# Follow-up message in the same conversation reuses the runtimeSessionId.

response2 = agent_core_client.InvokeAgentRuntime(
   agentRuntimeArn=agent_arn,
   runtimeSessionId="user-123456-conversation-12345678", # or uuid.uuid4()
   payload=json.dumps({"prompt": "How does it compare to other cloud providers"}).encode()
)

関連する呼び出しに同じ runtimeSessionId を使用することで、会話全体でコンテキストが維持され、エージェントが以前のやり取りに基づいて一貫したレスポンスを提供できるようになります。

プロトコル別のセッションヘッダー

エージェントを呼び出すときは、適切なセッションヘッダーを含めて、リクエストが同じmicroVM にルーティングされるようにします。ヘッダーは、エージェントが設定したプロトコルによって異なります。

MicroVM の維持: Amazon Bedrock AgentCore はセッションヘッダーを使用して、リクエストを同じ microVM インスタンスにルーティングします。クライアントは、レスポンスで返されたセッション ID をキャプチャし、以降のすべてのリクエストに含めて、セッションのアフィニティを確保する必要があります。一貫したセッション ID がないと、各リクエストが新しいmicroVM にルーティングされ、コールドスタートによるレイテンシーが増加する可能性があります。

ステートレスモードやステートフルモードなどの MCP プロトコルの詳細については、「MCP セッション管理と microVM の維持」を参照してください。