봇 만들기Create a bot

적용 대상: SDK v4APPLIES TO: SDK v4

이 문서에서는 Bot Framework SDK를 사용 하 여 봇을 빌드하는 방법을 보여 주고 Bot Framework Emulator를 사용 하 여 테스트 하는 방법을 보여 줍니다.This article shows you how to build a bot by using the Bot Framework SDK, and then shows 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

Visual Studio 봇 템플릿을 추가하려면 Visual Studio VSIX용 Bot Framework v4 SDK 템플릿 파일을 다운로드하여 설치합니다.To add the bot templates to Visual Studio, download and install the Bot Framework v4 SDK Templates for Visual Studio VSIX file.

참고

VSIX 패키지에는 .net core 2.1 및 .net core 3.1 버전의 c # 템플릿이 모두 포함 되어 있습니다.The VSIX package includes both .NET Core 2.1 and .NET Core 3.1 versions of the C# templates. Visual Studio 2019에서 새 봇을 만들 때는 .NET Core 3.1 템플릿을 사용해야 합니다.When creating new bots in Visual Studio 2019, you should use the .NET Core 3.1 templates. 현재 봇 샘플에서는 .NET Core 3.1 템플릿을 사용합니다.The current bot samples use .NET Core 3.1 templates. BotBuilder-Samples 리포지토리의 4.7-archive 분기에서 .NET Core 2.1 템플릿을 사용하는 샘플을 찾을 수 있습니다.You can find the samples that use .NET Core 2.1 templates in the 4.7-archive branch of the BotBuilder-Samples repository. Azure에 .NET Core 3.1 봇을 배포 하는 방법에 대 한 자세한 내용은 azure에 봇을 배포하는 방법을 참조 하세요.For information about deploying .NET Core 3.1 bots to Azure, see how to deploy your bot to Azure.

봇 만들기Create a bot

Visual Studio에서 Echo Bot(Bot Framework v4 - .NET Core 3.1) 템플릿을 사용하여 새 봇 프로젝트를 만듭니다.In Visual Studio, create a new bot project using the Echo Bot (Bot Framework v4 - .NET Core 3.1) template. 봇 템플릿만 표시하려면 프로젝트 형식에서 AI 봇 을 선택합니다.Choose AI Bots from the project types to show only bot templates.

Visual Studio에서 새 프로젝트 대화 상자 만들기Visual Studio create a new project dialog

이 템플릿을 통해 프로젝트에는 이 빠른 시작에서 봇을 만드는 데 필요한 모든 코드가 포함되어 있습니다.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.

참고

핵심 봇을 만드는 경우 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

Visual StudioIn Visual Studio

  1. 봇 프로젝트를 엽니다.Open your bot project.
  2. 디버깅하지 않고 프로젝트를 실행합니다.Run the project without debugging.

이렇게 하면 애플리케이션이 빌드되어 localhost로 배포되고 웹 브라우저를 시작하여 애플리케이션의 default.htm 페이지를 표시합니다.This will build the application, deploy it to localhost, and launch the web browser to display the application's default.htm page. 이때 봇은 포트 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. Emulator의 시작 탭에서 Open Bot 를 선택 합니다.Select Open Bot on the Emulator's Welcome tab.

  3. 경로에 추가 되는 로컬 포트의 URL 인 봇의 URL (일반적으로)을 입력 합니다 /api/messages 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.

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

    echo 메시지

추가 리소스Additional Resources

  • Visual Studio 또는 Visual Studio Code 및 Bot Framework Emulator를 사용 하 여 디버깅 하는 방법은 봇 디버그 를 참조 하세요.See Debug a bot for how to debug using Visual Studio or Visual Studio Code and the Bot Framework Emulator.
  • Ngrok을 설치 하는 방법에 대 한 자세한 내용은 터널링 (ngrok) 을 참조 하세요.See Tunneling (ngrok) for information on how to install ngrok.

다음 단계Next steps