Azure Bot kaynağı oluşturmak veya güncelleştirmek için Azure CLI kullanma

  • Makale

ŞUNLAR IÇIN GEÇERLIDIR: SDK v4

Bu makalede, Azure CLI ve Azure Resource Manager şablonu (ARM şablonu) ile Azure Bot kaynağı oluşturma veya güncelleştirme işlemleri açıklanmaktadır.

Bu, bot sağlama ve yayımlama işleminin daha büyük bir parçasıdır.

  • İşlemin tamamı hakkında bilgi için bkz . Bot sağlama ve yayımlama.
  • App Service kaynağı oluşturma hakkında bilgi için bkz . App Service kaynağı oluşturmak için Azure CLI kullanma.
  • Azure portalını kullanma yönergeleri için Bkz . Azure Bot kaynağı oluşturma hızlı başlangıcı.

Not

Bot Framework JavaScript, C# ve Python SDK'ları desteklenmeye devam edecektir, ancak Java SDK'sı son uzun vadeli destek Kasım 2023'te sona erecek şekilde kullanımdan kaldırılacaktır.

Java SDK ile oluşturulan mevcut botlar çalışmaya devam edecektir.

Yeni bot derlemesi için Microsoft Copilot Studio'yu kullanmayı göz önünde bulundurun ve doğru copilot çözümünü seçme hakkında bilgi edinin.

Daha fazla bilgi için bkz . Bot oluşturmanın geleceği.

Önkoşullar

Botları sağlamak ve yayımlamak için Azure CLI'yı kullanmak için şunları yapmanız gerekir:

  • Etkin aboneliği olan bir Azure hesabı. Ücretsiz bir hesap oluşturun.

  • Azure CLI yüklemesi.

    Programlama diliniz için Azure CLI'nın aşağıdaki sürümünü kullanın. Bazı adımlar CLI'nın sonraki sürümlerinde çalışmaz.

    Dil CLI sürümü
    C# ve JavaScript 2.39.0 veya üzeri
    Python 2.55.0 veya üzeri
    Java 2.29.2

  • Bu işlem, botunuz için bir Azure Bot kaynağı oluşturmak üzere bir Azure Resource Manager şablonu (ARM şablonu) kullanır.

    Geçerli şablonlarınız yoksa, bot projenizde deploymentTemplates klasörünün bir kopyasını oluşturun: C#, JavaScript, Python veya Java.

İpucu

Bu, bot sağlama ve yayımlama işleminin daha büyük bir parçasıdır. Önkoşulların tam listesi için bot sağlama ve yayımlama bölümüne bakın.

Parametre dosyasını düzenle

ARM şablonunun parametre dosyasını, kullanmak istediğiniz değerleri içerecek şekilde düzenleyin.

Önemli

App Service ve appId Azure Bot kaynaklarınızı oluştururken aynı appType ve değerlerini kullanmanız gerekir.

Projeniz henüz en son ARM şablonu ve parametre dosyalarını içermiyorsa, bunları diliniz için Bot Framework SDK deposundan kopyalayabilirsiniz: C#, JavaScript, Python veya Java.

Bu tabloda, komut seçeneğiyle kullanılmak üzere parametre dosyasındaki parameters dağıtım parametreleri açıklanmaktadır. Varsayılan olarak, parametre dosyasının adı parameters-for-template-AzureBot-with-rg.json.

Parametre Tür Veri Akışı Açıklaması
azureBotId String Gerekli. Botunuz için genel olarak benzersiz ve sabit tanıtıcı, örneğin ContosoCustomerService.
azureBotSku String isteğe bağlı. Azure Bot kaynağının SKU'su. İzin verilen değerler: "F0" (ücretsiz) ve "S1" (standart). Varsayılan değer "S1"dir.
azureBotRegion String isteğe bağlı. Azure Botunun konumu. İzin verilen değerler: "global", "westeurope", "westus" ve "centralindia". Varsayılan değer "genel"dir.
botEndpoint String isteğe bağlı. Botunuzun mesajlaşma uç noktası, örneğin https://<appServiceName>.azurewebsites.net/api/messages.
appType String Gerekli. Bot kaynaklarınızın kimliklerinin nasıl yönetildiğini öğrenin. İzin verilen değerler şunlardır: "MultiTenant", "SingleTenant" ve "UserAssignedMSI". Varsayılan değer "MultiTenant"tır.
appId String Gerekli. Daha önce oluşturduğunuz kimlik kaynağından istemci kimliği veya uygulama kimliği. Bu, uygulama hizmetinin Microsoft uygulama kimliğidir.
UMSIName String isteğe bağlı. Kullanıcı tarafından atanan yönetilen kimlik uygulama türleri için kimlik kaynağının adı.
UMSIResourceGroupName String isteğe bağlı. Kullanıcı tarafından atanan yönetilen kimlik uygulama türleri için, kimlik kaynağının kaynak grubu.
tenantId String isteğe bağlı. Kullanıcı tarafından atanan yönetilen kimlik ve tek kiracılı uygulama türleri için, kimlik kaynağının Microsoft Entra Id kiracı kimliği.

İpucu

Yayımlanan botların iletileri alabilmesi için botunun mesajlaşma uç noktası ayarlanmalıdır.

Tüm parametreler tüm uygulama türleri için geçerli değildir.

, UMSIResourceGroupNameve tenantIdiçin UMSINamedeğerler sağlayın.

Azure Bot kaynağını oluşturma

Botunuz için Azure Bot kaynağı oluşturmak için aşağıdaki komutu kullanın.

az deployment group create --resource-group <resource-group> --template-file <template-file-path> --parameters "@<parameters-file-path>"
Seçenek Açıklama
resource-group App Service'in oluşturulacağı Azure kaynak grubunun adı.
şablon dosyası App Service için ARM şablonunun yolu. Yol göreli veya mutlak olabilir.
parametreler ARM şablonuyla kullanılacak parametre dosyasının yolu. Yol göreli veya mutlak olabilir.

En son oluşturucularla oluşturulan projeler için ARM şablonu ve parametre dosyaları projenin içindeki DeploymentTemplates\DeployUseExistResourceGroup klasöründe bulunur. Varsayılan dosya adları template-AzureBot-with-rg.json ve parameters-for-template-AzureBot-with-rg.json.

Azure Bot kaynağınızı güncelleştirmek için

Azure Botunuzun mesajlaşma uç noktasını eklemek veya güncelleştirmek için aşağıdaki komutu kullanın.

az bot update --resource-group <resource group> --name <azureBotId> --endpoint <messaging-endpoint>
Seçenek Açıklama
resource-group App Service'i içeren Azure kaynak grubunun adı.
Adı Botunuz için genel olarak benzersiz ve sabit tanıtıcı.
endpoint Botunuzun mesajlaşma uç noktası, örneğin https://<appServiceName>.azurewebsites.net/api/messages.

Ek bilgi

ARM şablonları hakkında daha fazla bilgi için bkz . ARM şablonları nedir? ve Azure Resource Manager (ARM) dağıtım şablonlarını Azure CLI ile kullanma.

Sonraki adımlar

App Service'i bir bot dağıtımının parçası olarak oluşturduysanız işleme devam etmek için bkz . ARM şablonlarıyla kaynak oluşturma.