Microsoft developer platform documentation update: TypeAgent chat panel for VS Code の要点は、TypeAgentのチャット体験がVS Code内で使える「正式なホスト」として追加されたことです。これまでElectron Shell中心だったTypeAgentの利用体験が、VS Codeのサイドパネルやエディタータブに入り、同じdispatcher、同じagents、同じchat UIを使って操作できるようになります。TypeAgentを検証している開発者、VS Code拡張としてエージェントUIを試したいチーム、既存のTypeAgent環境を更新する担当者は、インストール手順、接続先ポート、code-vscode-shellスキーマの有効化、複数パネル利用時の会話共有を確認する必要があります。関連PR #2291はGitHub上で2026年5月7日にmainへマージされています。(GitHub)
Microsoft developer platform documentation update: TypeAgent chat panel for VS Codeで何が変わったか
今回の更新は、単に「VS Codeにチャット画面を追加した」という話ではありません。TypeAgentのチャット体験をVS Codeの開発作業に組み込み、複数のチャットパネル、会話履歴の再参加、デモ実行、キャンセル・再接続UX、VS Code操作の自然言語化まで含めて整備したアップデートです。
TypeAgentは、LLMを使った個人エージェントやアプリケーションエージェントのアーキテクチャを検証するためのサンプルコードとして公開されています。Microsoftのリポジトリ説明でも、TypeAgentは本番用フレームワークではなく、自然言語インターフェースを持つ単一の個人エージェントを構築するための実験的なコードという位置づけです。(GitHub)
| 変更点 | 内容 | 確認すべき人 |
|---|---|---|
| VS Codeホストの追加 | TypeAgent ShellのチャットをVS Codeのサイドパネルやエディタータブに埋め込める | TypeAgentをVS Code上で試したい開発者 |
| 複数パネル対応 | 複数のチャットパネルで同じ会話を共有し、履歴や状態を同期できる | 複数タブで検証・デモを行うチーム |
| 接続・キャンセルUX改善 | Connected / Disconnected / Demo Modeの表示、リトライ表示、Stopボタンの実動作改善 | 検証中に接続断や長い応答を扱う人 |
| チャット入力補完 | インライン補完、ドロップダウン補完、Tab受け入れなどの入力補助 | コマンドやエージェント指定を頻繁に使う人 |
| デモランナー | .txtスクリプトを右クリックしてTypeAgent Demo Scriptとして実行可能 | ハンズオン、社内デモ、検証シナリオ作成者 |
| VS Code連携アクション | ファイル作成、エディター切り替え、テーマ変更、設定表示、会話管理などを自然言語で操作 | TypeAgentを開発ワークフローに組み込みたい人 |
github-cli agent追加 | gh CLIを自然言語で操作する新しいエージェントを追加 | GitHub CLIを使う開発者、CLIエージェント化を検討する人 |
影響範囲：すぐ対応すべき人と様子見でよい人
この更新の影響は、TypeAgentをどの立場で使っているかによって変わります。Microsoft developer platform全体の一般ユーザーに一律で影響する変更ではなく、TypeAgentリポジトリを触っている開発者や、VS Code内でTypeAgentを試す人に影響が大きい更新です。
| 対象者 | 影響 | 推奨対応 |
|---|---|---|
| TypeAgentをローカルで検証している人 | 起動手順や接続先ポート、VS Code拡張の導入が必要になる | READMEに沿ってvscode-shellを再セットアップする |
| 既存のElectron Shell中心で使っていた人 | VS Codeホストが選択肢に加わる | Electron ShellとVS Code Shellの挙動差を確認する |
| TypeAgent用のagentを開発している人 | VS Code上での表示、会話同期、client action対応を考慮する必要がある | 自作agentがVS Code Shell上で問題なく応答するか検証する |
| デモや教育用途でTypeAgentを使う人 | .txtスクリプトによるデモ実行が使いやすくなる | デモスクリプトと停止・再開操作を事前に確認する |
| 本番導入を検討している人 | 早期段階のサンプルコードである点に注意が必要 | 本番前提ではなく、検証・PoCとして扱う |
特に注意したいのは、TypeAgentが「完成した商用フレームワーク」ではない点です。リポジトリの説明では、TypeAgentは早期段階のサンプルコードであり、頻繁な更新やリファクタリングがあること、英語での検証が中心であることが示されています。日本語環境で業務利用を想定する場合は、日本語プロンプト、社内用語、ファイル名、コマンド名で期待通りにルーティングされるかを必ず検証してください。(GitHub)
VS Code Shellとして使えるようになった意味
TypeAgent chat panel for VS Codeの大きな価値は、開発者がエディターを離れずにTypeAgentのチャットを試せることです。VS Code内にサイドパネルとエディタータブの両方でチャットを開けるため、コード、設定ファイル、デモスクリプト、チャット結果を横並びで確認できます。
たとえば、次のような使い方が現実的になります。
| 利用シーン | 使い方の例 |
|---|---|
| agentの動作確認 | コードを編集しながら、同じ画面内でTypeAgentに自然言語リクエストを投げる |
| 複数会話の比較 | エディタータブで複数の会話を開き、別々のプロンプトやagent挙動を比較する |
| デモ実施 | スクリプトファイルを右クリックしてデモを走らせ、途中で一時停止・再開する |
| 障害確認 | 接続状態のリボンや再接続表示を見ながら、agent serverの停止・再起動をテストする |
| チーム内検証 | 同じ手順でVS Code拡張を入れ、再現性のある検証環境を作る |
PRでは、VS Codeのサイドバーとサイドパネルチャット、複数パネルでのセッション共有、VS Codeリロード後のセッション永続化、接続状態リボン、ショートカット、テーマ追従などが追加点として説明されています。(GitHub)
導入前に確認する前提条件
VS Code Shellを試す前に、まずローカルのTypeAgent環境とVS Codeの前提条件を確認します。READMEでは、VS Code 1.90以降と、ws://localhost:8999で到達できるTypeAgent agent serverが前提として示されています。(GitHub)
| 確認項目 | 推奨確認 |
|---|---|
| VS Codeのバージョン | VS Code 1.90以降か |
| TypeAgentリポジトリ | 最新のmainを取得しているか |
| agent server | ws://localhost:8999で起動しているか |
| 拡張の導入先 | 普段使うcode CLIにインストールされるか |
| 旧拡張 | 旧typeagent-shellが残っていないか |
| APIキーや外部サービス | TypeAgent側で必要なキーやサービス設定が済んでいるか |
agent serverの起動例は次の通りです。
cd ts/packages/agentServer/server
pnpm run startVS Code Shell側は、ts/packages/vscode-shellディレクトリからローカル導入できます。
cd ts/packages/vscode-shell
npm install
npm run deploy:localdeploy:localは、拡張をパッケージ化してアクティブなcode CLIへインストールする手順として説明されています。初回インストール後はVS Codeウィンドウのリロードも必要です。(GitHub)
古い拡張が残っている場合は、先にアンインストールします。
code --uninstall-extension typeagent.typeagent-shell設定確認：serverUrl、autoStart、serverPortを見る
VS Code Shellで接続できない場合、最初に見るべきなのは設定です。READMEでは、typeagent.serverUrlの既定値がws://localhost:8999、typeagent.autoStartはfalseで予約項目、typeagent.serverPortは8999で予約項目と説明されています。(GitHub)
| 設定名 | 既定値 | 確認ポイント |
|---|---|---|
typeagent.serverUrl | ws://localhost:8999 | agent serverの実際の起動先と一致しているか |
typeagent.autoStart | false | 自動起動を期待せず、手動起動しているか |
typeagent.serverPort | 8999 | 古い設定で3000などを見ていないか |
PR内のコミット説明でも、agent serverのデフォルトポートが8999に変更されたため拡張側の既定値も更新されたことが示されています。以前の検証環境を使い回す場合、ポート番号の思い込みで接続できないケースが起きやすいため注意が必要です。(GitHub)
code-vscode-shellスキーマの有効化が必要
VS Code Shellで会話管理を自然言語から操作したい場合は、code-vscode-shellサブスキーマを有効化します。READMEでは、このサブスキーマは既定では有効ではなく、初回利用時にチャットで次のコマンドを実行する必要があると説明されています。(GitHub)
@config schema code-vscode-shell on有効化後は、次のような操作をチャットから実行できます。
| やりたいこと | 入力例 |
|---|---|
| 新しい会話を作る | new conversation |
| 名前付きで会話を作る | new conversation named Brainstorm |
| 会話名を変更する | rename this conversation to Design Review |
| 別の会話へ切り替える | switch to conversation Brainstorm |
dispatcherが自動でcode agentへルーティングしない場合は、@code rename this conversation to Brainstormのように明示的に@codeを付けると判断しやすくなります。
ここは移行時に見落としやすいポイントです。拡張のインストールが成功していても、スキーマを有効化していなければ、会話管理系の自然言語操作が期待通りに動かないことがあります。
複数チャットパネルの検証で見るべきポイント
今回の更新では、複数のVS Codeチャットパネルで同じ会話を共有できる点が重要です。READMEでは、サイドパネルとエディタータブのチャットは同じagent-server接続上の独立したwebviewであり、複数の会話を横並びで実行したり、2つのタブを同じ会話に参加させてリアルタイムに同期したりできると説明されています。(GitHub)
検証時は、次の順番で確認すると原因を切り分けやすくなります。
| 手順 | 確認内容 | 期待される状態 |
|---|---|---|
| 1 | Activity barのTypeAgentアイコンからサイドパネルを開く | 接続リボンがConnectedになる |
| 2 | Ctrl+K Ctrl+TまたはmacOSでCmd+K Cmd+Tを押す | エディター領域に新しいチャットタブが開く |
| 3 | 片方のパネルでメッセージを送る | 同じ会話に参加している別パネルにも反映される |
| 4 | VS Codeをリロードする | 会話履歴が再参加時に復元される |
| 5 | agent serverを停止・再起動する | Disconnected表示後、再接続状態が分かる |
複数パネルの同期はデモでは見栄えがよい一方で、「別会話を開いているのか」「同じ会話に参加しているのか」を混同しやすい部分です。検証時は会話名を付け、どのタブがどの会話に紐づくかを明示しておくと、チーム内での再現確認が楽になります。
デモランナーはハンズオンや検証シナリオに有効
PRでは、VS Code Shell向けのデモランナーも追加されています。.txtスクリプトをエディターから右クリックし、「Run TypeAgent Demo Script」を実行すると、行が文字単位で入力され、@pauseForInputで一時停止し、Escでキャンセルできると説明されています。(GitHub)
これは、社内勉強会やPoCの説明で特に便利です。人が毎回同じプロンプトを手入力すると、入力ミスやテンポの差で結果確認がぶれます。スクリプト化しておけば、同じ流れを再現しやすくなり、接続状態、補完、会話切り替え、キャンセル操作をまとめて確認できます。
デモ用途で使う場合は、次の点を事前に確認してください。
| 確認項目 | 理由 |
|---|---|
| スクリプトの文字列 | 日本語や記号を含む場合、想定通り入力されるか確認する |
| 一時停止位置 | 説明を挟む箇所に@pauseForInputを置く |
| キャンセル操作 | Escで中断できることを本番前に試す |
| agent server状態 | デモ中にDisconnectedにならないよう事前起動する |
| 同じ会話の再利用 | 前回履歴が混ざると説明が分かりにくいため、新規会話を使う |
github-cli agent追加でCLI連携の検証幅が広がる
今回の更新では、新しいgithub-cli agentも追加されています。PRでは、@github-cli list my prsのように自然言語でgh CLIと対話できると説明されています。(GitHub)
実務では、GitHub CLIをすでに使っている開発チームが、自然言語インターフェースからPR確認やリポジトリ操作の導線を検証する用途に向いています。ただし、CLI連携はローカル環境の状態に強く依存します。gh CLIのインストール、認証状態、対象リポジトリの権限、現在の作業ディレクトリを確認してから試すべきです。
特に、エージェント経由でCLIを動かす場合は「何を実行してよいか」の境界を決めておくことが重要です。読み取り中心の確認から始め、ブランチ作成、PR作成、削除、設定変更など副作用のある操作は、ログと確認プロセスを整えてから検証しましょう。
失敗しやすいポイントと対処法
TypeAgent chat panel for VS Codeは開発者向けの更新であり、環境差によるつまずきが起きやすいです。特に既存のTypeAgent環境を更新する場合は、次の点を先に潰しておくと無駄な調査を減らせます。
| 症状 | よくある原因 | 対処 |
|---|---|---|
| VS Code側がConnectedにならない | agent serverが起動していない、またはポートが違う | ws://localhost:8999で起動しているか確認する |
| 拡張を入れたのに見えない | インストール先のcode CLIが普段使うVS Codeと違う | VS Codeを起動しているCLIと拡張導入先を確認する |
| 会話管理の自然言語操作が効かない | code-vscode-shellスキーマが未有効 | @config schema code-vscode-shell onを実行する |
| Stopボタンやキャンセル挙動を誤解する | 古い挙動の記憶で検証している | 更新後のPR内容に基づき、長い応答で再テストする |
| 複数タブの表示が一致しない | 別の会話を開いている | 会話名を付け、同じ会話に参加しているか確認する |
| デモが途中で崩れる | タイマー、入力、一時停止位置の設計が甘い | 短いスクリプトから試し、Escキャンセルも確認する |
| 日本語入力で期待と違う | TypeAgent自体が英語中心に検証されている | 日本語プロンプトのルーティング精度を別途評価する |
移行・更新時の実務チェックリスト
既存のTypeAgent環境を持っている場合は、いきなりチーム全員へ展開するのではなく、1台の検証環境で次の順番に確認するのが安全です。
| ステップ | 作業 | 完了条件 |
|---|---|---|
| 1 | TypeAgentリポジトリを更新する | PR #2291を含むmainを取得している |
| 2 | 依存関係を更新・ビルドする | agent serverが起動する |
| 3 | agent serverを起動する | ws://localhost:8999で待ち受ける |
| 4 | vscode-shellをローカル導入する | VS CodeにTypeAgentアイコンやコマンドが表示される |
| 5 | 旧拡張を削除する | 旧typeagent-shell由来の混乱がない |
| 6 | code-vscode-shellを有効化する | 会話管理の自然言語操作ができる |
| 7 | 複数パネルを開く | 同じ会話の同期と履歴復元を確認できる |
| 8 | デモスクリプトを実行する | 一時停止、再開、キャンセルが期待通り動く |
| 9 | github-cli agentを試す | 読み取り系コマンドから安全に確認できる |
| 10 | 日本語プロンプトを検証する | 自社の用途でルーティングや応答が許容範囲か判断できる |
このチェックリストで重要なのは、インストール確認と機能確認を分けることです。拡張が入っただけでは、TypeAgentがVS Code上で実務に使えるとは判断できません。接続、履歴、複数パネル、スキーマ、CLI連携、デモの再現性まで確認して、初めてチーム展開の判断材料になります。
本番利用ではなく、まずはPoCとして評価する
TypeAgent chat panel for VS Codeは、Microsoft developer platformにおけるエージェント開発体験の方向性を知るうえで有用な更新です。一方で、TypeAgent自体はサンプルコードであり、頻繁に更新される早期段階のプロジェクトです。本番業務へ直接組み込む前に、セキュリティ、権限、ログ、データ保持、CLI操作の副作用、日本語での動作を検証する必要があります。
PoCでは、次のように範囲を絞ると評価しやすくなります。
| 評価軸 | 見るべきこと |
|---|---|
| 開発体験 | VS Code内でチャット、コード、設定を並べて扱いやすいか |
| 再現性 | デモスクリプトで同じ流れを繰り返せるか |
| 拡張性 | 自作agentや既存agentがVS Code Shellで問題なく動くか |
| 安定性 | 再接続、キャンセル、複数パネル同期で破綻しないか |
| 安全性 | ファイル作成やCLI操作の権限・確認フローを制御できるか |
| 日本語対応 | 日本語の自然言語リクエストで期待通りactionに変換されるか |
まず何をすべきか
今回のMicrosoft developer platform documentation update: TypeAgent chat panel for VS Codeで最初にやるべきことは、TypeAgentの最新mainを取得し、VS Code Shellをローカル環境で小さく試すことです。特に、typeagent.serverUrlがws://localhost:8999を向いているか、agent serverが手動で起動しているか、@config schema code-vscode-shell onを実行済みかを確認してください。
そのうえで、サイドパネル、エディタータブ、複数会話、履歴復元、Stopボタン、デモランナーを順に試すと、今回の更新が自社の開発ワークフローに合うか判断しやすくなります。TypeAgentを初めて触る場合は、いきなり実業務の自動化に使うのではなく、読み取り系の操作と短いデモシナリオから始めるのが安全です。
コメント