Bot Framework SDK로 봇 생성

아티클
10/24/2023

적용 대상: SDK v4

이 문서에서는 C#, Java, JavaScript 또는 Python용 Bot Framework SDK를 사용하여 첫 번째 봇을 빌드하는 방법과 Bot Framework Emulator를 사용하여 봇을 테스트하는 방법을 설명합니다.

첫 번째 봇을 만들려면 Azure 구독 또는 Azure AI Bot Service 리소스가 필요하지 않습니다. 이 빠른 시작에서는 첫 번째 봇을 로컬로 만드는 데 중점을 둡니다. Azure에서 봇을 만드는 방법을 알아보려면 Azure Bot 리소스 만들기를 참조하세요.

참고 항목

Bot Framework JavaScript, C#및 Python SDK는 계속 지원되지만 Java SDK는 2023년 11월에 종료되는 최종 장기 지원으로 사용 중지됩니다.

Java SDK를 사용하여 빌드된 기존 봇은 계속 작동합니다.

새 봇 빌드의 경우 Microsoft Copilot Studio를 사용하고 올바른 부조종사 솔루션 선택에 대해 알아봅니다.

자세한 내용은 봇 빌드의 미래를 참조 하세요.

필수 조건

C# 템플릿

현재 봇 샘플은 .NET Core 3.1 템플릿을 사용합니다.

Visual Studio
VS Code/CLI

Visual Studio에 봇 템플릿을 추가하려면 Visual Studio VSIX용 Bot Framework v4 SDK 템플릿 파일을 다운로드하여 설치 합니다 .

참고 항목

Visual Studio 내에서 템플릿을 설치할 수 있습니다.

메뉴에서 확장을 선택한 다음, 확장 관리를 선택합니다.
확장 관리 대화 상자에서 Visual Studio용 Bot Framework v4 SDK 템플릿을 검색하고 설치합니다.

.NET 봇을 Azure에 배포하는 방법에 대한 자세한 내용은 봇을 프로비전하고 게시하는 방법을 참조하세요.

.NET Core 템플릿은 Bot Framework v4를 사용하여 새로운 대화형 AI 봇을 빠르게 빌드하는 데 도움이 됩니다. 2020년 5월을 기준으로 이러한 템플릿과 템플릿이 생성하는 코드에는 .NET Core 3.1 이상이 필요합니다.

Bot Framework 템플릿을 설치하려면 다음을 수행합니다.

콘솔 창이 열립니다.
.NET Core SDK 다운로드 버전 3.1 이상을 다운로드하고 설치합니다.
이 명령을 사용하여 설치된 .NET Core 명령줄 인터페이스 버전을 확인할 수 있습니다.
```
dotnet --version
```

에코, 코어 및 빈 봇 템플릿의 세 가지 Bot Framework C# 템플릿을 설치합니다.

dotnet new -i Microsoft.Bot.Framework.CSharp.EchoBot
dotnet new -i Microsoft.Bot.Framework.CSharp.CoreBot
dotnet new -i Microsoft.Bot.Framework.CSharp.EmptyBot

템플릿이 올바르게 설치되었는지 확인합니다.
```
dotnet new --list
```

참고 항목

위의 단계에서는 세 가지 Bot Framework 템플릿을 모두 설치합니다. 모든 템플릿을 설치할 필요는 없으며 사용할 템플릿만 설치할 수 있습니다. 이 문서에서는 에코 봇 템플릿을 사용합니다.

Java 1.8 이상
Bot Framework Emulator
봇 코드를 편집하려는 경우 Visual Studio Code 또는 즐겨 찾는 IDE입니다.
Maven 설치
node.js 버전 12.10 이상을 설치합니다.
Azure에 배포 하려는 경우 Azure 계정입니다.

Java 템플릿

Yeoman 생성기를 사용하여 Bot Framework v4의 핵심 AI 기능을 사용하여 대화형 AI 봇을 빠르게 만듭니다. 자세한 내용은 yeoman.io 참조하세요.

생성기는 아래와 같이 세 가지 템플릿 옵션을 지원합니다.

템플릿	설명
Echo Bot	당신이 "헬로 월드!"보다 조금 더 원하는 경우 좋은 템플릿, 하지만 훨씬 더. 이 템플릿은 봇에 메시지를 보내고 봇이 메시지를 사용자에게 다시 반복하여 처리하도록 하는 기본 사항을 처리합니다. 이 템플릿은 사용자가 봇에 말하는 모든 것을 사용자에게 "에코"하는 봇을 생성합니다.
비어 있는 봇	Bot Framework v4에 익숙하고 기본 기본 기본 프로젝트를 원하는 경우 좋은 템플릿입니다. 또한 설명서에서 샘플 코드를 가져와서 학습하기 위해 최소 봇에 붙여 넣으려면 좋은 옵션입니다.
핵심 봇	고급 봇을 만들려는 경우 다중 턴 대화 상자와 Azure AI LUIS 를 사용하여 언어 이해를 구현하는 좋은 템플릿입니다. 이 템플릿은 플라이트를 예약할 장소와 날짜를 추출할 수 있는 봇을 만듭니다.

참고 항목

LUIS(Language Understanding)는 2025년 10월 1일에 사용 중지됩니다. 2023년 4월 1일부터 새 LUIS 리소스를 만들 수 없습니다. 이제 최신 버전의 언어 이해가 Azure AI Language의 일부로 제공됩니다.

Azure AI Language의 기능인 CLU(대화형 언어 이해)는 업데이트된 LUIS 버전입니다. Bot Framework SDK의 언어 이해 지원에 대한 자세한 내용은 자연어 이해를 참조하세요.

Yeoman 설치

node.js 버전 12.10 이상을 설치했는지 확인합니다.
최신 npm을 설치합니다.
```
npm install -g npm
```
Yeoman을 설치합니다. 전역적으로 설치해야 합니다.
```
npm install -g yo
```
generator-botbuilder-java를 설치 합니다. 전역적으로 설치해야 합니다.
```
npm install -g generator-botbuilder-java
```
Yeoman 및 generator-botbuilder-java가 올바르게 설치되었는지 확인합니다.
```
yo botbuilder-java --help
```

Node.js
Bot Framework Emulator
JavaScript의 재구성 및 비동기 프로그래밍에 대한 지식
봇 코드를 편집하려는 경우 Visual Studio Code 또는 즐겨 찾는 IDE입니다.

JavaScript 및 TypeScript 템플릿

Bot Framework v4용 Yeoman 및 Yeoman 생성기를 설치하려면 다음을 수행합니다.

터미널 또는 관리자 권한 명령 프롬프트를 엽니다.
JavaScript 봇의 디렉터리로 전환합니다. 아직 없는 경우 먼저 만듭니다.
```
mkdir myJsBots
cd myJsBots
```
최신 버전의 npm 및 Yeoman이 있는지 확인합니다.
```
npm install -g npm
npm install -g yo
```
Yeoman 생성기를 설치합니다. Yeoman은 애플리케이션을 만들기 위한 도구입니다. 자세한 내용은 yeoman.io 참조하세요.
```
npm install -g generator-botbuilder
```
참고 항목

아래 나열된 Windows 빌드 도구의 설치는 Windows를 개발 운영 체제로 사용하는 경우에만 필요합니다. 일부 설치의 경우 재구성을 위한 설치 단계에서와 관련된 node-gyp오류를 제공합니다. 이 경우 관리자 권한으로 이 명령을 실행해 볼 수 있습니다. Python이 시스템에 이미 설치되어 있는 경우에도 이 호출이 종료되지 않고 중단될 수 있습니다.

Windows에 있는 경우에만 이 명령을 실행합니다.
```
npm install -g windows-build-tools
```

Python 3.8.3
Bot Framework Emulator
Python의 비동기 프로그래밍에 대한 지식

가상 환경 만들기 및 사용

가상 환경은 전역 설정과 다른 특정 Python 인터프리터 및 라이브러리의 조합입니다. 가상 환경은 프로젝트와 관련이 있으며 프로젝트 폴더에서 유지 관리됩니다. 가상 환경을 사용하는 이점은 시간이 지남에 따라 프로젝트를 개발할 때 가상 환경이 항상 프로젝트의 정확한 종속성을 반영한다는 것입니다. 가상 환경에 대한 자세한 내용은 가상 환경 만들기를 참조 하세요.

봇을 만들 디렉터리로 이동합니다. 그런 다음 기본 플랫폼에 대해 다음 명령을 실행합니다. 가상 환경을 활성화한 후에는 명령줄/터미널 앞에 (venv). 이렇게 하면 가상 환경이 활성 상태임을 알 수 있습니다. 다음을 입력하여 언제든지 가상 환경을 비활성화할 수 있습니다 deactivate.

macOS/Linux

python3 -m venv venv
source venv/bin/activate

Windows

python -m venv venv
venv\Scripts\activate.bat

Python 템플릿

다음 pip install 명령을 실행하여 필요한 패키지를 설치합니다.

pip install botbuilder-core
pip install asyncio
pip install aiohttp
pip install cookiecutter==1.7.0

Important

32비트 버전의 Python을 사용하는 경우 실행 pip install cryptography==2.8해야 합니다.

봇 만들기

Visual Studio에서 새 봇 프로젝트를 만들고 Echo Bot(Bot Framework v4 - .NET Core 3.1) 템플릿을 사용합니다. 봇 템플릿만 보려면 AI Bots 프로젝트 유형을 선택합니다.

.NET Core 3.1 이상이 설치되어 있는지 확인합니다.

Visual Studio Code에서 새 터미널 창을 엽니다.
봇 프로젝트를 만들 디렉터리로 이동합니다.
다음 명령을 사용하여 새 에코 봇 프로젝트를 만듭니다. 봇 프로젝트에 사용할 이름으로 바꿉 <your-bot-name> 습니다.
```
dotnet new echobot -n <your-bot-name>
```

새 터미널 창을 엽니다.
봇 프로젝트를 만들 디렉터리로 이동합니다.
다음 명령을 사용하여 새 에코 봇 프로젝트를 만듭니다. 봇 프로젝트에 사용할 이름으로 바꿉 <your-bot-name> 습니다.
```
dotnet new echobot -n <your-bot-name>
```

템플릿 덕분에 프로젝트에는 이 빠른 시작에서 봇을 만드는 데 필요한 모든 코드가 포함되어 있습니다. 봇을 테스트하는 데 더 이상 코드가 필요하지 않습니다.

문제가 발생한 에코 봇 을 만들었습니다.

다음 명령을 실행하여 템플릿에서 에코 봇을 만듭니다. 이 명령은 해당 매개 변수에 대한 기본 옵션을 사용합니다.

yo botbuilder-java -T "echo"

Yeoman은 봇을 만들 수 있는 몇 가지 정보를 묻는 메시지를 표시합니다. 이 자습서에서는 기본값을 사용합니다.

? What's the name of your bot? (echo)
? What's the fully qualified package name of your bot? (com.mycompany.echo)
? Which template would you like to start with? (Use arrow keys) Select "Echo Bot"
? Looking good.  Shall I go ahead and create your new bot? (Y/n) Enter "y"

생성기는 생성기의 기본값을 변경하거나 프롬프트를 미리 시드하는 데 사용할 수 있는 많은 명령줄 옵션을 지원합니다. 옵션은 대/소문자를 구분합니다.

명령줄 옵션	설명
`--help, -h`	지원되는 모든 명령줄 옵션에 대한 도움말 텍스트 나열
`--botName, -N`	봇 프로젝트에 지정된 이름
`--packageName, -P`	봇에 사용할 Java 패키지 이름
`--template, -T`	프로젝트를 생성하는 데 사용되는 템플릿입니다. 옵션은 `echo`, `empty`, `core`입니다. 다양한 템플릿에 대한 자세한 내용은 언어, C#, JavaScript , Python 또는 Java에 대한 GitHub 리포지토리를 참조하세요.
`--noprompt`	생성기는 새 봇을 만들기 전에 확인을 요청하지 않습니다. 명령줄에 전달되지 않은 모든 요구 사항 옵션은 적절한 기본값을 사용합니다. 이 옵션은 테스트 목적으로 자동화된 봇 생성을 사용하도록 설정하기 위한 것입니다.

템플릿 덕분에 프로젝트에는 이 빠른 시작에서 봇을 만드는 데 필요한 모든 코드가 포함되어 있습니다. 봇을 테스트하는 다른 코드는 필요하지 않습니다.

문제가 발생한 에코 봇 을 만들었습니다.

생성기를 사용하여 에코 봇을 만듭니다.

yo botbuilder

Yeoman은 봇을 만들 수 있는 몇 가지 정보를 묻는 메시지를 표시합니다. 이 자습서에서는 기본값을 사용합니다.

? 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

문제가 발생한 에코 봇 을 만들었습니다.

작업 디렉터리에서 다음 명령을 실행하여 에코 봇 템플릿 및 해당 종속성을 다운로드합니다.
```
cookiecutter https://github.com/microsoft/BotBuilder-Samples/releases/download/Templates/echo.zip
```
봇에 이름과 설명을 제공하라는 메시지가 표시됩니다. 다음 값을 입력합니다.
- bot_name: echo_bot
- bot_description: 사용자 응답을 다시 에코하는 봇입니다.

문제가 발생한 에코 봇 을 만들었습니다.

봇 시작

Visual Studio에서:

봇 프로젝트를 엽니다.
디버깅하지 않고 프로젝트를 실행합니다.
Visual Studio는 애플리케이션을 빌드하고, localhost에 배포하고, 웹 브라우저를 시작하여 애플리케이션의 default.htm 페이지를 표시합니다.

이때 봇은 포트 3978에서 로컬로 실행됩니다.

Visual Studio Code:

봇 프로젝트 폴더를 엽니다.

프로젝트를 선택하라는 메시지가 표시되면 만든 봇에 대한 프로젝트를 선택합니다.
메뉴에서 실행을 선택한 다음 디버깅 없이 실행합니다.
- 환경을 선택하라는 메시지가 표시되면 .Net Core를 선택합니다.
- 이 명령이 시작 설정을 업데이트한 경우 변경 내용을 저장하고 명령을 다시 실행합니다.
실행 명령은 애플리케이션을 빌드하고, localhost에 배포하고, 웹 브라우저를 시작하여 애플리케이션의 default.htm 페이지를 표시합니다.

이때 봇은 포트 3978에서 로컬로 실행됩니다.

명령 프롬프트 또는 터미널에서:

디렉터리를 봇의 프로젝트 폴더로 변경합니다.
봇을 시작하는 데 사용합니다 dotnet run .
```
dotnet run
```
이 명령은 애플리케이션을 빌드하고 localhost에 배포합니다.

애플리케이션의 기본 웹 페이지는 표시되지 않지만 이 시점에서 봇은 포트 3978에서 로컬로 실행되고 있습니다.

문제가 발생한 에코 봇 을 시작했습니다.

터미널에서 봇을 저장한 디렉터리로 이동한 다음 아래에 나열된 명령을 실행합니다.
Maven 프로젝트를 빌드하고 .jar 파일(보관)에 패키지합니다.
```
mvn package
```
로컬로 봇을 실행합니다. 보관 이름을 이전 명령의 실제 이름으로 바꿉 있습니다.
```
java -jar .\target\<archive-name>.jar
```

이제 에뮬레이터를 시작할 준비가 되었습니다.

문제가 발생한 에코 봇 을 시작했습니다.

터미널 또는 명령 프롬프트에서 디렉터리를 봇용으로 만든 디렉터리로 npm start변경하고 .

cd my-chat-bot
npm start

이때 봇은 포트 3978에서 로컬로 실행됩니다.

문제가 발생한 에코 봇 을 시작했습니다.

명령줄/터미널에서 디렉터리를 .로 echo_bot변경합니다.
```
cd echo_bot
```
에코 봇 템플릿에 대한 종속성을 설치합니다.
```
pip install -r requirements.txt 
```
종속성이 설치되면 다음 명령을 실행하여 봇을 시작합니다.
```
python app.py
```
아래 스크린샷에 표시된 마지막 줄이 표시되면 봇이 테스트할 준비가 되었는지 알 수 있습니다.
마지막 줄에서 http 주소를 복사합니다. 에뮬레이터를 사용하여 봇과 상호 작용할 때 필요합니다.

문제가 발생한 에코 봇 을 시작했습니다.

에뮬레이터를 시작하고 봇 연결

Bot Framework 에뮬레이터를 시작합니다.
에뮬레이터의 시작 탭에서 봇 열기를 선택합니다.
경로에 추가된 로컬 호스트 및 포트 /api/messages 인 봇의 URL을 입력합니다. 주소는 일반적으로 다음과 http://localhost:3978/api/messages같습니다.
그런 다음 연결을 선택합니다.

봇에 메시지를 보내면 봇이 다시 응답합니다.