Bot Framework SDK'sı ile bot oluşturma

ŞUNLAR IÇIN GEÇERLIDIR: SDK v4

Bu makalede C#, Java, JavaScript veya Python için Bot Framework SDK'sı ile ilk botunuzu oluşturma ve Bot Framework Öykünücüsü ile botunuzu test etme işlemleri açıklanmaktadır.

İlk botunuzu oluşturmak için Azure aboneliği veya Azure yapay zeka Bot Hizmeti kaynağı gerekmez. Bu hızlı başlangıç, ilk botunuzu yerel olarak oluşturmaya odaklanır. Azure'da bot oluşturmayı öğrenmek istiyorsanız bkz . Azure Bot kaynağı oluşturma.

Dekont

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. Yalnızca bu depodaki kritik güvenlik ve hata düzeltmeleri yapılacaktır.

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

Yeni bot derlemesi için Power Virtual Agents'ı kullanmayı göz önünde bulundurun ve doğru sohbet botu çözümünü seçme hakkında bilgi edinin.

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

Ön koşullar

C#

• .NET 6.0 SDK
• Bot Framework Öykünücüsü
• C'de ASP.NET Core ve zaman uyumsuz programlama bilgisi#

C# şablonları

Geçerli bot örnekleri .NET Core 3.1 şablonlarını kullanır.

Visual Studio

• Visual Studio 2022 veya üzeri
• Visual Studio için Bot Framework v4 SDK Şablonları

Bot şablonlarını Visual Studio'ya eklemek için Visual Studio VSIX için Bot Framework v4 SDK Şablonları dosyasını indirip yükleyin.

Dekont

Şablonları Visual Studio'dan yükleyebilirsiniz.

1. Menüde Uzantılar'ı ve ardından Uzantıları Yönet'i seçin.
2. Uzantıları Yönet iletişim kutusunda Visual Studio için Bot Framework v4 SDK şablonlarını arayın ve yükleyin.

.NET botlarını Azure'a dağıtma hakkında bilgi için bkz . Bot sağlama ve yayımlama.

VS Code / CLI

.NET Core Şablonları, Bot Framework v4 kullanarak hızlı bir şekilde yeni konuşma yapay zekası botları oluşturmanıza yardımcı olur. Mayıs 2020 itibarıyla bu şablonlar ve oluşturdukları kod için .NET Core 3.1 veya üzeri gerekir.

Bot Framework şablonlarını yüklemek için:

1. Bir konsol penceresi açın.

2. .NET Core SDK'sı sürüm 3.1 veya üzerini indirip yükleyin.

3. .NET Core komut satırı arabiriminin hangi sürümlerinin yüklü olduğunu belirlemek için bu komutu kullanabilirsiniz.

   dotnet --version
   

4. Üç Bot Framework C# şablonunu yükleyin: yankı, çekirdek ve boş bot şablonları.

   dotnet new -i Microsoft.Bot.Framework.CSharp.EchoBot
   dotnet new -i Microsoft.Bot.Framework.CSharp.CoreBot
   dotnet new -i Microsoft.Bot.Framework.CSharp.EmptyBot
   

5. Şablonların doğru yüklendiğini doğrulayın.

   dotnet new --list
   

Dekont

Yukarıdaki adımlar üç Bot Framework şablonunu da yükler. Tüm şablonları yüklemeniz gerekmez ve yalnızca kullanacağınız şablonları yükleyebilirsiniz. Bu makalede yankı botu şablonu kullanılmaktadır.

Java

• Java 1.8 veya üzeri
• Bot Framework Öykünücüsü
• Bot kodunu düzenlemek istiyorsanız Visual Studio Code veya sık kullandığınız IDE.
• Maven'ı yükleme
• node.js sürüm 12.10 veya üzerini yükleyin.
• Azure'a dağıtmak istiyorsanız bir Azure hesabı.

Java şablonları

Bot Framework v4'teki temel yapay zeka özelliklerini kullanarak hızlı bir şekilde konuşma yapay zekası botu oluşturmak için Yeoman oluşturucuyu kullanın. Daha fazla bilgi için bkz . yeoman.io.

Oluşturucu, aşağıda gösterildiği gibi üç farklı şablon seçeneğini destekler.

Şablon	Tanım
Echo Bot	"Merhaba Dünya!" değerinden biraz daha fazlasını ama çok daha fazlasını istemiyorsanız iyi bir şablon. Bu şablon, bir bota ileti göndermenin ve botun iletileri kullanıcıya tekrarlayarak işlemesini sağlamanın temellerini ele alır. Bu şablon, kullanıcıya kullanıcının bota söylediği her şeyi "yankılayan" bir bot oluşturur.
Boş Bot	Bot Framework v4 hakkında bilgi sahibiyseniz ve basit bir iskelet projesi istiyorsanız iyi bir şablon. Ayrıca, belgelerden örnek kod almak ve öğrenmek için en düşük bota yapıştırmak istiyorsanız iyi bir seçenektir.
Çekirdek Bot	Gelişmiş botlar oluşturmak istiyorsanız, çok aşamalı iletişim kutularını ve dil anlama uygulamak için Azure AI LUIS'i kullandığı için iyi bir şablon. Bu şablon, uçuş rezervasyonu yapmak için yerleri ve tarihleri ayıklayan bir bot oluşturur.

Dekont

Language Understanding (LUIS) 1 Ekim 2025'te kullanımdan kaldırılacaktır. 1 Nisan 2023'e kadar yeni LUIS kaynakları oluşturamayacaksınız. Dil anlamanın daha yeni bir sürümü artık Azure AI Dili'nin bir parçası olarak kullanılabilir.

Azure AI Dili'nin bir özelliği olan konuşma dili anlama (CLU), LUIS'in güncelleştirilmiş sürümüdür. Bot Framework SDK'sında dil anlama desteği hakkında daha fazla bilgi için bkz . Doğal dil anlama.

Yeoman’ı yükleme

1. node.js sürüm 12.10 veya üzerini yüklediğinizden emin olun.

2. En son npm'yi yükleyin.

   npm install -g npm
   

3. Yeoman'ı yükleyin. Genel olarak yüklediğinizden emin olun.

   npm install -g yo
   

4. generator-botbuilder-java dosyasını yükleyin. Genel olarak yüklediğinizden emin olun.

   npm install -g generator-botbuilder-java
   

5. Yeoman ve generator-botbuilder-java'nın doğru yüklendiğini doğrulayın.

   yo botbuilder-java --help
   

JavaScript

• Node.js
• Bot Framework Öykünücüsü
• JavaScript'te restify ve zaman uyumsuz programlama bilgisi
• Bot kodunu düzenlemek istiyorsanız Visual Studio Code veya sık kullandığınız IDE.

JavaScript ve TypeScript şablonları

Bot Framework v4 için Yeoman ve Yeoman oluşturucuyu yüklemek için:

1. Bir terminal veya yükseltilmiş komut istemi açın.

2. JavaScript botlarınızın dizinine geçin. Henüz yoksa önce oluşturun.

   mkdir myJsBots
   cd myJsBots
   

3. npm ve Yeoman'ın en son sürümlerine sahip olduğunuzdan emin olun.

   npm install -g npm
   npm install -g yo
   

4. Yeoman oluşturucuyu yükleyin. Yeoman, uygulama oluşturmaya yönelik bir araçtır. Daha fazla bilgi için bkz . yeoman.io.

   npm install -g generator-botbuilder
   

   Dekont

   Aşağıda listelenen Windows derleme araçlarının yüklenmesi, yalnızca geliştirme işletim sistemi olarak Windows kullanıyorsanız gereklidir. Bazı yüklemelerde restify için yükleme adımı ile ilgili node-gypbir hata verir. Bu durumda, bu komutu yükseltilmiş izinlerle çalıştırmayı deneyebilirsiniz. Python sisteminizde zaten yüklüyse bu çağrı çıkmadan da askıda kalabilir:

   Bu komutu yalnızca Windows kullanıyorsanız çalıştırın.

   npm install -g windows-build-tools
   

Python

• Python 3.8.3
• Bot Framework Öykünücüsü
• Python'da zaman uyumsuz programlama bilgisi

Sanal ortam oluşturma ve etkinleştirme

Sanal ortam, belirli bir Python yorumlayıcı ve genel ayarlarınızdan farklı kitaplıkların birleşimidir. Sanal ortam bir projeye özgüdür ve proje klasöründe tutulur. Sanal ortam kullanmanın bir avantajı, zaman içinde bir proje geliştirirken sanal ortamın her zaman projenin tam bağımlılıklarını yansıtmasıdır. Sanal ortamlar hakkında daha fazla bilgi edinmek için bkz . Sanal ortam oluşturma.

Botunuzu oluşturmak istediğiniz dizine gidin. Ardından tercih ettiğiniz platform için aşağıdaki komutları çalıştırın. Sanal ortamınızı etkinleştirdikten sonra komut satırınızın/terminalinizin önüne ile (venv)başlanması gerekir. Bu, sanal ortamın etkin olduğunu bilmenizi sağlar. sanal ortamınızı istediğiniz zaman şunu yazarak devre dışı bırakabilirsiniz: deactivate.

macOS/Linux

python3 -m venv venv
source venv/bin/activate

Windows

python -m venv venv
venv\Scripts\activate.bat

Python şablonları

Aşağıdaki pip install komutları çalıştırarak gerekli paketleri yükleyin:

pip install botbuilder-core
pip install asyncio
pip install aiohttp
pip install cookiecutter==1.7.0

Önemli

Python'ın 32 bit sürümünü kullanıyorsanız komutunu da çalıştırdığınızdan pip install cryptography==2.8emin olun.

Bot oluşturma

C#

Visual Studio

Visual Studio'da yeni bir bot projesi oluşturun ve Echo Bot (Bot Framework v4 - .NET Core 3.1) şablonunu kullanın. Yalnızca bot şablonlarını görmek için Yapay Zeka Botları proje türünü seçin.

VS Code

.NET Core 3.1 veya sonraki bir sürümün yüklü olduğundan emin olun.

1. Visual Studio Code'da yeni bir terminal penceresi açın.

2. Bot projenizi oluşturmak istediğiniz dizine gidin.

3. Aşağıdaki komutu kullanarak yeni bir yankı botu projesi oluşturun. değerini bot projenizde kullanılacak adla değiştirin <your-bot-name> .

   dotnet new echobot -n <your-bot-name>
   

CLI

1. Yeni bir terminal penceresi açın.

2. Bot projenizi oluşturmak istediğiniz dizine gidin.

3. Aşağıdaki komutu kullanarak yeni bir yankı botu projesi oluşturun. değerini bot projenizde kullanılacak adla değiştirin <your-bot-name> .

   dotnet new echobot -n <your-bot-name>
   

Şablon sayesinde projeniz bu hızlı başlangıçta botu oluşturmak için gerekli tüm kodu içerir. Botunuzu test etmek için daha fazla koda ihtiyacınız yoktur.

Bir sorunla karşılaştığım bir yankı botuoluşturdum

Java

Şablonlardan bir yankı botu oluşturmak için aşağıdaki komutu çalıştırın. Komut, parametreleri için varsayılan seçenekleri kullanır.

yo botbuilder-java -T "echo"

Yeoman, botunuzu oluşturmak için sizden bazı bilgiler ister. Bu öğretici için varsayılan değerleri kullanın.

? What's the name of your bot? (echo)
? What's the fully qualified package name of your bot? (com.mycompany.echo)
? Which template would you like to start with? (Use arrow keys) Select "Echo Bot"
? Looking good.  Shall I go ahead and create your new bot? (Y/n) Enter "y"

Oluşturucu, oluşturucunun varsayılanlarını değiştirmek veya önceden bir istem oluşturmak için kullanabileceğiniz birçok komut satırı seçeneğini destekler. Seçenekler büyük/küçük harfe duyarlıdır.

Komut satırı seçeneği	Tanım
--help, -h	Desteklenen tüm komut satırı seçenekleri için yardım metnini listeleme
--botName, -N	Bot projesine verilen ad
--packageName, -P	Bot için kullanılacak Java paketi adı
--template, -T	Projeyi oluşturmak için kullanılan şablon. Seçenekler: echo, empty, core. Farklı şablonlar hakkında daha fazla bilgi için diliniz, C#, JavaScript, Python veya Java için GitHub deposuna bakın.
--noprompt	Oluşturucu yeni bir bot oluşturmadan önce onay istemez. Komut satırında geçirilmeyen tüm gereksinim seçenekleri makul bir varsayılan değer kullanır. Bu seçenek, test amacıyla otomatik bot oluşturmayı etkinleştirmeye yöneliktir.

Şablon sayesinde, projeniz bu hızlı başlangıçta botu oluşturmak için gereken tüm kodları içerir. Botunuzu test etmek için başka koda ihtiyacınız yoktur.

Bir sorunla karşılaştığım bir yankı botuoluşturdum

JavaScript

1. Yankı botu oluşturmak için oluşturucuyu kullanın.

   yo botbuilder
   

   Yeoman, botunuzu oluşturmak için sizden bazı bilgiler ister. Bu öğretici için varsayılan değerleri kullanın.

   ? What's the name of your bot? my-chat-bot
   ? What will your bot do? Demonstrate the core capabilities of the Microsoft Bot Framework
   ? What programming language do you want to use? JavaScript
   ? Which template would you like to start with? Echo Bot - https://aka.ms/bot-template-echo
   ? Looking good.  Shall I go ahead and create your new bot? Yes
   

Şablon sayesinde, projeniz bu hızlı başlangıçta botu oluşturmak için gereken tüm kodları içerir. Botunuzu test etmek için başka koda ihtiyacınız yoktur.

Bir sorunla karşılaştığım bir yankı botuoluşturdum

Python

1. Echo bot şablonunu ve bağımlılıklarını indirmek için çalışma dizininizden aşağıdaki komutu çalıştırın:

   cookiecutter https://github.com/microsoft/BotBuilder-Samples/releases/download/Templates/echo.zip
   

2. Botunuza bir ad ve açıklama vermeniz istenir. Aşağıdaki değerleri girin:

   • bot_name: echo_bot
   • bot_description: Kullanıcı yanıtlarını geri döndüren bir bot.

   

Bir sorunla karşılaştığım bir yankı botuoluşturdum

Botunuzu başlatma

C#

Visual Studio

Visual Studio'da:

1. Bot projenizi açın.
2. Hata ayıklamadan projeyi çalıştırın.
3. Visual Studio uygulamayı oluşturur, localhost'a dağıtır ve uygulamanın default.htm sayfasını görüntülemek için web tarayıcısını başlatır.

Bu noktada botunuz 3978 numaralı bağlantı noktasında yerel olarak çalışıyor.

VS Code

Visual Studio Code'da:

1. Bot proje klasörünüzü açın.

   Proje seçmeniz istenirse, oluşturduğunuz bot için bir proje seçin.

2. Menüde Çalıştır'ı ve ardından Hata Ayıklama Olmadan Çalıştır'ı seçin.

   • Bir ortam seçmeniz istenirse .Net Core'u seçin.
   • Bu komut başlatma ayarlarınızı güncelleştirdiyse, değişiklikleri kaydedin ve komutu yeniden çalıştırın.

   Çalıştır komutu uygulamayı derler, localhost'a dağıtır ve uygulamanın default.htm sayfasını görüntülemek için web tarayıcısını başlatır.

Bu noktada botunuz 3978 numaralı bağlantı noktasında yerel olarak çalışıyor.

CLI

Komut isteminden veya terminalden:

1. Dizinleri botunuzun proje klasörüne değiştirin.

2. Botu başlatmak için kullanın dotnet run .

   dotnet run
   

3. Bu komut uygulamayı oluşturur ve localhost'a dağıtır.

Uygulamanın varsayılan web sayfası görüntülenmez, ancak bu noktada botunuz 3978 numaralı bağlantı noktasında yerel olarak çalışıyor.

Bir sorunla karşılaştığım yankı botunubaşlattım

Java

1. Terminalden botunuzu kaydettiğiniz dizine gidin ve aşağıda listelenen komutları yürütebilirsiniz.

2. Maven projesini derleyin ve bir .jar dosyasına (arşiv) paketleyin.

   mvn package
   

3. Botu yerel olarak çalıştırın. archive-name değerini önceki komutun gerçek adıyla değiştirin.

   java -jar .\target\<archive-name>.jar
   

Artık Öykünücü'yü başlatmaya hazırsınız.

Bir sorunla karşılaştığım yankı botunubaşlattım

JavaScript

Terminalde veya komut isteminde dizinleri botunuz için oluşturulan dizinle değiştirin ve ile npm startbaşlatın.

cd my-chat-bot
npm start

Bu noktada botunuz 3978 numaralı bağlantı noktasında yerel olarak çalışıyor.

Bir sorunla karşılaştığım yankı botunubaşlattım

Python

1. Komut satırından/terminalden dizinleri olarak echo_botdeğiştirin.

   cd echo_bot
   

2. Yankı botu şablonu için bağımlılıkları yükleyin.

   pip install -r requirements.txt 
   

3. Bağımlılıklar yüklendikten sonra botunuzu başlatmak için aşağıdaki komutu çalıştırın:

   python app.py
   

   Aşağıdaki ekran görüntüsünde gösterilen son satırı gördüğünüzde botunuzun test etmeye hazır olduğunu öğreneceksiniz:

   

4. Son satırdaki http adresini kopyalayın. Botunuzla etkileşime geçmek için Öykünücü'yü kullandığınızda buna ihtiyacınız olacaktır.

Bir sorunla karşılaştığım yankı botunubaşlattım

Öykünücüyü başlatın ve botunuzu bağlayın

1. Bot Framework Emulator'ı başlatın.

2. Öykünücünün Hoş Geldiniz sekmesinde Botu Aç'ı seçin.

3. Botunuzun url'sini (yerel ana bilgisayarınız ve bağlantı noktanız) yola eklenerek /api/messages girin. Adres genellikle: http://localhost:3978/api/messages.

   

4. Ardından Bağlan'ı seçin.

   Botunuza bir ileti gönderdiğinizde bot yanıt verir.

   

Öykünücü'yü başlattım ve botumlabağlantı kurdum bir sorunla karşılaştım

Sonraki adımlar

• Visual Studio veya Visual Studio Code ve Bot Framework Öykünücüsü kullanarak hata ayıklama hakkında bilgi için bkz . Botta hata ayıklama.
• ngrok hakkında bilgi için bkz . Tünel oluşturma (ngrok).

Botunuzu Azure'a dağıtma