Bot Framework SDK for JavaScript を使用したボットの作成Create a bot with the Bot Framework SDK for JavaScript

適用対象: SDK v4APPLIES TO: SDK v4

この記事では、使用してボットをビルドする方法を説明します。そのためには、Bot Builder ジェネレーターとボットフレームワーク SDK for JavaScript を使用し、bot framework Emulator を使用してテストする方法について説明します。This article shows you how to build a bot by using the Yeoman Bot Builder generator and the Bot Framework SDK for JavaScript, and then how to test it with the Bot Framework Emulator.

Azure Bot Service でのボット作成とローカルでのボット作成は、ボットを作成するための、似ているけれども別個の方法です。Creating a bot with Azure Bot Service and creating a bot locally are independent, parallel ways to create a bot.

前提条件Prerequisites

テンプレートTemplates

Yeoman と、v4 用の Yeoman ジェネレーターをBot Frameworkするには:To install Yeoman and the Yeoman generator for Bot Framework v4:

  1. ターミナルまたは管理者特権でのコマンド プロンプトを開きます。Open a terminal or elevated command prompt.

  2. JavaScript ボットのディレクトリに切り替えます。Switch to the directory for your JavaScript bots. まだない場合は最初に作成します。Create it first if you don't already have one.

    mkdir myJsBots
    cd myJsBots
    
  3. npm と Yeoman の最新バージョンがインストールされている必要があります。Make sure you have the latest versions of npm and Yeoman.

    npm install -g npm
    npm install -g yo
    
  4. Yeoman ジェネレーターをインストールします。Install the Yeoman generator. Yeoman は、アプリケーションを作成するためのツールです。Yeoman is a tool for creating applications. 詳細については、「」を参照yeoman.io。For more information, see yeoman.io.

        npm install -g generator-botbuilder
    

注意

下記の Windows ビルド ツールのインストールは、開発用オペレーティング システムとして Windows を使用している場合にのみ必要となります。The install of Windows build tools listed below is only required if you use Windows as your development operating system. 一部のインストールでは、restify のインストール手順で node-gyp に関連するエラーが発生します。For some installations, the install step for restify is giving an error related to node-gyp. 該当する場合は、管理者特権のアクセス許可を使用してこのコマンドを実行してみてください。If this is the case you can try running this command with elevated permissions. Python が既にシステムにインストールされている場合、この呼び出しは終了せずにハングする可能性があります。This call may also hang without exiting if Python is already installed on your system:

# only run this command if you are on Windows. Read the above note.
npm install -g windows-build-tools

ボットの作成Create a bot

  1. ジェネレーターを使用して echo bot を作成します。Use the generator to create an echo bot.

    yo botbuilder
    

    Yeoman により、作成するボットに関する情報の入力が求められます。Yeoman prompts you for some information with which to create your bot. このチュートリアルでは、既定値を使います。For this tutorial, use the default values.

    ? What's the name of your bot? my-chat-bot
    ? What will your bot do? Demonstrate the core capabilities of the Microsoft Bot Framework
    ? What programming language do you want to use? JavaScript
    ? Which template would you like to start with? Echo Bot - https://aka.ms/bot-template-echo
    ? Looking good.  Shall I go ahead and create your new bot? Yes
    

テンプレートのおかげで、プロジェクトには、このクイック スタートでボットを作成するのに必要なすべてのコードが含まれています。Thanks to the template, your project contains all the code that's necessary to create the bot in this quickstart. ボットをテストするために追加コードは必要ありません。You don't need any additional code to test your bot.

注意

Core ボットを作成する場合は、LUIS 言語モデルが必要ですIf you create a Core bot, you'll need a LUIS language model. (言語モデルは luis.ai で作成できます)。(You can create a language model at luis.ai). モデルの作成後、構成ファイルを更新します。After creating the model, update the configuration file.

ボットの起動Start your bot

ターミナルまたはコマンド プロンプトで、ボット用に作成したディレクトリに変更し、npm start でボットを起動します。In a terminal or command prompt change directories to the one created for your bot, and start it with npm start.

cd my-chat-bot
npm start

この時点では、ボットはローカルのポート 3978 で実行されています。At this point, your bot is running locally on port 3978.

エミュレーターの起動とボットの接続Start the Emulator and connect your bot

  1. Bot Framework Emulator を起動します。Start the Bot Framework Emulator.

  2. エミュレーター の [ようこそ] タブで [Open Bot]を選択 します。Select Open Bot on the Emulator's Welcome tab.

  3. ボットの URL (ローカル ポートの URL) を入力し、パス (通常は /api/messages ) に追加します http://localhost:3978/api/messagesEnter your bot's URL, which is the URL of the local port, with /api/messages added to the path, typically http://localhost:3978/api/messages.

    ボットを開く

  4. 次に、 [接続](Connect) を選択します。Then select Connect.

    ボットにメッセージを送信すると、ボットが応答します。Send a message to your bot, and the bot will respond back.

    エコー メッセージ

その他のリソースAdditional resources

リモートでホストされているボットに接続する方法については、トンネリング (ngrok) に関する記事を参照してください。See tunneling (ngrok) for how to connect to a bot hosted remotely.

次のステップNext steps