VAN TOEPASSING OP: SDK v4
In dit artikel wordt beschreven hoe u uw eerste bot bouwt met de Bot Framework SDK voor C#, Java, JavaScript of Python en hoe u uw bot test met de Bot Framework Emulator.
Voor het maken van uw eerste bot is geen Azure-abonnement of een Azure AI Bot Service-resource vereist. Deze quickstart is gericht op het lokaal maken van uw eerste bot. Zie Een Azure-botresource maken als u wilt weten hoe u een bot maakt in Azure.
Notitie
Als u agents wilt bouwen met uw keuze uit AI-services, indeling en kennis, kunt u overwegen om de Microsoft 365 Agents SDK te gebruiken. De Agents SDK biedt ondersteuning voor C#, JavaScript of Python. Meer informatie over de Agents SDK vindt u op aka.ms/agents. Als u op zoek bent naar een SaaS-agentplatform, kunt u Microsoft Copilot Studio overwegen. Als u een bestaande bot hebt gebouwd met de Bot Framework SDK, kunt u uw bot bijwerken naar de Agents SDK. U kunt de belangrijkste wijzigingen en updates bekijken bij Bot Framework SDK naar Agents SDK migratiegids. Ondersteuningstickets voor de Bot Framework SDK worden vanaf 31 december 2025 niet meer onderhouden.
Vereisten
C#-sjablonen
In de huidige botvoorbeelden worden .NET Core 3.1-sjablonen gebruikt.
Met .NET Core-sjablonen kunt u snel nieuwe conversationele AI-bots bouwen met Bot Framework v4.
Vanaf mei 2020 zijn deze sjablonen en de code die ze genereren vereist .NET Core 3.1 of hoger.
De Bot Framework-sjablonen installeren:
Open een consolevenster.
Download en installeer .NET Core SDK versie 3.1 of hoger.
U kunt deze opdracht gebruiken om te bepalen welke versies van de .NET Core-opdrachtregelinterface zijn geïnstalleerd.
dotnet --version
Installeer de drie Bot Framework C#-sjablonen: de echo-, kern- en lege botsjablonen.
dotnet new -i Microsoft.Bot.Framework.CSharp.EchoBot
dotnet new -i Microsoft.Bot.Framework.CSharp.CoreBot
dotnet new -i Microsoft.Bot.Framework.CSharp.EmptyBot
Controleer of de sjablonen correct zijn geïnstalleerd.
dotnet new --list
Notitie
In de bovenstaande stappen worden alle drie de Bot Framework-sjablonen geïnstalleerd. U hoeft niet alle sjablonen te installeren en kunt alleen de sjablonen installeren die u gaat gebruiken. In dit artikel wordt gebruikgemaakt van de sjabloon voor de echobot .
Java-sjablonen
Gebruik de Yeoman-generator om snel een conversationele AI-bot te maken met behulp van de belangrijkste AI-mogelijkheden in bot framework v4. Zie yeoman.io voor meer informatie.
De generator ondersteunt drie verschillende sjabloonopties, zoals hieronder wordt weergegeven.
| Sjabloon |
Beschrijving |
| ECHO bot |
Een goede sjabloon als u iets meer wilt dan 'Hallo wereld!, maar niet veel meer. Deze sjabloon verwerkt de basisbeginselen van het verzenden van berichten naar een bot en het laten verwerken van de berichten door de bot terug te zetten naar de gebruiker. Deze sjabloon produceert een bot die simpelweg 'echo's' weergeeft aan de gebruiker wat de gebruiker aan de bot zegt. |
| Lege bot |
Een goede sjabloon als u bekend bent met Bot Framework v4 en gewoon een basisskeletproject wilt. Ook een goede optie als u voorbeeldcode uit de documentatie wilt nemen en deze in een minimale bot wilt plakken om te leren. |
| Kernbot |
Een goede sjabloon als u geavanceerde bots wilt maken, omdat er gebruik wordt gemaakt van dialoogvensters met meerdere rollen en Azure AI LUIS om taalbegrip te implementeren. Met deze sjabloon maakt u een bot die plaatsen en datums kan extraheren om een vlucht te boeken. |
Notitie
Language Understanding (LUIS) wordt op 1 oktober 2025 buiten gebruik gesteld.
Vanaf 1 april 2023 kunt u geen nieuwe LUIS-resources maken.
Er is nu een nieuwere versie van taalkennis beschikbaar als onderdeel van Azure AI Language.
Conversational Language Understanding (CLU), een functie van Azure AI Language, is de bijgewerkte versie van LUIS.
Zie Natuurlijke taalkennis voor meer informatie over ondersteuning voor taalkennis in de Bot Framework SDK.
Yeoman installeren
Controleer of u node.js versie 12.10 of hoger hebt geïnstalleerd.
Installeer de meest recente npm.
npm install -g npm
Installeer Yeoman. Zorg ervoor dat u de installatie globaal uitvoert.
npm install -g yo
Installeer generator-botbuilder-java. Zorg ervoor dat u de installatie globaal uitvoert.
npm install -g generator-botbuilder-java
Controleer of Yeoman en generator-botbuilder-java correct zijn geïnstalleerd.
yo botbuilder-java --help
JavaScript- en TypeScript-sjablonen
Yeoman en de Yeoman-generator voor Bot Framework v4 installeren:
Open een terminal- of verhoogde opdrachtprompt.
Schakel over naar de map voor uw JavaScript-bots. Maak deze eerst als u er nog geen hebt.
mkdir myJsBots
cd myJsBots
Zorg ervoor dat u de nieuwste versies van npm en Yeoman hebt.
npm install -g npm
npm install -g yo
Installeer de Yeoman-generator.
Yeoman is een hulpprogramma voor het maken van toepassingen. Zie yeoman.io voor meer informatie.
npm install -g generator-botbuilder
Notitie
De installatie van windows-buildhulpprogramma's die hieronder worden vermeld, is alleen vereist als u Windows als uw ontwikkelbesturingssysteem gebruikt.
Voor sommige installaties geeft de installatiestap voor Restify een fout met betrekking tot node-gyp.
Als dit het geval is, kunt u deze opdracht uitvoeren met verhoogde machtigingen.
Deze aanroep kan ook vastlopen zonder af te sluiten als Python al op uw systeem is geïnstalleerd:
Voer deze opdracht alleen uit als u windows gebruikt.
npm install -g windows-build-tools
Een virtuele omgeving maken en inschakelen
Een virtuele omgeving is een combinatie van een specifieke Python-interpreter en -bibliotheken die afwijken van uw algemene instellingen. De virtuele omgeving is specifiek voor een project en wordt onderhouden in de projectmap. Een voordeel van het gebruik van een virtuele omgeving is dat wanneer u een project in de loop van de tijd ontwikkelt, de virtuele omgeving altijd de exacte afhankelijkheden van het project weerspiegelt. Zie Het maken van virtuele omgevingen voor meer informatie over virtuele omgevingen.
Navigeer naar de map waarin u uw bot wilt maken. Voer vervolgens de volgende opdrachten uit voor uw voorkeursplatform. Nadat u uw virtuele omgeving hebt geactiveerd, moet uw opdrachtregel/terminal worden voorafgegaan door (venv). Hiermee weet u dat de virtuele omgeving actief is. U kunt uw virtuele omgeving op elk gewenst moment deactiveren door het volgende te typen. deactivate
macOS/Linux
python3 -m venv venv
source venv/bin/activate
Ramen
python -m venv venv
venv\Scripts\activate.bat
Python-sjablonen
Installeer de benodigde pakketten door de volgende pip install opdrachten uit te voeren:
pip install botbuilder-core
pip install asyncio
pip install aiohttp
pip install cookiecutter==1.7.0
Belangrijk
Als u een 32-bits versie van Python gebruikt, moet u er ook voor zorgen dat u deze uitvoert pip install cryptography==2.8.
Een bot maken
Maak in Visual Studio een nieuw botproject en gebruik de sjabloon Echo Bot (Bot Framework v4 - .NET Core 3.1). Als u alleen botsjablonen wilt zien, kiest u het projecttype AI Bots .
Zorg ervoor dat .NET Core 3.1 of hoger is geïnstalleerd.
Open in Visual Studio Code een nieuw terminalvenster.
Ga naar de map waarin u uw botproject wilt maken.
Maak een nieuw echobotproject met behulp van de volgende opdracht. Vervang <your-bot-name> door de naam die u voor uw botproject wilt gebruiken.
dotnet new echobot -n <your-bot-name>
Open een nieuw terminalvenster.
Ga naar de map waarin u uw botproject wilt maken.
Maak een nieuw echobotproject met behulp van de volgende opdracht. Vervang <your-bot-name> door de naam die u voor uw botproject wilt gebruiken.
dotnet new echobot -n <your-bot-name>
Dankzij de sjabloon bevat uw project alle benodigde code om de bot in deze quickstart te maken. U hebt geen code meer nodig om uw bot te testen.
Voer de volgende opdracht uit om een echobot te maken op basis van sjablonen. De opdracht maakt gebruik van standaardopties voor de parameters.
yo botbuilder-java -T "echo"
Yeoman vraagt u om informatie waarmee u uw bot kunt maken. Gebruik voor deze zelfstudie de standaardwaarden.
? 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"
De generator ondersteunt veel opdrachtregelopties die u kunt gebruiken om de standaardinstellingen van de generator te wijzigen of om een prompt vooraf te seeden. De opties zijn hoofdlettergevoelig.
| Opdrachtregeloptie |
Beschrijving |
--help, -h |
Help-tekst weergeven voor alle ondersteunde opdrachtregelopties |
--botName, -N |
De naam die aan het botproject is gegeven |
--packageName, -P |
De Naam van het Java-pakket dat moet worden gebruikt voor de bot |
--template, -T |
De sjabloon die wordt gebruikt om het project te genereren. Opties zijnecho, empty, . core Zie de GitHub-opslagplaats voor uw taal, C#, JavaScript, Python of Java voor meer informatie over de verschillende sjablonen. |
--noprompt |
De generator vraagt niet om bevestiging voordat u een nieuwe bot maakt. Vereisteopties die niet op de opdrachtregel worden doorgegeven, gebruiken een redelijke standaardwaarde. Deze optie is bedoeld om geautomatiseerde botgeneratie in te schakelen voor testdoeleinden. |
Dankzij de sjabloon bevat uw project alle code die nodig is om de bot te maken in deze quickstart. U hebt geen andere code nodig om uw bot te testen.
Gebruik de generator om een echobot te maken.
yo botbuilder
Yeoman vraagt u om informatie waarmee u uw bot kunt maken. Gebruik voor deze zelfstudie de standaardwaarden.
? 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
Dankzij de sjabloon bevat uw project alle code die nodig is om de bot te maken in deze quickstart. U hebt geen andere code nodig om uw bot te testen.
Voer vanuit uw werkmap de volgende opdracht uit om de sjabloon voor de echobot en de bijbehorende afhankelijkheden te downloaden:
cookiecutter https://github.com/microsoft/BotBuilder-Samples/releases/download/Templates/echo.zip
U wordt gevraagd uw bot een naam en beschrijving te geven. Voer de volgende waarden in:
-
bot_name: echo_bot
-
bot_description: een bot die het antwoord van de gebruiker weerstuurt.
Uw bot starten
In Visual Studio:
- Open uw botproject.
- Voer het project uit zonder foutopsporing.
- Visual Studio bouwt de toepassing, implementeert deze op localhost en start de webbrowser om de pagina van
default.htm de toepassing weer te geven.
Op dit moment wordt uw bot lokaal uitgevoerd op poort 3978.
In Visual Studio Code:
Open de projectmap van uw bot.
Als u wordt gevraagd om een project te selecteren, selecteert u het project voor de bot die u hebt gemaakt.
Selecteer Uitvoeren in het menu en voer uitvoeren zonder foutopsporing uit.
- Als u wordt gevraagd om een omgeving te selecteren, selecteert u .Net Core.
- Als deze opdracht de startinstellingen heeft bijgewerkt, slaat u de wijzigingen op en voert u de opdracht opnieuw uit.
Met de run-opdracht wordt de toepassing gebouwd, geïmplementeerd op localhost en wordt de webbrowser gestart om de pagina van default.htm de toepassing weer te geven.
Op dit moment wordt uw bot lokaal uitgevoerd op poort 3978.
Vanaf een opdrachtprompt of terminal:
Wijzig mappen in de projectmap voor uw bot.
Gebruik dotnet run dit om de bot te starten.
dotnet run
Met deze opdracht wordt de toepassing gebouwd en geïmplementeerd op localhost.
De standaardwebpagina van de toepassing wordt niet weergegeven, maar op dit moment wordt uw bot lokaal uitgevoerd op poort 3978.
Navigeer vanuit een terminal naar de map waarin u uw bot hebt opgeslagen en voer vervolgens de onderstaande opdrachten uit.
Bouw het Maven-project en verpakt het in een .jar bestand (archief).
mvn package
Voer de bot lokaal uit. Vervang de archiefnaam door de werkelijke naam van de vorige opdracht.
java -jar .\target\<archive-name>.jar
U bent nu klaar om de emulator te starten.
Wijzig in een terminal of opdrachtprompt mappen in de directory die voor uw bot is gemaakt en start deze met npm start.
cd my-chat-bot
npm start
Op dit moment wordt uw bot lokaal uitgevoerd op poort 3978.
Wijzig vanaf de opdrachtregel/terminal de mappen in echo_bot.
cd echo_bot
Installeer de afhankelijkheden voor de sjabloon voor de echobot.
pip install -r requirements.txt
Nadat de afhankelijkheden zijn geïnstalleerd, voert u de volgende opdracht uit om uw bot te starten:
python app.py
U weet dat uw bot klaar is om te testen wanneer u de laatste regel ziet die wordt weergegeven in de onderstaande schermafbeelding:
Kopieer het HTTP-adres op de laatste regel. U hebt deze nodig wanneer u de emulator gebruikt om met uw bot te communiceren.
De emulator starten en uw bot verbinden
Start de Bot Framework Emulator.
Selecteer Bot openen op het tabblad Welkom van de emulator.
Voer de URL van uw bot in, die uw lokale host en poort is, en /api/messages voeg deze toe aan het pad. Het adres is meestal: http://localhost:3978/api/messages.
Selecteer vervolgens Connect.
Stuur een bericht naar uw bot en de bot reageert terug.
Volgende stappen