JavaScript용 Bot Framework SDK를 사용하여 봇 만들기Create a bot with the Bot Framework SDK for JavaScript

적용 대상: SDK v4APPLIES TO: SDK v4

이 문서에서는 Yeoman Bot Builder 생성기 및 JavaScript용 Bot Framework SDK를 사용하여 봇을 빌드한 다음, 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

Bot Framework v4용 Yeoman 및 Yeoman 생성기를 설치하려면 다음을 수행합니다.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. 생성기를 사용 하 여 에코 봇을 만듭니다.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.

Emulator 시작 및 봇 연결Start the Emulator and connect your bot

  1. Bot Framework Emulator를 시작합니다.Start the Bot Framework Emulator.

  2. 에뮬레이터의 시작 탭에서 봇 열기를 선택합니다.Select Open Bot on the Emulator's Welcome tab.

  3. 경로에 추가된 로컬 포트의 URL인 봇의 /api/messages URL(일반적으로 http://localhost:3978/api/messages )을 입력합니다.Enter 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. 그런 다음 연결 을 선택합니다.Then select Connect.

    봇에 메시지를 보내면 봇이 다시 응답합니다.Send a message to your bot, and the bot will respond back.

    echo 메시지

추가 리소스Additional resources

원격으로 호스팅되는 봇에 연결하는 방법은 터널링(ngrok)을 참조하세요.See tunneling (ngrok) for how to connect to a bot hosted remotely.

다음 단계Next steps