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

この記事の対象: SDK v4

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

Note

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

Note

Bot Framework JavaScript SDK、C#、Python SDK は引き続きサポートされますが、Java SDK については、最終的な長期サポートは 2023 年 11 月に終了する予定です。

Java SDK を使用して構築された既存のボットは引き続き機能します。

新しいボットを構築する場合は、Microsoft Copilot Studio の使用をご検討ください。また、適切なコパイロット ソリューションの選択に関する記事もお読みください。

詳細については、「The future of bot building」をご覧ください。

前提条件

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# ボットのスクリーンショット。

その他のリソース

次のステップ