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

적용 대상: SDK v4APPLIES TO: SDK v4

이 문서에서는 c # 템플릿을 사용 하 여 봇을 빌드한 다음 Bot Framework 에뮬레이터를 사용 하 여 테스트 하는 방법을 보여 줍니다.This article shows you how to build a bot by using the C# template, 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

Visual Studio에 bot templates를 추가 하려면 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를 사용 하 여 빌드Build with Visual Studio

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 Studio에서 프로젝트를 시작 합니다.In Visual Studio, start the project. 이렇게 하면 애플리케이션이 빌드되어 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. 에뮬레이터의 시작 탭에서 봇 열기를 선택합니다.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

  • .NET Core 템플릿에 대 한 자세한 내용은 .NET Core SDK 템플릿 추가 정보를 참조 하세요.See the .NET Core SDK Templates README for more information about the .NET Core templates.
  • Visual Studio 또는 Visual Studio Code와 Bot Framework 에뮬레이터를 사용 하 여 디버깅 하는 방법에 대 한 봇을 디버그 하는 방법을 참조 하세요.See how to 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