Den här artikeln beskriver hur du skapar din första robot med Bot Framework SDK för C#, Java, JavaScript eller Python och hur du testar din robot med Bot Framework-emulatorn.
Att skapa din första robot kräver ingen Azure-prenumeration eller en Azure AI Bot Service-resurs. Den här snabbstarten fokuserar på att skapa din första robot lokalt. Om du vill lära dig hur du skapar en robot i Azure kan du läsa Skapa en Azure Bot-resurs.
Kommentar
Bot Framework JavaScript-, C#- och Python-SDK:erna fortsätter att stödjas, men Java SDK dras tillbaka med slutligt långsiktigt stöd som slutar i november 2023.
Befintliga robotar som skapats med Java SDK fortsätter att fungera.
.NET Core-mallar hjälper dig att snabbt skapa nya konversations-AI-robotar med Hjälp av Bot Framework v4.
Från och med maj 2020 kräver dessa mallar och den kod de genererar .NET Core 3.1 eller senare.
Du kan använda det här kommandot för att avgöra vilka versioner av kommandoradsgränssnittet för .NET Core som är installerade.
dotnet --version
Installera de tre Bot Framework C#-mallarna: mallarna echo, core och empty bot.
dotnet new -i Microsoft.Bot.Framework.CSharp.EchoBot
dotnet new -i Microsoft.Bot.Framework.CSharp.CoreBot
dotnet new -i Microsoft.Bot.Framework.CSharp.EmptyBot
Kontrollera att mallarna har installerats korrekt.
dotnet new --list
Kommentar
Stegen ovan installerar alla tre Bot Framework-mallar. Du behöver inte installera alla mallar och kan bara installera de som du använder. I den här artikeln används mallen för ekorobotar .
Ett Azure-konto om du vill distribuera till Azure.
Java-mallar
Använd Yeoman-generatorn för att snabbt skapa en konversations-AI-robot med hjälp av grundläggande AI-funktioner i Bot Framework v4. Mer information finns i yeoman.io.
Generatorn stöder tre olika mallalternativ enligt nedan.
Mall
beskrivning
Echo Bot
En bra mall om du vill ha lite mer än "Hello World!", men inte mycket mer. Den här mallen hanterar grunderna i att skicka meddelanden till en robot och låta roboten bearbeta meddelandena genom att upprepa dem till användaren. Den här mallen skapar en robot som helt enkelt "ekar" tillbaka till användaren allt användaren säger till roboten.
Tom robot
En bra mall om du är bekant med Bot Framework v4 och helt enkelt vill ha ett grundläggande skelettprojekt. Även ett bra alternativ om du vill ta exempelkod från dokumentationen och klistra in den i en minimal robot för att lära dig.
Kärnrobot
En bra mall om du vill skapa avancerade robotar eftersom den använder dialogrutor med flera svängar och Azure AI LUIS för att implementera språktolkning. Den här mallen skapar en robot som kan extrahera platser och datum för att boka en flygresa.
Conversational Language Understanding (CLU), en funktion i Azure AI Language, är den uppdaterade versionen av LUIS.
Mer information om stöd för språktolkning i Bot Framework SDK finns i Förstå naturligt språk.
Installera Yeoman
Kontrollera att du har installerat node.js version 12.10 eller senare.
Kunskap om restify och asynkron programmering i JavaScript
Visual Studio Code eller din favorit-IDE om du vill redigera robotkoden.
JavaScript- och TypeScript-mallar
Så här installerar du Yeoman och Yeoman-generatorn för Bot Framework v4:
Öppna en terminal eller en upphöjd kommandotolk.
Växla till katalogen för dina JavaScript-robotar. Skapa den först om du inte redan har en.
mkdir myJsBots
cd myJsBots
Kontrollera att du har de senaste versionerna av npm och Yeoman.
npm install -g npm
npm install -g yo
Installera Yeoman-generatorn.
Yeoman är ett verktyg för att skapa program. Mer information finns i yeoman.io.
npm install -g generator-botbuilder
Kommentar
Installationen av Windows-byggverktyg som anges nedan krävs endast om du använder Windows som utvecklingsoperativsystem.
För vissa installationer ger installationssteget för restify ett fel relaterat till node-gyp.
Om så är fallet kan du prova att köra det här kommandot med utökade behörigheter.
Det här anropet kan också hänga sig utan att avslutas om Python redan är installerat på systemet:
Kör endast det här kommandot om du använder Windows.
En virtuell miljö är en kombination av en specifik Python-tolk och bibliotek som skiljer sig från dina globala inställningar. Den virtuella miljön är specifik för ett projekt och underhålls i projektmappen. En fördel med att använda en virtuell miljö är att när du utvecklar ett projekt över tid återspeglar den virtuella miljön alltid projektets exakta beroenden. Mer information om virtuella miljöer finns i Skapa virtuella miljöer.
Gå till katalogen där du vill skapa roboten. Kör sedan följande kommandon för den plattform du föredrar. När du har aktiverat den virtuella miljön bör kommandoraden/terminalen vara förinställd med (venv). På så sätt vet du att den virtuella miljön är aktiv. Du kan inaktivera din virtuella miljö när som helst genom att skriva: deactivate.
macOS/Linux
python3 -m venv venv
source venv/bin/activate
Windows
python -m venv venv
venv\Scripts\activate.bat
Python-mallar
Installera nödvändiga paket genom att köra följande pip install kommandon:
Skapa ett nytt robotprojekt i Visual Studio och använd mallen Echo Bot (Bot Framework v4 – .NET Core 3.1). Om du bara vill se robotmallar väljer du projekttypen AI Bots .
Kontrollera att .NET Core 3.1 eller senare är installerat.
Öppna ett nytt terminalfönster i Visual Studio Code.
Gå till katalogen där du vill skapa robotprojektet.
Skapa ett nytt ekorobotprojekt med hjälp av följande kommando. Ersätt <your-bot-name> med namnet som ska användas för robotprojektet.
dotnet new echobot -n <your-bot-name>
Öppna ett nytt terminalfönster.
Gå till katalogen där du vill skapa robotprojektet.
Skapa ett nytt ekorobotprojekt med hjälp av följande kommando. Ersätt <your-bot-name> med namnet som ska användas för robotprojektet.
dotnet new echobot -n <your-bot-name>
Tack vare mallen innehåller projektet all nödvändig kod för att skapa roboten i den här snabbstarten. Du behöver inte mer kod för att testa roboten.
Kör följande kommando för att skapa en ekorobot från mallar. Kommandot använder standardalternativ för sina parametrar.
yo botbuilder-java -T "echo"
Yeoman ber dig om information som du kan använda för att skapa din robot. I den här självstudien använder du standardvärdena.
? 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"
Generatorn stöder många kommandoradsalternativ som du kan använda för att ändra generatorns standardvärden eller för att skicka en uppmaning i förväg. Alternativen är skiftlägeskänsliga.
Kommandoradsalternativ
beskrivning
--help, -h
Visa hjälptext för alla kommandoradsalternativ som stöds
--botName, -N
Namnet på robotprojektet
--packageName, -P
Java-paketnamnet som ska användas för roboten
--template, -T
Mallen som används för att generera projektet. Alternativen är echo, empty, core. Mer information om de olika mallarna finns i GitHub-lagringsplatsen för ditt språk, C#, JavaScript, Python eller Java.
--noprompt
Generatorn uppmanar inte till bekräftelse innan du skapar en ny robot. Alla kravalternativ som inte skickas på kommandoraden använder ett rimligt standardvärde. Det här alternativet är avsett att aktivera automatiserad robotgenerering i testsyfte.
Tack vare mallen innehåller projektet all kod som krävs för att skapa roboten i den här snabbstarten. Du behöver ingen annan kod för att testa roboten.
Yeoman ber dig om information som du kan använda för att skapa din robot. I den här självstudien använder du standardvärdena.
? 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
Tack vare mallen innehåller projektet all kod som krävs för att skapa roboten i den här snabbstarten. Du behöver ingen annan kod för att testa roboten.
