次の方法で共有

SDK 優先ボットをデバッグする

この記事の対象: SDK v4

この記事では、Visual Studio や Visual Studio Code などの IDE と Bot Framework Emulator を使用して、ボットをデバッグする方法について説明します。 これらのメソッドを使用して、ボットをローカルでデバッグします。 この記事では、「ボットの作成」クイック スタートで 作成したエコー ボット などを使用します。

注

この記事では、Bot Framework Emulator を使用して、デバッグ中にボットとメッセージを送受信します。 Bot Framework Emulator を使用してボットをデバッグする他の方法をお探しの場合は、「Bot Framework Emulator を使用したデバッグ」の記事を参照してください。

注

AI サービス、オーケストレーション、知識を選択してエージェントを構築するには、Microsoft 365 Agents SDK の使用を検討してください。 Agents SDK では、C#、JavaScript、または Python がサポートされています。 Agents SDK の詳細については、 aka.ms/agents を参照してください。 SaaS ベースのエージェント プラットフォームをお探しの場合は、 Microsoft Copilot Studio を検討してください。 Bot Framework SDK を使用して構築された既存のボットがある場合は、ボットを Agents SDK に更新できます。 Bot Framework SDK から Agents SDK への移行ガイダンスで、主要な変更と更新プログラムを確認できます。 Bot Framework SDK のサポート チケットは、2025 年 12 月 31 日の時点で提供されなくなります。

前提条件

Visual Studio Code で C# ブレークポイントを設定する

Visual Studio Code では、ブレークポイントを設定し、デバッグ モードでボットを実行して、コードをステップ実行できます。 Visual Studio Code でブレークポイントを設定するには、次の手順のようにします。

  1. Visual Studio Code を起動し、ボット プロジェクト フォルダーを開きます。

  2. 必要に応じてブレークポイントを設定します。 ブレークポイントを設定するには、行番号の左側に列をマウスでポイントします。 小さな赤いドットが表示されます。 このドットを選択すると、ブレークポイントが設定されます。 もう一度ドットを選択すると、ブレークポイントが削除されます。

    Visual Studio Code での C# ブレークポイント設定のスクリーンショット。

  3. メニュー バーから、[実行]、[デバッグの開始] の順に選択します。 Visual Studio Code のターミナルからデバッグ モードで、ボットの実行が開始されます。

  4. 「Bot Framework Emulator でデバッグする」方法の説明に従って、Bot Framework Emulator を起動してボットに接続します。

  5. エミュレーターからボットにメッセージを送信します (例: "Hi" というメッセージを送信)。 ブレークポイントを設定した行で、実行が停止します。

    ブレークポイントで一時停止した Visual Studio Code の C# ボットのスクリーンショット。

Visual Studio で C# ブレークポイントを設定する

Visual Studio では、ブレークポイントを設定し、デバッグ モードでボットを実行して、コードをステップ実行できます。 Visual Studio でブレークポイントを設定するには、次の手順のようにします。

  1. ボット フォルダーに移動し、 .sln ファイルを開きます。 これにより Visual Studio でソリューションが開きます。

  2. メニュー バーから、[ビルド]、[ソリューションのビルド] の順に選択します。

  3. "ソリューション エクスプローラー" で、 .cs ファイルを選択し、必要に応じてブレークポイントを設定します。 このファイルでは、ボットのメイン ロジックが定義されています。 ブレークポイントを設定するには、行番号の左側に列をマウスでポイントします。 小さなドットが表示されます。 このドットを選択すると、ブレークポイントが設定されます。 もう一度ドットを選択すると、ブレークポイントが削除されます。

    Visual Studio での C# ブレークポイント設定のスクリーンショット。

  4. メニュー バーから、[デバッグ]、[デバッグの開始] の順に選択します。 この時点で、ボットはローカルに実行されています。

  5. Bot Framework Emulator を開始し、前のセクションで説明したようにボットに接続します。

  6. エミュレーターから、ボットに "Hi" などのメッセージを送信します。 ブレークポイントを設定した行で、実行が停止します。

    ブレークポイントで一時停止した Visual Studio の C# ボットのスクリーンショット。

その他のリソース

次のステップ

トランスクリプト ファイルを使用してお使いのボットをデバッグする。