Visual StudioにPrompt flowをインストールしようとして「Actual command not found」「依存関係エラー」で止まる場合、原因の多くは“インストール先の勘違い”です。Prompt flowの開発体験はVisual StudioではなくVisual Studio Code（VS Code）向けに提供されるため、正しい環境へ切り替えるだけで解決するケースが少なくありません。本記事では切り分けの考え方、VS Codeで確実に動かす手順、報告時に揃える情報まで整理します。
まず押さえるべきポイント：Prompt flowの「対象エディタ」はどれか
今回の「Actual command not found」「依存関係エラー」は、Visual Studio（紫色のアイコンの統合開発環境）にPrompt flowを入れようとしていること自体が、つまずきの原因になりがちです。Prompt flowは、開発者体験としてはVisual Studio Code（VS Code）拡張機能を前提にした情報や手順が多く、Visual Studio側で同じことをしようとしても、そもそも想定外の挙動になります。
結論としては、Visual Studioで解決しようとするより、VS CodeでPrompt flowを動かすのが最短です。どうしても直らない場合は、Prompt flowのコミュニティ（フォーラム）やGitHub Issuesに情報を揃えて報告し、調査してもらうのが現実的です。
Prompt flowとは何か（トラブル切り分けの前提）
Prompt flowは、生成AI（LLM）を使ったアプリや業務フローを作るときに、プロンプトや処理の流れを整理し、評価・改善を回しやすくするための仕組みとして扱われます。実態としては、エディタ拡張＋Python環境（CLIやライブラリ）が組み合わさって動くケースが多く、ここを理解しておくと「依存関係エラー」の意味が読み解きやすくなります。
| やりたいこと | Prompt flowが役に立つ場面 | 裏側で必要になりやすいもの |
|---|---|---|
| プロンプトの試作・改善を反復したい | 入力→プロンプト→モデル→出力の流れを固定し、変更点の影響を追いやすい | Python環境、必要なパッケージ、プロジェクト構成 |
| 複数の処理をつないで「流れ」を作りたい | 前処理、LLM呼び出し、後処理などをまとめて管理したい | 拡張機能（UI）とCLIの連携、環境変数 |
| チームで再現性を担保したい | 同じ環境・同じ手順で動く状態を作りたい | 仮想環境、依存関係の固定（requirements.txt等） |
ここまでで直る人の最短ルート
時間がない人向けに、最短で効果が出やすい順に並べます。該当するところだけ実行してOKです。
| やること | 狙い | 結果の見方 |
|---|---|---|
| 「Visual Studio」ではなく「VS Code」で作業する | 対象アプリの取り違えを解消する | エラーの種類が変わる／Prompt flowコマンドが表示される |
| プロジェクト用の仮想環境（.venv）を作り直す | 依存関係の衝突をリセットする | importやインストールが通るようになる |
| まだダメならログを揃えてコミュニティ/GitHubへ報告 | 拡張機能側の不具合や環境固有問題を切り分ける | 再現条件が整理され、調査が進む |
Visual Studio と VS Code を混同しないための見分け方
名前が似ているため混同されやすいですが、拡張機能の仕組みも想定ユーザーも違います。まずは「いま開いているのがどっちか」を確実に合わせるだけで、無駄な調査時間を大きく減らせます。
| 項目 | Visual Studio | Visual Studio Code（VS Code） |
|---|---|---|
| 代表的な用途 | .NET / C#、C++、企業向けの大規模開発 | 軽量エディタ、Web開発、Python、AI開発、拡張機能で柔軟に構築 |
| 拡張機能の配布先 | Visual Studio Marketplace（VS拡張） | VS Code Marketplace（VS Code拡張） |
| 拡張機能の互換性 | VS Code拡張は基本的に動かない | Visual Studio拡張は基本的に動かない |
| 見分けのコツ | 起動ファイルがdevenv.exe、アイコンが紫、メニューに「拡張機能」 | 起動ファイルがCode.exe、アイコンが青、左側にアクティビティバー |
| 混同が起きる理由 | どちらも「Microsoft」「拡張機能」「VS」という言葉が出てくるうえ、拡張機能の配布形式（.vsix）という単語まで似ている | |
よくある勘違いパターン（先に潰しておくと早い）
| 勘違い | 起きがちなこと | 正しい考え方 |
|---|---|---|
| 「Visual Studioに入れる＝VS Codeにも入る」 | 拡張機能が見つからない／入っても動かない | 拡張機能は別製品向け。VS Code拡張はVS Codeに入れる |
| 「Prompt flowはインストールしたら単体で動く」 | 依存関係エラーが連鎖する | 多くの場合、Python環境とパッケージが揃って初めて動く |
| 「pip installした＝VS Codeも同じPythonを使っている」 | importできない、拡張機能だけ動かない | VS Codeが選んでいるPythonとターミナルのPythonが一致しているか確認が必要 |
「Actual command not found」と依存関係エラーが示すこと
表示されている文言は一見すると難しく見えますが、切り分けの観点で見るとポイントが絞れます。特に「command not found」は、VS Codeの拡張機能がコマンド登録できていないときに起きやすいタイプのエラーです。
| 表示されがちなメッセージ | 何が起きている可能性が高いか | まずやること |
|---|---|---|
| Actual command not found, wanted to execute prompt-flow.reportBugs /26 | 拡張機能が起動（アクティブ化）できず、コマンドが登録されていない／別アプリでコマンドを呼ぼうとしている | 「Visual Studio」ではなく「VS Code」で操作しているか確認し、VS Code側で拡張機能を入れ直す |
| 依存関係（dependency）関連のエラー | Python環境・パッケージ・権限・ネットワーク制限などの理由で、拡張機能やCLIが必要なものを読み込めていない | Pythonのバージョン／仮想環境／pipの実行先を確認し、必要パッケージを同じ環境に入れる |
最初に確認したいチェックリスト
原因調査に入る前に、ここだけは最初に揃えてください。チェックは難しくありませんが、ここを飛ばすと「ずっと直らない」状態になりがちです。
| チェック項目 | 確認方法 | OKの状態 |
|---|---|---|
| いま使っているアプリはVS Codeか | ウィンドウ左端にアイコン縦並び（アクティビティバー）があるか、ヘルプ→バージョン情報で確認 | 「Visual Studio Code」と表示される |
| Prompt flowは「VS Code拡張機能」として入っているか | VS Codeの拡張機能（Extensions）で「Prompt flow」を検索 | 有効化され、無効化の表示になっている |
| Python拡張機能・Python実行環境が準備できているか | コマンドパレットで「Python: Select Interpreter」を開けるか、ターミナルでpythonが動くか | プロジェクト用のPythonを選択でき、実行できる |
| プロジェクト単位の仮想環境を使っているか | .venvフォルダがあるか、ターミナルのプロンプトが仮想環境になっているか | グローバル環境ではなく、プロジェクト専用環境でpipしている |
推奨の対処：VS CodeでPrompt flowを使う手順
ここからは「VS Codeで動かす」ことを前提に、失敗しにくい手順をまとめます。すでにVS Codeを入れている場合でも、仮想環境の作り直しだけで依存関係エラーが解消することがあります。
手順の全体像
- VS Codeをインストールして最新版に更新する
- VS Codeの拡張機能で「Prompt flow」をインストールする
- Python（できればプロジェクト用仮想環境）を用意する
- promptflow関連パッケージを同じ環境にインストールする
- コマンドが認識されるか（CLIや拡張機能の機能）を確認する
仮想環境を作ってからインストールする（Windows例）
依存関係のトラブルは「どのPythonに入れたか」が原因になりやすいので、まず仮想環境を固定します。
cd あなたのプロジェクトフォルダ
python -m venv .venv
.venv\Scripts\activate
python -m pip install -U pip
pip install promptflowPowerShellで実行ポリシーの影響でactivateできない場合は、管理者権限の有無やポリシー設定の見直しが必要です。企業端末ではポリシーが厳しいこともあるため、仮想環境を作れるかを先に確認しておくと切り分けが速くなります。
動作確認のコツ
- VS Codeの右下やステータスバーで、選択されているPythonが「.venv」になっているか確認する
- 同じターミナルで
python -c "import promptflow; print('ok')"が通るか確認する - 複数のPythonが入っているPCでは、
where python（Windows）やwhich python（macOS/Linux）で実体を確認する
拡張機能の入れ直し（コマンドが出ない場合の定番）
VS Code側でPrompt flow関連コマンドが出ないときは、拡張機能の起動失敗が疑われます。以下は「効くことが多い」順です。
- 拡張機能を一度無効化→有効化する
- 拡張機能をアンインストール→再インストールする
- 別のワークスペース（空フォルダ）で再現するか確認する
- VS Codeの拡張機能を最小構成（Prompt flow + Python系のみ）にして切り分ける
依存関係エラーが消えないときの切り分け（よくある原因トップ）
「VS Codeに切り替えたのに直らない」場合は、ほとんどが環境依存です。ここでは、現場で遭遇しやすい原因を再現しやすい順に整理します。
| ありがちな原因 | 症状の例 | 確認ポイント | 対処の方向性 |
|---|---|---|---|
| Pythonが複数入っていて、別のPythonにpipしている | pipで入れたはずなのにimportできない／拡張機能だけ動かない | VS Codeで選択したインタプリタと、ターミナルのpython/pipが一致しているか | プロジェクトの.venvに統一し、VS Codeのインタプリタ選択をやり直す |
| グローバル環境に入れてしまい、権限や競合で壊れる | 依存関係解決がループする／別のAI系パッケージと衝突する | pipの実行ログに「Permission denied」「Requires…」が出ていないか | 仮想環境を作り直し、必要最小限のパッケージだけ入れる |
| 社内プロキシ・SSL検査でpipが失敗している | インストール途中でタイムアウト、証明書エラーが出る | pipのエラーにProxy/SSL/certificateが含まれていないか | 社内手順に従ってプロキシ設定や証明書設定を行い、ネットワーク担当へ相談する |
| 拡張機能の起動に失敗してコマンド登録されない | コマンドパレットでPrompt flow関連コマンドが見つからない | VS Codeの出力（Output）や拡張機能ホストのログに例外が出ていないか | 拡張機能を無効化→再有効化、再インストール、プロファイル分離で切り分け |
| WSL/Remote Containersで「ローカルとリモート」が混ざる | ローカルでは動くがリモートでは動かない（または逆） | 左下のリモート接続表示、Pythonインタプリタがどちら側か | リモート側にも同じ仮想環境を作り、リモート側でpipする |
「Actual command not found」をVS Code側で減らす実践テクニック
このエラーは、拡張機能が起動できていない状態で「拡張機能のコマンド」を呼び出したときに出やすいので、拡張機能の土台を安定させると再発率が下がります。
- 拡張機能を最小構成にする：一度、Prompt flowとPython関連だけにして、他の拡張機能の干渉を排除する
- ワークスペースを分ける：AI検証用のフォルダを別ワークスペースにし、設定や拡張機能の影響範囲を狭める
- ユーザー設定とワークスペース設定を意識する：Pythonのパスやターミナル設定がワークスペース側で上書きされていないかを見る
- まずはCLIで最低限を確認する：拡張機能の前に、ターミナルでimportできるかを見ると、依存関係の問題かUI側の問題かが分かれる
再発防止：依存関係をプロジェクトに固定する
一度動いても、別の日にアップデートや別案件のパッケージ追加で再発することがあります。チーム運用や業務利用では、次のような「守り」を入れておくと安定します。
- 仮想環境（.venv）はプロジェクト内に置き、グローバルPythonを汚さない
- requirements.txtなどで依存関係を固定し、別PCでも再現できる形にする
- AI検証用のワークスペースは、他案件と分けて拡張機能や設定の影響範囲を小さくする
Visual Studioを使い続けたい場合の現実解
「仕事のメインはVisual Studioで、AIだけPrompt flowを使いたい」というケースもあります。その場合は、Visual Studioに無理やり統合するより、役割を分けるのが安定します。
| やりたいこと | おすすめのツール | 理由 |
|---|---|---|
| プロンプトの試作・フローの検証・評価 | VS Code + Prompt flow拡張 | 拡張機能が想定する操作体系で、トラブルが少ない |
| .NET/C#のAPIや業務アプリ本体の開発 | Visual Studio | デバッガやソリューション管理など、VSが強い領域 |
| 両者を同じリポジトリで管理 | Git（同一repo、フォルダ分割） | フロー資産とアプリ資産を一緒にバージョン管理できる |
解決しないときは「報告の質」で解決スピードが変わる
VS Codeで正しく試しても改善しない場合、拡張機能側の不具合や環境固有の問題の可能性があります。そのときは、闇雲に試行錯誤するより、再現条件を揃えて報告したほうが早く前進します。
特に有効なのは、次の情報を「一発で」揃えることです。
| 報告に入れると強い情報 | 具体例 | なぜ重要か |
|---|---|---|
| 利用環境 | OS（Windows 10/11など）、VS Codeのバージョン、拡張機能のバージョン、Pythonバージョン | 依存関係問題は「環境の差」で再現性が変わるため |
| 発生手順 | 新規フォルダ→拡張機能インストール→コマンド実行→エラー発生、のように最短手順 | 再現できないと修正できないため |
| ログ | VS CodeのOutput、拡張機能ホストのエラー、ターミナルのpipログ | 「どこで失敗したか」を特定する材料になる |
| 試した対処 | 再インストール、.venv作り直し、別PCでの再現など | 同じ提案の往復を減らし、原因に早く到達できる |
よくある質問
Visual Studioの拡張機能マネージャーにPrompt flowが見当たりません
多くの場合、それは正常です。Prompt flowはVS Code拡張として案内されることが多く、Visual Studio側の拡張機能として探しても出てこない（または別物になる）ことがあります。まずはVS Code側で拡張機能を検索してください。
VS Codeに入れたのに「command not found」が出ます
拡張機能が起動に失敗している可能性があります。拡張機能の再インストールや、拡張機能を最小構成にする切り分け、Pythonインタプリタの選び直しを行い、ターミナルでimport promptflowが通るかを先に確認すると原因が絞れます。
依存関係エラーの原因が分かりません
依存関係は「Pythonのパッケージ」だけとは限りません。権限、ネットワーク、リモート開発（WSL/コンテナ）、複数Pythonの混在が絡むことが多いです。表のチェック項目を上から順に潰すと、再現条件が明確になりやすくなります。
まとめ
「Prompt flowをVisual Studioに入れようとしてエラーが出る」場合、最初に疑うべきはVisual StudioとVS Codeの取り違えです。Prompt flowはVS Code側で使う前提の情報が多いため、VS Codeに切り替えて仮想環境を作り直すだけで解決するケースがよくあります。それでも直らないときは、環境情報とログを揃えてコミュニティやGitHub Issuesに報告し、原因の切り分けを進めるのが近道です。
コメント