Azure Bot Service로 봇 만들기Create a bot with Azure Bot Service

적용 대상: SDK v4APPLIES TO: SDK v4

이 항목에서는 봇을 빌드하는 인프라를 제공하는 Azure Bot 리소스를 만드는 방법을 보여줍니다.This topic shows how to create the Azure Bot resource, which provides the infrastructure to build a bot. 리소스를 만든 후에는 봇을 빌드할 수 있습니다.Once you have created the resource, you can then build your bot.

Bot development를 처음 접하는 경우 Bot Framework 작성기를 사용 하는 것이 좋습니다.If you're new to bot development, we recommend using the Bot Framework Composer. 이미 만든 봇에 대해 SDK를 계속 사용할 수 있습니다.You can keep using the SDK for those bots you have already created. 그러나 새 개발에는 작성기를 사용 하는 것이 좋습니다.However, we recommend the use of Composer for new development.

사전 요구 사항Prerequisites

Azure Bot 리소스 만들기Create an Azure Bot resource

Azure Bot 리소스를 사용 하면 Azure Bot Service에 Bot Framework 작성기 또는 SDK 봇을 등록할 수 있습니다.The Azure Bot resource enables you to register your Bot Framework Composer or SDK bot in Azure Bot Service. 봇을 빌드, 연결 및 관리 하 여 사용자가 어디에 있든, 앱 또는 웹 사이트에서 팀, 메신저 및 기타 여러 채널로 사용자와 상호 작용할 수 있습니다.You can build, connect, and manage bots to interact with your users wherever they are, from your app or website to Teams, Messenger and many other channels.

경고

웹 앱 봇봇 채널 등록 은 더 이상 사용 되지 않지만 기존 리소스는 계속 작동 합니다.Web App Bot and Bot Channels Registration will be deprecated but existing resources will continue to work. 대신 Azure Bot 를 사용 해야 합니다.You should use Azure Bot, instead.

  1. Azure Portal로 이동합니다.Go to the Azure portal.

  2. 오른쪽 창에서 리소스 만들기 를 선택 합니다.In the right pane, select Create a resource.

  3. 검색 상자에 bot 를 입력 한 다음 enter 키를 누릅니다.In the search box enter bot, then press Enter.

  4. Azure Bot card를 선택 합니다.Select the Azure Bot card.

    Azure 봇 리소스 선택

  5. 만들기 를 선택합니다.Select Create.

    Azure 봇 리소스 만들기

  6. 필요한 값을 입력 합니다.Enter the required values. 다음 그림은 선택한 새 Microsoft 앱 ID 만들기 를 보여 줍니다.The following figure shows Create new Microsoft App ID selected.

    Azure bot resource 값 만들기

    기존 앱 등록 사용 을 선택 하 고 기존 앱 Id암호 를 입력할 수도 있습니다.You can also select Use existing app registration and enter your existing app Id and password.

    Azure bot 리소스 기존 값 만들기

  7. 검토 + 만들기 를 선택합니다.Select Review + create.

  8. 유효성 검사에 통과 하면 만들기 를 선택 합니다.If the validation passes, select Create.

  9. 리소스 그룹으로 이동 을 선택합니다.Select Go to resource group. 선택한 리소스 그룹에 나열 된 봇 및 관련 Azure Key Vault 리소스가 표시 됩니다.You should see the bot and the related Azure Key Vault resources listed in the resource group you selected.

    앱 암호 (암호)는 주요 자격 증명 모음에 저장 되 고 리소스 그룹당 하나의 키 자격 증명 모음이 있습니다.The app secret (password) is stored in the the key vault and there is one key vault per resource group. 중요 한 데이터를 복사 하 고 저장 하는 대신 key vault를 사용 하는 것이 좋습니다.Using key vault is recommended instead of copying and storing sensitive data.

  10. 작성기에서 열기를 선택 합니다.Select Open in Composer. 봇 개발을 처음 접하는 경우 나 새 봇을 빌드하는 경우 권장 되는 경로입니다.This is the recommended path, if you are new to bot development or if you are building a brand new bot. 작성기에서 봇 만들기 문서에 설명 된 단계를 따릅니다.Follow the steps described in the Create a bot in Composer article.

    작성기에서 봇 만들기

    필요에 따라 Github에서 SDK 받기를 선택하여 적당한 챗봇에서 세계적 수준의 엔터프라이즈 솔루션에 이르기까지 모든 것을 만드는 데 도움이 되는 Bot Framework SDK를 사용하여 봇을 빌드합니다.Optionally, select Get the SDK from Github to build your bot with the Bot Framework SDK that helps you create everything from a modest chatbot to world class, enterprise solutions.

    SDK에서 봇 만들기

Azure Key Vault 정보About Azure Key Vault

Azure Key Vault 는 액세스 정책 및 감사 기록에 대한 전체 제어와 함께 중앙 집중식 비밀 관리를 제공하는 서비스입니다.Azure Key Vault is a service that provides centralized secrets management, with full control over access policies and audit history. 자세한 내용은 App Service 대한 Key Vault 참조 사용 및 Azure Functions.For more information, see Use Key Vault references for App Service and Azure Functions. 서비스 사용에 대해 약간의 요금이 청구됩니다. 자세한 내용은 Key Vault 가격 책정을참조하세요.Note that you will be charged a small fee for using the service, For more information, see Key Vault pricing.

앱 Id 및 암호App Id and password

배포를 위한 봇을 구성 하려면 Azure bot resource 앱 Id암호가 필요 합니다.You need the Azure bot resource app Id and password to configure your bot for deployment. 해당 값을 관련 변수에 할당 하 MicrosoftAppId 고, 사용자 MicrosoftAppPassword 의 봇 프로젝트 구성 파일에 포함 됩니다.You will assign their values to the related variables: MicrosoftAppId and MicrosoftAppPassword contained in your bot project configuration file. 이 파일은 아래 표에 표시 된 것 처럼 봇을 만드는 데 사용 하는 프로그래밍 언어에 따라 달라 집니다.The file differs depending on the programming language you use to create the bot, as shown in the table below.

언어Language 파일 이름File Name
CsharpCsharp appsettings.json
JavaScriptJavaScript .env
PythonPython config.py
JavaJava application.properties

Azure bot resource 앱 Id 가져오기Get Azure bot resource app Id

  1. Azure Portal로 이동합니다.Go to the Azure portal.
  2. 앱 Id를 얻으려면 Azure bot 리소스를 선택 합니다.Select the Azure bot resource to obtain its app Id.
  3. 왼쪽 창의 설정 섹션에서 구성 을 선택 합니다.In the left pane, in the Settings section, select Configuration.
  4. Microsoft 앱 ID 상자에 포함 된 값을 복사 하 여 저장 합니다.Copy and save the value contained in the Microsoft App ID box.

Azure 키 자격 증명 모음에서 Azure 봇 리소스 암호 가져오기Get Azure bot resource password from the Azure key vault

Azure Key Vault 에 액세스 하 여 리소스 저장 된 암호를 가져올 수 있습니다.You can access the Azure Key Vault to obtain your resource stored password. Azure Key Vault는 액세스 정책 및 감사 기록에 대한 전체 제어와 함께 중앙 집중식 비밀 관리를 제공하는 서비스입니다.Azure Key Vault is a service that provides centralized secrets management, with full control over access policies and audit history. Fpr 자세한 내용은 App Service 및 Azure Functions에 대 한 Key Vault 참조 사용을 참조 하세요.Fpr more information, see Use Key Vault references for App Service and Azure Functions.

추가 정보Additional information

추가 정보Additional information

수동 앱 등록Manual app registration

다음과 같은 경우 수동 등록이 필요할 수 있습니다.You might need a manual registration when:

  • 조직에 등록을 만들 수 없으며, 빌드 중인 봇의 앱 ID를 다른 당사자가 만들도록 해야 합니다.You are unable to make the registrations in your organization and need another party to create the App ID for the bot you're building.
  • 고유한 앱 ID(및 암호)를 수동으로 만들어야 합니다.You need to manually create your own app ID (and password).

FAQ - 앱 등록을 참조하세요.See FAQ - App Registration.

다음 단계Next steps

코드가 다운로드되면 머신에서 봇을 로컬로 계속 개발할 수 있습니다.After you download the code, you can continue to develop the bot locally on your machine. 봇을 테스트하고 Azure Portal 봇 코드를 업로드할 준비가 되면 continuos 배포 설정 항목에 나열된 지침에 따라 변경한 후 코드를 자동으로 업데이트합니다.Once you test your bot and are ready to upload the bot code to the Azure portal, follow the instructions listed under set up continuos deployment topic to automatically update code after you make changes.