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.

C#, JavaScript ve Python için Bot Framework SDK'sına kullanıcı tarafından atanan yönetilen kimlik ve tek kiracılı uygulama türleri desteği eklendi. Bu uygulama türleri diğer dillerde veya Bot Framework Oluşturucu, Bot Framework Öykünücüsü veya Geliştirme Tünellerinde desteklenmez.

Ö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.

1. Azure portalına gidin.

2. Sağ bölmede Kaynak oluştur'u seçin.

3. Arama kutusuna yazın botve Enter tuşuna basın.

4. Azure Bot kartını seçin.

   

5. Oluştur'u belirleyin.

6. Gerekli alanlara değerleri girin ve ayarları gözden geçirip güncelleştirin.

   1. 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.

      

   2. 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.

      

7. Gözden geçir ve oluştur’u seçin.

8. Doğrulama başarılı olursa Oluştur'u seçin.

9. 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.

10. 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.

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.

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.

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:

1. Botunuzun web uygulaması için App Service dikey penceresine gidin.
2. Ayarlar'ın altında Kimlik'i seçin.
3. Kimlik dikey penceresinde Kullanıcı tarafından atanan sekmesini ve Ekle (+) öğesini seçin.
4. Kullanıcı tarafından atanan yönetilen kimlik ekle dikey penceresinde:

   1. Aboneliğinizi seçin.

   2. 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.

   3. 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:

1. Botunuzun Azure Bot kaynağı dikey penceresine gidin.
2. 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:

1. Botunuzun Azure Bot kaynağı dikey penceresine gidin.
2. Bot'un Yapılandırma dikey penceresine gidin.
3. Microsoft Uygulama Kimliği'nin yanındaki Yönet'i seçerek uygulama hizmetinin Sertifikalar + gizli diziler dikey penceresine gidin.
4. 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ış.

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.

Beceri veya beceri tüketicisini yapılandırma hakkında bilgi için bkz . Beceri uygulama veya Beceri tüketicisi uygulama.

Sonraki adımlar

• Bot Framework Composer ile bot oluşturma
• Bot Framework SDK'sı ile bot oluşturma