Azure bot kaynağı oluşturmak için Azure portalını kullanma
ŞUNLAR IÇIN GEÇERLIDIR: SDK v4
Azure Bot kaynağı (bot kaynağı), botunuzu Azure AI Bot Hizmeti kaydetmenize ve botunuzu kanallara bağlamanıza olanak tanır. Uygulamanızdan veya web sitenizden Teams' e, Messenger'a ve diğer birçok kanala kadar her yerde kullanıcılarınızla etkileşim kurmak için botlar oluşturabilir, bağlanabilir ve yönetebilirsiniz.
Bu makalede, Azure portalı aracılığıyla bot kaynağının nasıl oluşturulacağı açıklanmaktadır.
- Bot oluşturmayı öğrenmek için Bot Framework SDK'sı ile bot oluşturma hızlı başlangıcına bakın.
- Azure'da bot sağlama ve yayımlama hakkında bilgi için bkz . Botunuzu Azure'da dağıtma.
Kaynakları yönetme
Bot kaynağı oluşturduğunuzda Azure ilişkili kaynaklar oluşturur. Oluşturulan kaynaklardan bazıları, botunuzun kimliğini yönetmeye nasıl karar vermenize bağlıdır.
Bot kimliğiniz Azure'da birkaç farklı yolla yönetilebilir.
- Kullanıcı tarafından atanan yönetilen kimlik olarak bot kimlik bilgilerini kendiniz yönetmeniz gerekmez.
- Tek kiracılı bir uygulama olarak.
- Çok kiracılı bir uygulama olarak.
Kullanıcı tarafından atanan yönetilen kimlik ve tek kiracılı uygulama türleri için destek, 4.15.0 sürümünde C# ve JavaScript için Bot Framework SDK'sına eklendi. Bu uygulama türleri diğer dillerde veya Bot Framework Composer, Bot Framework Emulator veya ngrok'ta desteklenmez.
| Uygulama türü | Destek |
|---|---|
| Kullanıcı tarafından atanan yönetilen kimlik | Azure AI Bot Hizmeti ve C# ile JavaScript SDK'ları |
| Tek kiracılı | Azure AI Bot Hizmeti ve C#, JavaScript ve Python SDK'ları |
| Çok kiracılı | Azure AI Bot Hizmeti, tüm Bot Framework SDK dilleri, Composer, Öykünücü ve ngrok |
Önkoşullar
- Azure aboneliğiniz yoksa başlamadan önce ücretsiz bir hesap oluşturun.
- Kullanıcı tarafından atanan yönetilen kimlik ve tek kiracılı botlar için C# veya JavaScript sürüm 4.15.0 veya üzeri için Bot Framework SDK'sı.
Kaynağı oluşturma
Botunuzu Azure AI Bot Hizmeti kaydetmenizi sağlayacak Azure Bot kaynağını oluşturun.
İpucu
Yeni Web Uygulaması Botu ve Bot Kanalları Kayıt kaynakları oluşturulamaz; ancak yapılandırılan ve dağıtılan bu tür mevcut kaynaklar çalışmaya devam eder. SDK sürüm 4.14.1.2 veya sonraki bir sürümden bir VSIX veya Yeoman şablonundan oluşturulan botlar, Azure Bot kaynağı oluşturacak ARM şablonlarını içerir.
Azure portalına gidin.
Sağ bölmede Kaynak oluştur'u seçin.
Arama kutusuna yazın
botve Enter tuşuna basın.Azure Bot kartını seçin.
Oluştur'u belirleyin.
Gerekli alanlara değerleri girin ve ayarları gözden geçirip güncelleştirin.
Proje ayrıntıları altında bilgi sağlayın. Botunuzun genel mi yoksa yerel veri yerleşimi mi olacağını seçin. Şu anda yerel veri yerleşimi özelliği "westeurope" ve "centralindia" bölgesindeki kaynaklar için kullanılabilir. Daha fazla bilgi için bkz. Azure yapay zeka Bot Hizmeti bölgeselleştirme.
Microsoft Uygulama Kimliği altında bilgi sağlayın. Bot kimliğinizin Azure'da nasıl yönetileceğini ve yeni bir kimlik oluşturulup oluşturulmayacağını veya mevcut bir kimliğin nasıl kullanılacağını seçin.
Gözden geçir ve oluştur’u seçin.
Doğrulama başarılı olursa Oluştur'u seçin.
Dağıtım tamamlandıktan sonra Kaynağa git'i seçin. Botu ve ilgili kaynakları seçtiğiniz kaynak grubunda listelenmiş olarak görmeniz gerekir.
Bot Framework SDK'nız yoksa tercih ettiğiniz dile yönelik paketleri kullanmayı öğrenmek için GitHub'dan indir'i seçin.
Artık Bot Framework SDK'sı ile botunuzu oluşturmaya hazırsınız.
İpucu
Azure, yeni bir uygulama kimliğine sahip yeni bir tek kiracılı veya çok kiracılı Azure Bot kaynağı oluşturduğunda bir parola da oluşturur.
Bot kimlik bilgileri
Botunuzun yapılandırma dosyasına kimlik bilgileri eklemek için bu adımları izleyin. Dosya, botu oluşturmak için kullandığınız programlama diline bağlı olarak farklılık gösterir.
Önemli
Bot Framework SDK'sının Java sürümü yalnızca çok kiracılı botları destekler. Bot Framework SDK'sının Python sürümü çok kiracılı ve tek kiracılı botları destekler. C# ve JavaScript sürümleri, bot kimliğini yönetmek için üç uygulama türünü de destekler.
| Dil | Dosya adı | Notlar |
|---|---|---|
| C# | appsettings.json | Botunuzun kimliğini yönetmek için üç uygulama türünü de destekler. |
| JavaScript | .Env | Botunuzun kimliğini yönetmek için üç uygulama türünü de destekler. |
| Java | application.properties | Yalnızca çok kiracılı botları destekler. |
| Python | config.py | Çok kiracılı ve tek kiracılı botları destekler. Özellikleri yöntem çağrılarına os.environ.get bağımsız değişken olarak sağlayın. |
Eklemeniz gereken kimlik bilgileri botunun uygulama türüne bağlıdır. Yapılandırma dosyanızda aşağıdaki değerleri sağlayın.
Yalnızca C# ve JavaScript botlarında kullanılabilir.
| Özellik | Değer |
|---|---|
MicrosoftAppType |
UserAssignedMSI |
MicrosoftAppId |
Kullanıcı tarafından atanan yönetilen kimliğin istemci kimliği. |
MicrosoftAppPassword |
Uygulanamaz. Kullanıcı tarafından atanan yönetilen kimlik botu için bunu boş bırakın. |
MicrosoftAppTenantId |
Kullanıcı tarafından atanan yönetilen kimliğin kiracı kimliği. |
App Service'inizi güncelleştirmek için
Botunuz için mevcut bir App Service kaynağınız (web uygulaması) varsa ve botunuz kullanıcı tarafından atanan bir yönetilen kimlik uygulamasıysa botunuzun uygulama hizmetini güncelleştirmeniz gerekebilir:
- Botunuzun web uygulaması için App Service dikey penceresine gidin.
- Ayarlar altında Kimlik'i seçin.
- Kimlik dikey penceresinde Kullanıcı tarafından atanan sekmesini ve Ekle (+) öğesini seçin.
- Kullanıcı tarafından atanan yönetilen kimlik ekle dikey penceresinde:
Aboneliğinizi seçin.
Kullanıcı tarafından atanan yönetilen kimlikler için botunuzun yönetilen kimliğini seçin. Yönetilen kimlik sizin için otomatik olarak oluşturulduysa botunuzla aynı ada sahip olur.
Botunuzda bu kimliği kullanmak için Ekle'yi seçin.
Uygulamanızı veya kiracı kimliğinizi almak için
Botunuzun uygulamasını veya kiracı kimliğini almak için:
- Botunuzun Azure Bot kaynağı dikey penceresine gidin.
- Bot'un Yapılandırma dikey penceresine gidin. Bu dikey pencerede bot'un Microsoft Uygulama Kimliği'ni veya Uygulama Kiracı Kimliği'ni kopyalayabilirsiniz.
Yeni parola oluşturmak için
Tek kiracılı ve çok kiracılı botların bazı işlemler için ihtiyacınız olan bir uygulama gizli dizisi veya parolası vardır. Azure AI Bot Hizmeti bot gizli dizinizi gizler. Ancak botun App Service kaynağının sahibi yeni bir parola oluşturabilir:
- Botunuzun Azure Bot kaynağı dikey penceresine gidin.
- Bot'un Yapılandırma dikey penceresine gidin.
- Microsoft Uygulama Kimliği'nin yanındaki Yönet'i seçerek uygulama hizmetinin Sertifikalar + gizli diziler dikey penceresine gidin.
- Yeni bir istemci gizli dizisi oluşturmak ve değeri güvenli bir yere kaydetmek için dikey penceredeki yönergeleri izleyin.
Ek bilgi
- Microsoft Entra Id ile kimlik yönetimi hakkında bilgi için bkz . Microsoft Entra Id nedir?.
- Azure Uygulaması Service ve App Service planları hakkında bilgi için bkz. App Service'e genel bakış.
- Azure kaynakları ve genel olarak nasıl yönetildikleri hakkında bilgi için bkz. Azure Resource Manager'a genel bakış.
Not
Bot Framework Oluşturucu ve Bot Framework Öykünücüsü şu anda yalnızca çok kiracılı botları desteklemektedir. Kullanıcı tarafından atanan yönetilen kimlik ve tek kiracılı botlar için C# veya JavaScript sürüm 4.15.0 veya üzeri için Bot Framework SDK'sı gereklidir.
Beceri desteği
Bazı beceri tüketicileri, bazı beceri botu türlerini kullanamaz. Aşağıdaki tabloda hangi birleşimlerin desteklendiği açıklanmaktadır.
| Çok kiracılı beceri | Tek kiracılı beceri | Kullanıcı tarafından atanan yönetilen kimlik becerisi | |
|---|---|---|---|
| Çok kiracılı tüketici | Desteklenir | Desteklenmez | Desteklenmez |
| Tek kiracılı tüketici | Desteklenmez | Her iki uygulama da aynı kiracıya aitse desteklenir | Her iki uygulama da aynı kiracıya aitse desteklenir |
| Kullanıcı tarafından atanan yönetilen kimlik tüketicisi | Desteklenmez | Her iki uygulama da aynı kiracıya aitse desteklenir | Her iki uygulama da aynı kiracıya aitse desteklenir |
Beceri veya beceri tüketicisini yapılandırma hakkında bilgi için bkz . Beceri uygulama veya Beceri tüketicisi uygulama.