翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# セッション管理 API を使用して会話履歴とコンテキストを保存および取得する
**注記**
セッション管理 API はプレビュー版であり、変更される可能性があります。
セッション管理 API を使用すると、LangGraph や LlamaIndex などのオープンソースフレームワークで構築された生成 AI アプリケーションで進行中の会話のチェックポイントを保存できます。API を使用すると、複数ステップの生成 AI ワークフロー全体の状態と会話のコンテキストを安全に管理できます。状態とコンテキストの永続性のためにカスタムバックエンドソリューションを構築、維持、または拡張する必要はありません。
セッション管理 API を使用すると、次のことができます。
+ 反復テストとヒューマンインザループワークフローのチェックポイントワークフロー ステージ。
+ 中断した時点から会話とタスクを再開します。
+ セッションログを確認して、ワークフローステージを分析し、障害をデバッグします。
セッションは Amazon Bedrock のリソースであるため、 AWS Identity and Access Management (IAM) を使用してセッションへのアクセスを制御できます。デフォルトでは、Amazon Bedrock はセッションメタデータを含むセッション暗号化に AWSマネージドキーを使用するか、独自の AWS KMS キーを使用できます。詳細については、「[セッションの暗号化](sessions-encryption.md)」を参照してください。
Amazon Bedrock APIs または AWS SDKs を使用して、Amazon Bedrock セッションを作成および管理できます。LangGraph 上に構築されたアプリケーションの場合、`langgraph_checkpoint_aws.saver` ライブラリの `BedrockSessionSaver` クラスを使用できます。これは、LangGraph CheckpointSaver のカスタム実装です。詳細については、[LangChain](https://github.com/langchain-ai) GitHub レポジトリの「[langgraph-checkpoint-aws](https://github.com/langchain-ai/langchain-aws/tree/main/libs/langgraph-checkpoint-aws)」を参照してください。
**注記**
セッションを使用して、オープンソースフレームワークで構築された生成 AI アプリケーションの状態と会話履歴を保存します。Amazon Bedrock エージェントの場合、サービスは会話コンテキストを自動的に管理し、[InvokeAgent](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeAgent.html) API オペレーションで指定したエージェント固有の sessionId に関連付けます。
**Topics**
+ [ユースケースの例](#sessions-use-case)
+ [ワークフロー](#sessions-workflow)
+ [考慮事項](#sessions-considerations)
+ [セッションの暗号化](sessions-encryption.md)
+ [会話履歴とコンテキストを保存するための準備としてセッションを作成する](sessions-create.md)
+ [会話履歴とコンテキストをセッションに保存する](sessions-store-coversation.md)
+ [セッションから会話履歴とコンテキストを取得する](sessions-retrieve-coversation.md)
+ [ユーザーが会話を終了するとセッションを終了する](sessions-end-session.md)
+ [セッションとそのすべてのデータを削除する](sessions-delete-session.md)
+ [BedrockSessionSaver LangGraph ライブラリを使用して会話履歴とコンテキストを保存および取得する](sessions-opensource-library.md)
## ユースケースの例
LangGraph エージェントを使用して顧客の旅行日程の計画を支援するアプリケーションを持っているかもしれません。ユーザーはこのエージェントとの会話を開始して、目的地、希望するホテル、フライトの詳細を追加し、今後の旅行の日程を作成できます。
セッション管理 API を使用すると、エージェントは拡張された複数ステップのやり取り全体で中間状態と永続的コンテキストを保存できます。エージェントは、Amazon Bedrock セッションを使用して、各宛先が追加された後にその状態をチェックポイントとして設定し、顧客の設定に関する詳細を保存できます。
会話が中断または失敗した場合、エージェントはテキストや画像などのコンテキストを保持したまま、後でセッションを再開できます。これにより、エージェントは顧客に情報を繰り返してもらう必要なく続行できます。また、障害が発生した場合は、セッションの詳細を調査して原因をデバッグできます。
## ワークフロー
セッション管理 API を使用するワークフローは次のとおりです。BedrockSessionSaver ライブラリの使用の詳細については、「[BedrockSessionSaver LangGraph ライブラリを使用してセッションを管理する](sessions-opensource-library.md)」を参照してください。
+ **セッションを作成する** – エンドユーザーが初めて会話を開始するときは、[CreateSession](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_CreateSession.html) API オペレーションを使用してセッションを作成し、セッションの ID を指定します。この ID は、会話状態を保存および取得するときに使用します。
+ **会話とコンテキストを保存する** – エンドユーザーが生成 AI アシスタントを操作するときに、[CreateInvocation](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_CreateInvocation.html) API を使用してセッション内でのインタラクションのグループを作成します。呼び出しごとに、[PutInvocationStep](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_PutInvocationStep.html) API オペレーションを使用して、インタラクションごとにテキストや画像を含むきめ細かな状態チェックポイントを保存します。
+ **会話履歴とコンテキストを取得する** – [GetSession](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_GetSession.html)、[ListInvocations](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_ListInvocations.html)、[GetInvocationStep](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_GetInvocationStep.html) API オペレーションを使用して、セッションメタデータとインタラクションの詳細を取得します。
+ **セッションを終了する** – セッションが完了したら、[EndSession](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_EndSession.html) API オペレーションでセッションを終了します。セッションを終了しても、そのコンテンツにはアクセスできますが、追加することはできません。セッションとそのコンテンツを削除するには、[DeleteSession](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_DeleteSession.html) API オペレーションを使用します。
## 考慮事項
セッションを作成および管理する前に、次の点に注意してください。
+ Amazon Bedrock APIs と AWS SDKs を使用してセッションを作成および管理できます。 AWS マネジメントコンソールを使用してセッションを管理することはできません。
+ LangGraph 上に構築されたエージェントアプリケーションの場合、`langchain-aws` ライブラリから `BedrockSessionSaver` クラスを使用できます。これは、LangGraph CheckpointSaver のカスタム実装です。BedrockSessionSaver ライブラリの使用の詳細については、「[BedrockSessionSaver LangGraph ライブラリを使用してセッションを管理する](sessions-opensource-library.md)」を参照してください。コードを直接表示するには、[LangChain](https://github.com/langchain-ai) GitHub リポジトリの「[langgraph-checkpoint-aws](https://github.com/langchain-ai/langchain-aws/tree/main/libs/langgraph-checkpoint-aws)」を参照してください。
+ セッションの作成時にカスタマーマネージド AWS KMS キーを指定する場合、セッションを作成するユーザーまたはロールには、キーを使用するアクセス許可が必要です。詳細については、[セッションの暗号化](sessions-encryption.md) を参照してください。
+ セッション管理 API には次のクォータがあります。
+ すべての呼び出しにわたる 1 つのセッションでの呼び出しステップの数 – 1,000
+ 呼び出しステップごとの最大サイズ – 50 MB
+ IdleSession タイムアウト – 1 時間
+ 保持期間 – セッションデータは 30 日後に自動的に削除されます