
エージェントメモリとは、エージェントが実行をまたいで会話履歴を保持する仕組みです。Agents SDKのセッションを例に、保存のタイミング、実装の選択肢、注意点を整理します。
読み方:えーじぇんとめもり。エージェントメモリ(Agent Memory)とは、AIエージェントが実行をまたいで会話の履歴を保持し、次のやり取りに引き継ぐ仕組みです。このページでは、OpenAIのAgents SDKが提供するセッションを例に、保存のタイミング、選べる実装、設計時の注意点を整理します。
Agents SDKのドキュメントは、セッションを「複数回のエージェント実行にわたって会話履歴を自動で保つ、組み込みの記憶」と説明しています。開発者が毎回 to_input_list() を呼んで履歴を組み立てる代わりに、SDKが保存と読み込みを受け持ちます。チャットのように同じ相手と何度もやり取りする場面で使う機能です。
同じドキュメントは、SDK側で履歴を管理するこの方式と、OpenAIのサーバー側で継続を管理する方式(conversation_id、previous_response_id など)を区別しています。1回の実行の中でセッションとこれらの指定を併用することはできません。
動きは2つの時点に分かれます。実行の前には、そのセッションに保存されている会話履歴を取り出し、今回の入力の前に差し込みます。実行の後には、その回に生まれた項目(利用者の入力、モデルの応答、ツールの呼び出しなど)をセッションへ書き戻します。結果として、同じセッションIDで呼び出す限り、前回までの文脈が毎回の入力に含まれます。
| 時点 | 起きること |
|---|---|
| 実行の前 | 保存済みの履歴を取り出し、今回の入力の前に置く |
| 実行の後 | 今回生まれた入力・応答・ツール呼び出しを保存する |
| 再開時 | 同じセッションIDと同じ保存先を指定すると、続きから再開できる |
ドキュメントには複数の実装が用意されています。手元の検証にはSQLite、複数台で共有するならRedisやMongoDB、既存のデータベースに載せるならSQLAlchemy、暗号化して保存したい場合は暗号化セッションといった具合です。OpenAIのConversations APIを使う方式と、履歴が長くなったときに圧縮する方式も用意されています。
保存先を変えると、再開できる範囲も変わります。同じセッションIDでも保存先が違えば別の履歴を読むため、環境を移すときは保存先ごと移します。
承認待ちで止まった実行を再開する場面を想定します。ツールの実行前に承認を求めて処理が中断した場合、同じセッションを渡して再開すると、中断前までの履歴を引き継いだ状態から続けられます。承認の設計はヒューマン・イン・ザ・ループのページで扱っています。
履歴そのものを直したい場合は、誤った項目を1件だけ取り除く操作が用意されています。訂正のために会話を作り直すのではなく、該当の項目を外して次の実行に進めます。
履歴は放っておくと伸び続けます。ドキュメントには、取り出す履歴の量を制限する設定と、履歴を圧縮する仕組みが用意されています。入力が長くなるほどモデルの精度が一様でなくなる現象はコンテキストロットとして知られており、履歴を溜めるほど安全になるわけではありません。
保存先の扱いも設計に含めます。SQLiteのようにファイルとして置かれる保存先では、そのファイルに触れられる範囲がそのまま履歴の保護範囲になります。個人情報を含む会話を扱う場合は、暗号化された保存先を選ぶか、保存する項目を絞ります。
履歴の保持は、APIやSDKから組み込む機能です。料金と提供条件は各サービスの公式情報で確認してください。
出典:OpenAI「OpenAI Agents SDK ドキュメント:セッション」(2026年11月18日閲覧)。実行前の履歴の差し込みと実行後の保存、サーバー側の継続方式との併用不可、組み込みの保存先の種類、履歴の量の制限と圧縮、項目単位の取り除き、SQLiteの保存先の扱いは同ドキュメントの記載に基づきます。
本記事にはアフィリエイトリンクを含む場合があります。経由での申し込み時に当サイトが報酬を受け取ることがありますが、掲載内容・評価は報酬の有無に左右されません。記載情報は公開時点のものであり、最新情報は各公式サイトをご確認ください。
編集部の評価方法論を見る →