다음을 통해 공유

Azure CLI를 사용하여 Azure Bot 리소스 만들기 또는 업데이트

  • 아티클

적용 대상: SDK v4

이 문서에서는 Azure CLI 및 ARM 템플릿(Azure Resource Manager 템플릿)을 사용하여 Azure Bot 리소스를 만들거나 업데이트하는 방법을 설명합니다.

이는 봇을 프로비전하고 게시하는 더 큰 프로세스의 일부입니다.

참고 항목

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

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

새 봇 빌드의 경우 Power Virtual Agents 사용을 고려하고 올바른 챗봇 솔루션을 선택하는 방법을 읽어 보세요.

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

필수 조건

Azure CLI를 사용하여 봇을 프로비전하고 게시하려면 다음이 필요합니다.

  • 활성 구독이 있는 Azure 계정. 무료 계정을 만듭니다.

  • Azure CLI 설치

    프로그래밍 언어의 경우 다음 버전의 Azure CLI를 사용합니다. 일부 단계는 이후 버전의 CLI에서 작동하지 않습니다.

    언어 CLI 버전
    C# 및 JavaScript 2.39.0 이상
    Python 2.55.0 이상
    Java 2.29.2

  • 이 프로세스는 ARM 템플릿(Azure Resource Manager 템플릿)을 사용하여 봇에 대한 Azure Bot 리소스를 만듭니다.

    현재 템플릿이 없는 경우 c#, JavaScript, Python 또는 Java와 같은 deploymentTemplates 폴더의 봇 프로젝트에 복사본을 만듭니다.

팁

이는 봇을 프로비전하고 게시하는 더 큰 프로세스의 일부입니다. 필수 구성 요소의 전체 목록을 위해 봇을 프로비전하고 게시하는 방법을 참조하세요.

매개 변수 파일 편집

사용하려는 값을 포함하도록 ARM 템플릿의 매개 변수 파일을 편집합니다.

Important

App Service 및 appId Azure Bot 리소스를 만들 때 동일한 appType 값과 값을 사용해야 합니다.

프로젝트에 최신 ARM 템플릿 및 매개 변수 파일이 아직 포함되어 있지 않은 경우 C#, JavaScript, Python 또는 Java 언어에 대한 Bot Framework SDK 리포지토리에서 복사할 수 있습니다.

이 표에서는 명령 옵션과 함께 사용할 매개 변수 파일의 배포 매개 변수 에 대해 parameters 설명합니다. 기본적으로 매개 변수 파일 의 이름은 parameters-for-template-AzureBot-with-rg.json.

매개 변수 형식 설명
azureBotId 문자열 필수입니다. 봇에 대한 전역적으로 고유하고 변경할 수 없는 핸들(예: ContosoCustomerService.
azureBotSku 문자열 선택 사항. Azure Bot 리소스의 SKU입니다. 허용되는 값: "F0"(무료) 및 "S1"(표준). 기본값은 "S1"입니다.
azureBotRegion 문자열 선택 사항. Azure 봇의 위치입니다. 허용되는 값: "global", "westeurope", "westus" 및 "centralindia". 기본값은 "global"입니다.
botEndpoint 문자열 선택 사항. 봇에 대한 메시징 엔드포인트(예: https://<appServiceName>.azurewebsites.net/api/messages.
appType 문자열 필수입니다. 봇 리소스의 ID를 관리하는 방법. 허용되는 값은 "MultiTenant", "SingleTenant" 및 "UserAssignedMSI"입니다. 기본값은 "MultiTenant"입니다.
appId 문자열 필수입니다. 이전에 만든 ID 리소스의 클라이언트 ID 또는 앱 ID입니다. 앱 서비스의 Microsoft 앱 ID입니다.
UMSIName 문자열 선택 사항. 사용자 할당 관리 ID 앱 형식의 경우 ID 리소스의 이름입니다.
UMSIResourceGroupName 문자열 선택 사항. 사용자 할당 관리 ID 앱 유형의 경우 ID 리소스에 대한 리소스 그룹입니다.
tenantId 문자열 선택 사항. 사용자 할당 관리 ID 및 단일 테넌트 앱 유형의 경우 ID 리소스에 대한 Microsoft Entra ID 테넌트 ID입니다.

팁

게시된 봇이 메시지를 수신하려면 먼저 봇의 메시징 엔드포인트를 설정해야 합니다.

모든 매개 변수가 모든 앱 형식에 적용되는 것은 아닙니다.

및 에 UMSIResourceGroupNametenantId대한 UMSIName값을 제공합니다.

Azure Bot 리소스 만들기

봇에 대한 Azure Bot 리소스를 만들려면 다음 명령을 사용합니다.

az deployment group create --resource-group <resource-group> --template-file <template-file-path> --parameters "@<parameters-file-path>"
옵션 설명
resource-group App Service를 만들 Azure 리소스 그룹의 이름입니다.
template-file App Service에 대한 ARM 템플릿의 경로입니다. 경로는 상대적이거나 절대적일 수 있습니다.
매개 변수 ARM 템플릿과 함께 사용할 매개 변수 파일의 경로입니다. 경로는 상대적이거나 절대적일 수 있습니다.

최신 생성기를 사용하여 만든 프로젝트의 경우 ARM 템플릿 및 매개 변수 파일은 프로젝트 내의 DeploymentTemplates\DeployUseExistResourceGroup 폴더에 있습니다. 기본 파일 이름은 template-AzureBot-with-rg.json parameters-for-template-AzureBot-with-rg.json.

Azure Bot 리소스를 업데이트하려면

Azure Bot에 대한 메시징 엔드포인트를 추가하거나 업데이트하려면 다음 명령을 사용합니다.

az bot update --resource-group <resource group> --name <azureBotId> --endpoint <messaging-endpoint>
옵션 설명
resource-group App Service를 포함하는 Azure 리소스 그룹의 이름입니다.
name 봇에 대한 전역적으로 고유하고 변경할 수 없는 핸들입니다.
endpoint 봇에 대한 메시징 엔드포인트(예: https://<appServiceName>.azurewebsites.net/api/messages.

추가 정보

ARM 템플릿에 대한 자세한 내용은 ARM 템플릿이란? 및 Azure CLI에서 ARM(Azure Resource Manager) 배포 템플릿을 사용하는 방법을 참조하세요.

다음 단계

봇 배포의 일부로 App Service를 만든 경우 ARM 템플릿을 사용하여 리소스 만들기를 참조하여 프로세스를 계속합니다.