管理型ディープエージェント：指示とコンテキストハブ

管理型ディープエージェント：コード再デプロイ不要の「指示」管理術

LangChain の管理型ディープエージェントにおいて、開発者がエージェントの振る舞いを決定づけるのは、実は複雑なアルゴリズムではなく「指示（Instructions）」です。この機能を使えば、ローカル環境でテストした変更をコンテキストハブ経由で即時反映できるため、コードの再デプロイなしに本番環境での挙動を柔軟に調整できます。

指示がエージェントの振る舞いを決定する仕組み

管理型ディープエージェントの動作は、instructions.md ファイルに記載された指示によって定義されます。このファイルを変更すると、即座にエージェントのシステムプロンプトに反映され、応答言語やタスクの実行方法などを動的に変化させることが可能です。

例えば、ローカル環境で instructions.md に「イタリア語で回答すること」という指示を追加し、mda dev コマンドを実行してエージェントを起動します。チャット画面で「Hi」と尋ねると、エージェントは即座にイタリア語で返答を開始します。

「この指示が変更されたことで、システムプロンプトの内容が変わり、エージェントの振る舞いが変化していることが確認できます」

実際のシステムプロンプトを確認すると、instructions.md に記載した内容に加え、シェルパスと仮想パスの違いや、デフォルトで有効になっているツールに関する説明など、LangChain が背景で管理する情報も含まれています。最近ではレスポンス速度を向上させるため、このハーン（harness）はよりモジュール化され、最小限かつ効率的なプロンプト構成へと進化しています。

コンテキストハブでの即時編集と本番環境への反映

管理型ディープエージェントの真価を発揮するのが「コンテキストハブ」です。ここを使えば、UI 上で指示を直接編集・保存するだけで、コードを再デプロイすることなく本番環境のエージェント挙動を変更できます。

例えば、本番環境のコンテキストハブで指示を「スペイン語で回答すること」に変更し、保存します。その後、開発者スタジオや本番アプリケーションからエージェントに問いかけると、即座にスペイン語での返答が得られます。これにより、プロダクション環境でも瞬時にテストと調整が可能になります。

「ローカルで変更しても本番には反映されませんが、コンテキストハブ上で編集して保存すれば、コードの再デプロイなしに本番エージェントの挙動を即座に変更できます」

ローカルとハブ間の競合処理と同期メカニズム

開発者がローカルで指示を変更している間に、本番環境（コンテキストハブ）側でも変更が加えられた場合、どうなるのでしょうか？この状況では、mda deploy コマンドを実行してもデプロイは一時停止されます。

これは裏側で instructions.md のメタデータに含まれるハッシュ値を比較しているためです。両者のバージョンに差異が生じると、システムが自動的に検知してデプロイを中断し、開発者に優先するバージョンを選択させるフローが起動します。

例えば、本番環境では「スペイン語」、ローカル環境では「イタリア語」という異なる指示がある場合、mda deploy は以下のように動作します。

1. デプロイ開始直後に、ハッシュ値の不一致を検知して一時停止。
2. 開発者に「コンテキストハブ側の編集を上書きするか？」を問う。
3. 「はい」と選択すると、ローカルのイタリア語指示が本番環境に同期され、エージェントはイタリア語で回答するようになります。

この仕組みにより、チーム開発や複数環境での運用においても、意図しない上書きを防ぎつつ、安全かつ柔軟なプロンプト管理を実現しています。