다음을 통해 공유


Azure Portal을 사용하여 Azure Bot 리소스 만들기

적용 대상: SDK v4

Azure Bot 리소스(봇 리소스)를 사용하면 Azure AI Bot Service에 봇을 등록하고 봇을 채널에 연결할 수 있습니다. 봇을 빌드, 연결 및 관리하여 앱 또는 웹 사이트에서 Teams, Messenger 및 기타 여러 채널에 이르기까지 어디서나 사용자와 상호 작용할 수 있습니다.

이 문서에서는 Azure Portal을 통해 봇 리소스를 만드는 방법을 설명합니다.

리소스 관리

봇 리소스를 만들 때 Azure는 연결된 리소스를 만듭니다. 만든 리소스 중 일부는 봇의 ID를 관리하는 방법에 따라 달라집니다.

봇 ID는 몇 가지 다른 방법으로 Azure에서 관리할 수 있습니다.

  • 봇의 자격 증명을 직접 관리할 필요가 없도록 사용자가 할당한 관리 ID입니다.
  • 단일 테넌트 앱입니다.
  • 다중 테넌트 앱입니다.

사용자가 할당한 관리 ID 및 단일 테넌트 앱 유형에 대한 지원이 C#, JavaScript 및 Python용 Bot Framework SDK에 추가되었습니다. 이러한 앱 유형은 다른 언어 또는 Bot Framework Composer, Bot Framework Emulator 또는 Dev Tunnels에서 지원되지 않습니다.

앱 유형 지원
사용자 할당 관리 ID Azure AI Bot Service 및 C#, JavaScript 및 Python SDK
단일 테넌트 Azure AI Bot Service 및 C#, JavaScript 및 Python SDK
다중 테넌트 Azure AI Bot Service, 모든 Bot Framework SDK 언어, 작성기, 에뮬레이터 및 개발자 터널

필수 조건

  • Azure 구독이 없는 경우 시작하기 전에 체험 계정을 만듭니다.
  • C# 또는 JavaScript 버전 4.15.0 이상용 Bot Framework SDK(사용자 할당 관리 ID 및 단일 테넌트 봇용).

리소스 만들기

Azure AI Bot Service에 봇을 등록할 수 있는 Azure Bot 리소스를 만듭니다.

웹앱 봇봇 채널 등록 리소스는 만들 수 없습니다. 그러나 구성되고 배포된 이러한 기존 리소스는 계속 작동합니다. SDK 버전 4.14.1.2 이상에서 VSIX 또는 Yeoman 템플릿에서 만든 봇에는 Azure Bot 리소스를 생성하는 ARM 템플릿이 포함되어 있습니다.

  1. Azure Portal로 이동합니다.

  2. 오른쪽 창에서 리소스 만들기를 선택합니다.

  3. 검색 상자에 입력 bot한 다음 Enter 키를 누릅니 .

  4. Azure Bot 카드를 선택합니다.

    Azure 봇 리소스 선택

  5. 만들기를 실행합니다.

  6. 필수 필드에 값을 입력하고 설정을 검토하고 업데이트합니다.

    1. 프로젝트 세부 정보 아래에 정보를 제공합니다. 봇에 전역 또는 로컬 데이터 상주 여부를 선택합니다. 현재 로컬 데이터 상주 기능은 "westeurope" 및 "centralindia" 지역의 리소스에 사용할 수 있습니다. 자세한 내용은 Azure AI Bot Service의 지역화를 참조 하세요.

      Azure Bot 리소스에 대한 프로젝트 세부 정보 설정

    2. Microsoft 앱 ID 아래에 정보를 제공합니다. Azure에서 봇 ID를 관리하는 방법과 새 ID를 만들거나 기존 ID를 사용할지 여부를 선택합니다.

      Azure Bot 리소스에 대한 Microsoft 앱 ID 설정

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

  8. 유효성 검사가 통과하면 만들기를 선택합니다.

  9. 배포가 완료되면 리소스로 이동을 선택합니다. 선택한 리소스 그룹에 나열된 봇 및 관련 리소스가 표시됩니다.

  10. Bot Framework SDK가 아직 없는 경우 GitHub에서 다운로드를 선택하여 기본 설정 언어로 패키지를 사용하는 방법을 알아봅니다.

    SDK에서 봇 만들기

이제 Bot Framework SDK를 사용하여 봇을 빌드할 준비가 되었습니다.

Azure에서 새 앱 ID를 사용하여 새 단일 테넌트 또는 다중 테넌트 Azure Bot 리소스를 만들면 암호도 생성됩니다.

봇 ID 정보

다음 단계에 따라 봇의 구성 파일에 ID 정보를 추가합니다. 파일은 봇을 만드는 데 사용하는 프로그래밍 언어에 따라 다릅니다.

Important

Java 버전의 Bot Framework SDK는 다중 테넌트 봇만 지원합니다. C#, JavaScript 및 Python 버전은 봇의 ID를 관리하기 위한 세 가지 애플리케이션 유형을 모두 지원합니다.

언어 파일 이름 주의
C# appsettings.json 봇의 ID를 관리하기 위한 세 가지 애플리케이션 유형을 모두 지원합니다.
JavaScript .env 봇의 ID를 관리하기 위한 세 가지 애플리케이션 유형을 모두 지원합니다.
Java application.properties 다중 테넌트 봇만 지원합니다.
Python config.py 봇의 ID를 관리하기 위한 세 가지 애플리케이션 유형을 모두 지원합니다.

추가해야 하는 ID 정보는 봇의 애플리케이션 유형에 따라 달라집니다. 구성 파일에 다음 값을 제공합니다.

C#, JavaScript 및 Python 봇에 사용할 수 있습니다.

속성
MicrosoftAppType UserAssignedMSI
MicrosoftAppId 사용자 할당 관리 ID의 클라이언트 ID입니다.
MicrosoftAppPassword 해당 없음. 사용자가 할당한 관리 ID 봇에 대해 이 값을 비워 둡니다.
MicrosoftAppTenantId 사용자 할당 관리 ID의 테넌트 ID입니다.

앱 서비스를 업데이트하려면

봇에 대한 기존 App Service 리소스(웹앱)가 있고 봇이 사용자 할당 관리 ID 애플리케이션인 경우 봇의 앱 서비스를 업데이트해야 할 수 있습니다.

  1. 봇의 웹앱에 대한 App Service 블레이드로 이동합니다.
  2. 설정에서 ID를 선택합니다.
  3. ID 블레이드에서 사용자 할당 탭을 선택하고 추가(+)를 선택합니다.
  4. 사용자 할당 관리 ID 추가 블레이드에서 다음을 수행합니다 .
    1. 구독을 선택합니다.

    2. 사용자가 할당한 관리 ID의 경우 봇의 관리 ID를 선택합니다. 관리 ID가 자동으로 생성된 경우 봇과 동일한 이름을 갖습니다.

    3. 추가를 선택하여 봇에 이 ID를 사용합니다.

      봇의 관리 ID가 선택된 App Service ID 블레이드입니다.

앱 또는 테넌트 ID를 가져오려면

봇의 앱 또는 테넌트 ID를 가져오려면 다음을 수행합니다.

  1. 봇에 대한 Azure Bot 리소스 블레이드로 이동합니다.
  2. 봇의 구성 블레이드로 이동합니다. 이 블레이드에서 봇의 Microsoft 앱 ID 또는 앱 테넌트 ID를 복사할 수 있습니다.

새 암호를 생성하려면

단일 테넌트 및 다중 테넌트 봇에는 일부 작업에 필요한 앱 비밀 또는 암호가 있습니다. Azure AI Bot Service는 봇 비밀을 숨깁니다. 그러나 봇의 App Service 리소스 소유자는 새 암호를 생성할 수 있습니다.

  1. 봇에 대한 Azure Bot 리소스 블레이드로 이동합니다.
  2. 봇의 구성 블레이드로 이동합니다.
  3. Microsoft 앱 ID 옆에 있는 관리를 선택하여 앱 서비스에 대한 인증서 + 비밀 블레이드로 이동합니다.
  4. 블레이드의 지침에 따라 새 클라이언트 비밀을 만들고 안전한 장소에 값을 기록합니다.

추가 정보

  • Microsoft Entra ID를 사용한 ID 관리에 대한 자세한 내용은 Microsoft Entra ID란?을 참조하세요.
  • Azure 앱 Service 및 App Service 계획에 대한 자세한 내용은 App Service 개요참조하세요.
  • Azure 리소스 및 일반적으로 관리되는 방법에 대한 자세한 내용은 Azure Resource Manager 개요참조하세요.

참고 항목

Bot Framework Composer 및 Bot Framework Emulator는 현재 다중 테넌트 봇만 지원합니다. C# 또는 JavaScript 버전 4.15.0 이상용 Bot Framework SDK는 사용자 할당 관리 ID 및 단일 테넌트 봇에 필요합니다.

기술 지원

일부 유형의 기술 소비자는 일부 유형의 기술 봇을 사용할 수 없습니다. 다음 표에서는 지원되는 조합에 대해 설명합니다.

  다중 테넌트 기술 단일 테넌트 기술 사용자 할당 관리 ID 기술
다중 테넌트 소비자 지원됨 지원되지 않음 지원되지 않음
단일 테넌트 소비자 지원되지 않음 두 앱이 동일한 테넌트에 속하는 경우 지원됨 두 앱이 동일한 테넌트에 속하는 경우 지원됨
사용자 할당 관리 ID 소비자 지원되지 않음 두 앱이 동일한 테넌트에 속하는 경우 지원됨 두 앱이 동일한 테넌트에 속하는 경우 지원됨

기술 또는 기술 소비자를 구성하는 방법에 대한 자세한 내용은 기술 구현 또는 기술 소비자 구현을 참조하세요.

다음 단계