Azure PowerShell ile bot oluşturma ve yayımlama

Makale
07/20/2023

ŞUNLAR IÇIN GEÇERLIDIR: SDK v4

Bu makalede, mevcut bir Microsoft Entra ID uygulama kaydını kullanarak Azure PowerShell kullanarak bot oluşturma ve Azure'a kaydetme adımları gösterilmektedir.

Botunuzu barındırmak için bir Azure Bot kaynağı kullanın. Botunuzu yerel olarak oluşturup geliştirip Azure'da veya farklı bir platformda barındıracaksınız. Botu Azure'a kaydetme başlığında açıklanan adımları izleyin. Botunuzu kaydettiğinizde, botunuzun barındırıldığı web adresini sağlarsınız. Azure'da barındırmaya devam edebilirsiniz.

Bu komutları yerel olarak, Azure PowerShell kullanarak veya Azure portal aracılığıyla Azure CloudShell kullanarak uzaktan çalıştırabilirsiniz. Azure CloudShell hakkında daha fazla bilgi için bkz . Azure Cloud Shell'e Genel Bakış.

Önemli

Az.BotService PowerShell modülü önizleme aşamasındayken, cmdlet'ini Install-Module kullanarak ayrı olarak yüklemeniz gerekir.

Azure AI Bot Hizmeti ile bot oluşturma ve yerel olarak bot oluşturma, bot oluşturmanın bağımsız ve paralel yollarıdır.

Ön koşullar

Azure aboneliğiniz yoksa başlamadan önce ücretsiz bir hesap oluşturun.
Herhangi bir Microsoft Entra ID kiracısından kullanılabilecek mevcut bir Microsoft Entra Id uygulama kaydı.
- Bu hızlı başlangıcı tamamlamak için uygulama kaydı için uygulama kimliğine ve gizli diziye ihtiyacınız vardır.
Az PowerShell modülünü yükleyin. Az.BotService modülü önizlemede olduğundan bu gereklidir.
```
Install-Module -Name Az.BotService -AllowClobber
```
Azure PowerShell'i yerel olarak kullanmayı seçerseniz:
- Bağlan-AzAccount cmdlet'ini kullanarak Azure hesabınıza Bağlan.

Aboneliğinizi seçin

Birden çok Azure aboneliğiniz varsa, kaynakların faturalandırılacağı uygun aboneliği seçin.

Erişebileceğiniz abonelikleri listelemek için Get-AzSubscription cmdlet'ini kullanın.
```
Get-AzSubscription
```
Set-AzContext cmdlet'ini kullanarak belirli bir aboneliği ayarlayın.

Botunuz için uygulama kaydıyla aynı aboneliği kullanmanız gerekir.
```
Set-AzContext -SubscriptionId "<your-subscription-name-or-id>"
```

Kaynak grubu oluşturma

Botunuz için kullanmak istediğiniz bir Azure kaynak grubunuz yoksa New-AzResourceGroup cmdlet'ini kullanarak yeni bir tane oluşturun.

Kaynak grubu, Azure kaynaklarının grup olarak dağıtıldığı ve yönetildiği bir mantıksal kapsayıcıdır.

Aşağıdaki örnek, belirtilen ada ve belirtilen konuma sahip bir kaynak grubu oluşturur.

New-AzResourceGroup -Name <your-resource-group-name> -Location <your-resource-group-location>

Yeni bot hizmeti oluşturma

Botunuz için yeni bir bot hizmeti oluşturmak için New-AzBotService cmdlet'ini kullanırsınız. Aşağıdaki örnek, belirtilen değerlerle yeni bir bot hizmeti oluşturur.

New-AzBotService -ResourceGroupName <your-resource-group-name> -Name <your-bot-handle> -ApplicationId <your-app-registration-id> -Location <your-bot-service-location> -Sku S1 -Description "<your-bot-description>" -Webapp

Bot hizmetinin durumunu almak için Get-AzBotService cmdlet'ini kullanırsınız. Aşağıdaki örnek, belirtilen kaynak grubundaki tüm kaynakların listesini alır.

Get-AzBotService -ResourceGroupName <your-resource-group-name>

Proje klasörünü başlatma

Proje dosyası klasörünü başlatmak için Initialize-AzBotServicePrepareDeploy cmdlet'ini kullanırsınız. Aşağıdaki örnek, belirtilen klasörde belirtilen dosyayı başlatır.

Initialize-AzBotServicePrepareDeploy -CodeDir C:\tmp\MyEchoBot -ProjFileName MyEchoBot.csproj

Bot hizmetini Azure'da yayımlama

Bot hizmetinizi Azure'da yayımlamak için Publish-AzBotServiceApp cmdlet'ini kullanırsınız. Aşağıdaki örnek, belirtilen bot hizmetini Azure'da yayımlar.

Publish-AzBotServiceApp -ResourceGroupName myResourceGroup -CodeDir D:\tmp\MyEchoBot -Name MyEchoBot

Kodu indirin

Yerel olarak üzerinde çalışmak üzere kodu indirmek için Export-AzBotServiceApp cmdlet'ini kullanırsınız. Aşağıdaki örnek, belirtilen kaynak grubundaki belirtilen bot hizmeti uygulamasının kodunu indirir.

Export-AzBotServiceApp -ResourceGroupName myResourceGroup -Name MyEchoBot

Kaynakları temizleme

Bu makalede oluşturulan kaynaklar gerekli değilse, aşağıdaki örnekleri çalıştırarak bunları silebilirsiniz.

Bot Hizmeti silme

kaynak grubundan Bot Hizmeti silmek için Remove-AzBotService cmdlet'ini kullanırsınız. Aşağıdaki örnek, bot hizmetini belirtilen kaynak grubundan siler.

Remove-AzBotService -Name MyEchoBot -ResourceGroupName myResourceGroup

Kaynak grubunu silme

Dikkat

Aşağıdaki örnek, belirtilen kaynak grubunu ve içindeki tüm kaynakları siler. Bu makalenin kapsamı dışındaki kaynaklar belirtilen kaynak grubunda varsa, bunlar da silinir.

Remove-AzResourceGroup -Name myResourceGroup

Sonraki adımlar

Kodu indirdikten sonra botu makinenizde yerel olarak geliştirmeye devam edebilirsiniz. Botunuzu test ettikten ve bot kodunu Azure portalına yüklemeye hazır olduğunuzda, değişiklik yaptıktan sonra kodu otomatik olarak güncelleştirmek için Sürekli dağıtım ayarlama başlığı altında listelenen yönergeleri izleyin.

Aracılığıyla paylaş