会話履歴とマルチターン対話

「田中太郎のメール署名を作って」と依頼した直後に「じゃあ、部署を営業部に変えて」と続けたとき、エージェントが前のやりとりを覚えていないと、「何の何を営業部に変えるのか」を毎回聞き返してしまい、対話として成立しません。

1. 概要

「田中太郎のメール署名を作って」と依頼した直後に「じゃあ、部署を営業部に変えて」と続けたとき、エージェントが前のやりとりを覚えていないと、「何の何を営業部に変えるのか」を毎回聞き返してしまい、対話として成立しません。実運用のチャットボット型エージェントでは、複数ターンにまたがるやりとりを自然に扱える仕組みが必須です。

AgentCore Runtime の runtimeSessionId(CLIの --session-id)を活用すれば、同じセッションIDで呼び続けている限り Runtime 側でセッションの状態が保持され、Agent インスタンスも前のターンのメッセージを覚えた状態で応答できます。セッションIDを変えれば、それぞれ独立した別会話として扱われます。

このセクションは、コードの書き換えは不要です。agentcore invoke の呼び方だけを変えて、履歴が保持されることを体感します。

2. 前セクションのコードの再利用

コードの書き換えは不要で、前セクションと同じ main.py のまま動作確認に入ります。ここでは、Agent Inspector(ローカル)・AWSマネジメントコンソール・AgentCore CLI の3通りで同じマルチターン挙動を確認していきます。3通り試すことで、実運用で使いそうな各インターフェースが同じセッションIDの仕組みで動くことを体感できます。

3. コードの解説

Strands の Agent(...) インスタンスは、同じセッションID内で呼ばれた際に、Strands 内部で会話履歴を保持します。これが AgentCore Runtime の runtimeSessionId と結びつくことで、「同じセッションIDで呼び続ければ、前のターンのやりとりを踏まえた応答が返る」構造になっています。

なお、Runtime のセッション状態は基本的にはセッションの寿命の間だけ保持され、セッションが終わると失われます。「昨日のユーザとの会話内容を明日も引き継ぎたい」「複数セッションをまたいでユーザの嗜好を覚えておきたい」といった セッションをまたぐ永続的なメモリ管理 は、AgentCore Memoryで会話履歴を保持しよう で扱う AgentCore Memory に任せる形になります。本章では「同じ session-id で呼び続ければ短期的な履歴は自動で保持される」ことを押さえるところまでにとどめます。

4. 動作確認

セッションIDによる履歴保持を、Agent Inspector(ローカル)→ 再デプロイ → AWSマネジメントコンソール → AgentCore CLI の順で確認していきます。いずれも同一 session-id で呼び続けると前ターンの情報が使われ、session-id を変えると別会話として扱われることを体感します。

4.1 Agent Inspector での確認

Agent Inspector は、同じチャット画面で送信した複数メッセージが自動的に同じセッションID(画面右上に session: xxxxxxxx... として表示される値)でリクエストされます。前セクションから起動したままの agentcore dev の Agent Inspector を開き、以下を順に送信します。

1ターン目:

田中太郎(開発部 エンジニア、tanaka@example.com)のメール署名を作って

田中太郎の署名が返ります。続けて、同じチャットで2ターン目を送信します。

じゃあ、部署を営業部に変えて

田中太郎の営業部版署名 が返れば、Runtime が前ターンの情報(氏名・役職・メールアドレス)を覚えている状態です。もし履歴が保持されていなければ、「何の何を変えるのか」を確認する応答が返るはずです。

画面右上のセッションID(session: d9c3...)が両ターンで共通で、1ターン目に比べて2ターン目の入力トークン数が増えている(例: 989 in → 1.6k in)ことも、前ターンの履歴が Runtime にまとめて渡されている裏付けになります。

別セッションの挙動も確認します。ブラウザをリロードして新しいセッションを開始し、2ターン目と同じ質問だけを送ります。今度は前の情報を持たないため、「氏名・役職・メールアドレスが不足しています」といった応答が返るはずで、これが「session-id を変えると別会話として扱われる」証拠になります。

4.2 AgentCore Runtime への再デプロイ

このあと AgentCore CLI とマネジメントコンソールでも同じ挙動を確認しますが、それらはクラウドの Runtime を呼び出すため、ここまでのセクションで書き換えてきた main.py の内容を先に反映しておきます。agentcore deploy を実行したターミナル(MyAgent フォルダにいる状態)に戻り、以下を実行します。

agentcore deploy

初回と違い、2回目以降は CDK bootstrap もリソース作成もスキップされるため、Deploy to AWS Complete まで数十秒〜1分程度で完了します。

反映されたことは、マネジメントコンソールのランタイム詳細画面でも確認できます。エンドポイント の紐付けが新しい バージョン 2 に切り替わり、バージョン 一覧にも バージョン 2 が追加されています(アップデートのたびに自動でスナップショットが作られるため、旧バージョンもロールバック用に残ります)。

4.3 AWSマネジメントコンソールでの確認

再デプロイ後、AgentCore コンソールで対象ランタイムの詳細画面を開き、右上「テスト」ボタンからテストUIを開きます。テスト画面では セッションID を明示的に指定 できるので、それを使ってマルチターンを試します。

セッションID はテストUIが自動で UUID を挿入するので、そのまま使います(AgentCore Runtime はセッションIDに 33 文字以上の文字列を要求するため、実務でも UUID を使うのが一般的です)。入力 欄に以下のJSONを貼って「実行」をクリックします。

{"prompt": "田中太郎(開発部 エンジニア、tanaka@example.com)のメール署名を作って"}

出力 欄に、田中太郎の署名を含む {"result": "..."} が返ります。前セクションまでで整えたシステムプロンプトが効いているため、応答は署名のみで、前置き・後書きは付きません。

続いて、セッションID は同じまま、入力 欄を以下に書き換えてもう一度「実行」をクリックします。

{"prompt": "じゃあ、部署を営業部に変えて"}

前ターンの情報(氏名・役職・メールアドレス)が保持されているため、部署だけが 営業部 に差し替わった署名が返ります。

対比のため、セッションID の欄に別の UUID を貼り付けて(uuidgen 等で生成、または セッションID を一度クリアして「例を表示」から新しい UUID を取得)、もう一度2ターン目の質問だけを送ります。今度は新規セッションのため、氏名・役職・メールアドレスの不足を返してくるはずです。

4.4 AgentCore CLI での確認

同じマルチターン挙動を、AgentCore CLI からも確認できます。agentcore invoke の --session-id フラグでセッションIDを指定します。

AgentCore Runtime はセッションIDに 33 文字以上の文字列を要求する ため、以下では UUID を2つ生成し、環境変数 SESSION_1(1ターン目・2ターン目共通で使用)と SESSION_2(別セッション対比用)に控えたうえで、--session-id に渡して実行していきます。

agentcore deploy を実行したターミナル(MyAgent フォルダにいる状態)で、UUID を2つ生成して環境変数に代入します。

Macの場合:

export SESSION_1=$(uuidgen)
export SESSION_2=$(uuidgen)

Windowsの場合(PowerShell):

$env:SESSION_1 = [guid]::NewGuid().ToString()
$env:SESSION_2 = [guid]::NewGuid().ToString()

以降のコマンドは Mac の記法($SESSION_1 / $SESSION_2)で掲載します。Windows PowerShell の場合は $env:SESSION_1 / $env:SESSION_2 に読み替えてください。

まず、SESSION_1 を使って1ターン目を送ります。

agentcore invoke --session-id $SESSION_1 --prompt "田中太郎(開発部 エンジニア、tanaka@example.com)のメール署名を作って"

以下のような実行結果が表示されます。

━━━━━━━━━━━━━━━━━━━━━━
【田中太郎】DevOps株式会社 開発部 エンジニア
Email: tanaka@example.com
Tel:   03-1234-5678
━━━━━━━━━━━━━━━━━━━━━━


Session: 25CD8BBC-AE48-4FBC-BC5A-5B1ECB702B6C
To resume: agentcore invoke --session-id 25CD8BBC-AE48-4FBC-BC5A-5B1ECB702B6C
Log: <MyAgentプロジェクトのパス>/agentcore/.cli/logs/invoke/invoke-MyAgent-<YYYYMMDD-HHMMSS>.log

田中太郎(開発部)の署名だけが返り、前セクションまでで整えたシステムプロンプトが効いているため前置き・後書きが付いていません。末尾の Session: に、今回のリクエストで使われたセッションID(SESSION_1 の値)が表示されます。

続けて、同じ SESSION_1 で2ターン目を送ります。

agentcore invoke --session-id $SESSION_1 --prompt "じゃあ、部署を営業部に変えて"

以下のような実行結果が表示されます。

━━━━━━━━━━━━━━━━━━━━━━
【田中太郎】DevOps株式会社 営業部 エンジニア
Email: tanaka@example.com
Tel:   03-1234-5678
━━━━━━━━━━━━━━━━━━━━━━


Session: 25CD8BBC-AE48-4FBC-BC5A-5B1ECB702B6C
To resume: agentcore invoke --session-id 25CD8BBC-AE48-4FBC-BC5A-5B1ECB702B6C
Log: <MyAgentプロジェクトのパス>/agentcore/.cli/logs/invoke/invoke-MyAgent-<YYYYMMDD-HHMMSS>.log

前ターンの情報(田中太郎の氏名・役職・メールアドレス)が保持されているため、部署だけが 営業部 に差し替わった署名が返ります。Session: の値が1ターン目と同じ(例では 25CD8BBC-...)であることも、同一セッション内のやりとりであることを示しています。

対比のため、SESSION_2 に切り替えて同じ2ターン目の質問を送ってみます。

agentcore invoke --session-id $SESSION_2 --prompt "じゃあ、部署を営業部に変えて"

以下のような実行結果が表示されます。

前回の会話履歴がないため、氏名・役職・メールアドレスが確認できません。以下の項目を教えてください。

- 氏名
- 役職
- メールアドレス


Session: DFD3C45B-038C-4A9D-8C7A-8C8A832A1F0D
To resume: agentcore invoke --session-id DFD3C45B-038C-4A9D-8C7A-8C8A832A1F0D
Log: <MyAgentプロジェクトのパス>/agentcore/.cli/logs/invoke/invoke-MyAgent-<YYYYMMDD-HHMMSS>.log

SESSION_2 は新規セッションのため、前の田中太郎の情報を持たない状態です。モデルは「情報が不足しています」の形で確認を返し、Session: の値も別 UUID(例では DFD3C45B-...)に変わっています。これが「session-id を変えると別会話として扱われる」証拠になります。

⚠️ 「Value at 'runtimeSessionId' failed to satisfy constraint」エラーが出る場合
--session-id に指定した値が短すぎる(33 文字未満)ときに発生します。AgentCore Runtime のセッションIDは 33 文字以上必要なので、my-chat-001 のような短い任意文字列は通りません。uuidgen(Mac)や [guid]::NewGuid().ToString()(Windows PowerShell)で生成した UUID をそのまま指定してください。

以上のように、チャットボットのように前ターンのやりとりを踏まえた応答が必要な ケースでは、クライアント側から同じ session-id で呼び続けるだけで、Runtime 側で会話履歴が自動的に保たれます。ユーザやスレッドごとに session-id を分ければ、複数の会話を同じ Runtime で並行して捌けます。Agent Inspector・マネジメントコンソール・AgentCore CLI のいずれから呼び出しても同じ仕組みで動き、コード側の変更なしに呼び出し側の引数だけで完結するのが、Strands + AgentCore Runtime のシンプルな設計のポイントです。