本文へ移動
← 目次 AIエージェント0→1 DAY 07

第2章|エージェントを動かす部品を確かめる。

DAY 07 ・ 約15〜20分

コンテキストと状態管理

今モデルに見えている情報と、仕事の現在地を分けて管理する。

今日できるようになること

コンテキスト、会話履歴、作業状態、チェックポイントを区別し、長い仕事を安全に継続・再開できる。

01 言葉を知る02 仕組みを理解する03 実例で理解する04 今日の理解度を確認する05 今日の整理をする
01|言葉を知る

言葉を知る

コンテキスト

その一回の判断でモデルへ渡され、実際に参照できる指示、会話、資料、ツール結果などの情報。

コンテキストウィンドウ

モデルが一度に扱える入力と出力の範囲。容量内でも、情報が多過ぎると重要事項が埋もれることがあります。

状態

仕事の現在地を表す構造化された情報。完了済み工程、未完了工程、対象、承認、再開位置などを含みます。

セッション

同じ利用者や仕事の複数回のやり取りを関連付け、会話履歴などを継続利用するための単位。

チェックポイント

長い処理の途中状態を保存し、停止や障害のあとに同じ位置から再開するための記録。

長期記憶

複数のやり取りにまたがって利用できるよう保存する情報。

要約

元の情報の要点を残して短くまとめたもの。

02|仕組みを理解する

仕組みを理解する

長い仕事では「覚えているつもり」が事故になる

チャットAIへ一度質問するだけなら、利用者の依頼と必要な資料を同じ画面へ入れ、回答を受け取れば終わります。しかしAIエージェントは、検索、比較、下書き、確認、保存などを何段階も進めます。途中でツールの結果が増え、人の承認を待ち、別の実行環境で再開することもあります。そこで必要になるのが、モデルへ今何を見せるかを決めるコンテキスト管理と、仕事がどこまで進んだかを残す状態管理です。 この二つを「AIの記憶」とまとめると、問題の原因を見分けにくくなります。モデルが先ほどの条件を使わなかった時、会話履歴が保存されていないのか、保存されていても今回の入力へ入らなかったのか、古い情報に埋もれたのか、状態データが更新されていないのかで対策は変わります。「覚えておいて」と頼むだけでは、どこへ、どの期間、どの形式で保存され、次回どう読み込まれるかは決まりません。 OpenAI Agents SDKでは、会話履歴を維持するSessionsと、ツールやコードへ依存情報を渡すローカルなcontextを区別しています。後者はそのままモデルへ送られる情報ではありません。この例からも、製品で「context」「memory」と呼ばれるものが、すべてモデルの目に入る文章とは限らないと分かります。名前ではなく、保存場所、読み込む時点、モデルへ渡す範囲を確認します。

コンテキストはモデルの作業机

コンテキストは、モデルが一回の判断で参照できる作業机にたとえられます。机の上には、システムの規則、今回の目的、会話履歴、検索結果、開いた文書、利用できるツールの説明、直前のエラーなどが置かれます。倉庫に資料が保存されていても、検索されず机へ置かれなければモデルは使えません。反対に、机へ置かれた外部文書はモデルの判断へ影響します。 コンテキストウィンドウは、この机の広さに当たります。上限を超える情報はそのまま全部扱えませんが、上限以内なら何でも正確に読めるわけでもありません。古い会話、重複したログ、巨大な検索結果を積み上げれば、重要な制約が埋もれます。Anthropicは、エージェントが長く動くほど生成データが増えるため、利用可能な情報全体から各判断に必要なトークンを選び直すことをコンテキストエンジニアリングとして説明しています。 良い管理では、目的、必須制約、現在の作業、必要な証拠を優先し、関係の薄い履歴を削るか要約します。ただし要約は原文と同じではありません。数字、例外、否定条件、未確認事項が落ちる可能性があるため、重要な確定事項は構造化して別に保存し、必要に応じて原文へ戻れる参照先を残します。

状態は仕事の現在地を示す地図

状態とは、会話の文章ではなく、仕事が今どこにあるかを示す情報です。たとえば記事制作なら、対象期間、採用した情報源、確認済みの事実、原稿の保存先、文字数検査の結果、公開承認の有無、次に行う工程が状態です。「さっき記事について相談した」という会話履歴だけでは、どの工程が完了したかを機械的に判断できません。 状態は、未着手、実行中、承認待ち、完了、失敗のような段階と、対象ID、更新日時、実行者、完了証拠を組み合わせて持ちます。重要なのは、モデルが自然文で「完了」と書いたことではなく、検査に合格し、成果物が保存され、必要な承認が記録された時だけ完了状態へ変えることです。状態をモデルの自己申告だけで更新すると、実際には送れていないのに送信済みになる危険があります。 会話履歴は「何を話したか」、コンテキストは「今モデルに何が見えているか」、状態は「仕事がどこまで進んだか」です。三つは重なる部分がありますが、役割は異なります。人の名前や好みを会話から参照できても、注文処理の完了状態にはなりません。反対に、注文が発送待ちという状態を保存していても、その理由や顧客との細かなやり取りを説明するには履歴が必要です。

セッションは会話をつなぐが、万能な記憶ではない

セッションは、同じ会話や同じ仕事に属する複数回の実行を関連付ける単位です。OpenAI Agents SDKのSessionsは、特定セッションの会話履歴を保存し、次の実行で文脈を維持できる仕組みです。利用者が「さっきの案を短くして」と続けた時、以前の依頼と回答を使えるようにします。 ただし、履歴を自動保存することと、必要な事実を正しく長期保存することは同じではありません。会話には途中案、誤り、撤回された指示、別の話題も入ります。すべてを次回へ渡すと、古い条件が現在の指示と競合します。重要な決定は「決定事項」「有効期限」「根拠」「更新者」のように整理し、会話履歴から分離します。 また、セッションIDの取り違えは情報漏えいにつながります。別の顧客や別案件の履歴を同じセッションへ混ぜてはいけません。利用者、案件、権限を照合し、セッションを推測しにくい識別子で管理します。保存期間を定め、不要になった個人情報を残し続けないことも必要です。便利な継続会話の裏側には、誰の情報をどこまで再利用するかという権限設計があります。

短い記憶・確定事項・作業状態を分ける

実務では、保存する情報を三層に分けると整理しやすくなります。第一は、その場の会話や直前のツール結果など、現在の判断に必要な短期情報です。第二は、会社名、表記規則、承認された方針のように、複数の仕事で再利用する確定事項です。第三は、今回の仕事の完了工程、対象ファイル、再開位置などの作業状態です。 短期情報は、仕事が終われば捨てられるものが多くあります。確定事項は長く使いますが、誰がいつ決め、いつまで有効かを持たせます。作業状態は工程ごとに更新し、完了後は監査記録として必要な期間だけ残します。三層を一つの長いメモへ混ぜると、過去の一時案が正式ルールのように再利用されたり、別案件の途中状態が入り込んだりします。 モデルへ渡す時も、保存データを全部貼り付けません。現在の仕事に関係する確定事項を検索し、作業状態から次の工程を選び、必要な原文だけを取得します。読み込んだ情報には出所と更新日時を付けます。矛盾があれば新しいほうを自動採用せず、正本、承認記録、有効期限を確認します。

チェックポイントで止まっても続けられるようにする

長時間のエージェントは、通信障害、利用上限、人の承認待ち、サーバー更新で止まります。チェックポイントは、その時点の状態を保存し、後から再開するための記録です。Microsoft Agent Frameworkは、長時間ワークフローの進捗を保存し、障害後の再開、監査、別環境への移動に使えるものとしてチェックポイントを説明しています。 保存するのは会話だけではありません。完了済み工程、次の工程、ツール実行の結果、成果物の場所、承認状態、再試行回数、外部操作の識別子が必要です。再開時には、保存形式が現在のプログラムで読めるか、権限がまだ有効か、外部の対象が変わっていないかを確認します。 特に送信、決済、予約、公開は、停止直前に成功していても成功応答だけ受け取れなかった可能性があります。チェックポイントから同じ操作を無条件に再実行すると二重処理になります。再開時は外部の送信履歴や取引状態を調べ、未実行の場合だけ続けます。同じ要求を一度だけ反映させるための識別子も利用します。

チャットAIとの違いは継続時間と外部状態に表れる

通常のチャットAIでは、会話履歴を参照して前の答えを言い換えるだけでも役立ちます。利用者が結果を確認し、現実の操作は自分で行うため、仕事の状態は人が把握できます。会話が切れたら、必要な前提をもう一度説明して再開することもできます。 エージェントでは、モデルの判断が外部ツールと次の工程へつながります。会話を覚えていても、どのメールを下書き済みか、どのファイルを変更したか、公開承認を得たかが分からなければ安全に続けられません。反対に、状態だけ残っても、判断根拠となった資料が失われれば、修正や監査ができません。 できることは、複数日にまたがる調査、承認待ちからの再開、障害後の復旧、複数担当への引き継ぎです。できないことは、保存していない情報を後から正確に復元すること、古い状態だけから現在の外部世界を保証すること、別利用者の情報を権限なしに参照することです。継続できる仕組みは、何でも永遠に覚える仕組みではありません。

失敗例から必要な分離を見つける

一つ目の失敗は、会話履歴をそのまま正本にすることです。途中で「やはりAではなくB」と変わった時、AとBの両方が残ります。次回のモデルが古いAを使うかもしれません。決定が変わったら確定事項を更新し、旧内容は履歴として無効状態にします。 二つ目は、状態を自然文だけで残すことです。「だいたい調査済み。次は記事を書く」のような記録では、確認した資料、未確認の論点、保存場所が分かりません。工程名、対象、結果、証拠、次の処理を定めた形式で保存します。 三つ目は、コンテキストを減らすために要約だけを残し、重要な原文を失うことです。契約条件、金額、否定表現、例外は短い要約で意味が変わる可能性があります。要約と原文の参照を結び付け、重大判断では原文へ戻ります。 四つ目は、再開時に現在の外部状態を見ないことです。保存時には未送信でも、その後に人が送った可能性があります。チェックポイントは過去の写真であり、現在そのものではありません。再開前に差分を確認します。

安全上の注意は保存・読込・削除の全段階にある

コンテキストへ機密情報を入れ過ぎると、不要なツール出力や後続処理へ漏れる範囲が広がります。モデルに必要な項目だけを渡し、秘密鍵やパスワードは保存せず、専用の認証管理から実行時に扱います。ログにも本文を丸ごと残さず、目的に必要な情報へ絞ります。 外部文書やWebページには、エージェントへ指示するような悪意ある文章が含まれる可能性があります。これは資料であり、システムの規則や承認状態を変更する命令ではありません。取得元、信頼度、権限を付け、外部データと内部の確定事項を分けます。 状態の改ざんにも備えます。誰がいつ何を更新したかを記録し、重要な完了や承認はモデルだけで変更できないようにします。個人情報には保存目的、期間、削除方法を定めます。削除後も要約やバックアップへ残っていないか確認します。安全な記憶とは多く残すことではなく、必要な情報を正しい相手へ、正しい期間、検証可能な形で残すことです。

状態表を作って小さく再開試験をする

読者演習では、二日以上かかる仕事を一つ選びます。紙や表計算に、目的、現在の工程、完了済み、未完了、成果物、根拠、承認、次の行動、更新日時の欄を作ります。会話履歴へ残す内容、確定事項として保存する内容、作業状態として持つ内容を色分けします。 次に、作業の途中で意図的に停止した想定を作ります。別の人が状態表だけを見て、重複せず次の工程から始められるか確認します。分からない項目があれば、自由記述を増やす前に、対象ID、証拠URL、承認者、再開条件などの欄を追加します。 最後に、再開前の確認を決めます。外部対象は変わっていないか、権限は有効か、すでに誰かが実行していないか、保存した指示は最新版かを調べます。正常再開だけでなく、状態が古い、証拠が消えた、承認が取り消された場合も試します。DAY7で持ち帰る中心は、コンテキストは今見える情報、状態は仕事の現在地、チェックポイントは再開の起点という分離です。分けて保存し、必要な時だけ結び付けることで、長い仕事を安全に続けられます。

03|実例で理解する

実例で理解する

具体例で考える

問い合わせ記事の制作では、会話履歴に相談の流れ、確定事項に対象読者と表記規則、作業状態に調査済みURL・未確認論点・原稿保存先・承認状態を残します。モデルへは今回の工程に必要な情報だけを渡します。公開直前で停止した場合、再開時に公開履歴と承認の有効性を確認し、未公開の場合だけ実行します。

手を動かして理解する

  1. 二日以上かかる仕事を一つ選び、状態表を作る
  2. 会話履歴・確定事項・作業状態へ情報を分類する
  3. 途中停止を想定し、別の人が重複なく再開できるか試す
  4. 状態が古い場合と承認が取り消された場合の停止条件を書く

04|今日の理解度を確認する

DAY 7の理解度を確認する

1 / 5
QUESTION 01

コンテキストと作業状態の違いを説明するものとして、最も適切なのはどれですか。

QUESTION 02

公開作業を途中から再開する時、最初に確認すべきものはどれですか。

QUESTION 03

長期利用する情報の保存方法として、最も適切なものはどれですか。

QUESTION 04

状態表だけを見て安全に再開するため、最も必要な項目の組み合わせはどれですか。

QUESTION 05

コンテキストへ外部Webページを入れる時の扱いとして、最も適切なものはどれですか。

05|今日の整理をする

今日の整理をする

ここまで分かれば次へ

  • ✓ コンテキストは今モデルに見える情報、状態は仕事の現在地
  • ✓ 会話履歴・確定事項・作業状態を分け、必要な情報だけを読み込む
  • ✓ チェックポイントから再開する前に、外部状態と権限を再確認する

講義本文 4,762字

参考資料

公式の一次情報で確かめる

NEXT LESSONDAY 8「ツール・API・Function Calling」へ次のDAYに進む →