GÄLLER FÖR: SDK v4
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
Om du vill skapa agenter med val av AI-tjänster, orkestrering och kunskap kan du använda Microsoft 365 Agents SDK. Agents SDK har stöd för C#, JavaScript eller Python. Du kan läsa mer om Agents SDK på aka.ms/agents. Om du letar efter en SaaS-baserad agentplattform bör du överväga Microsoft Copilot Studio. Om du har en befintlig robot som skapats med Bot Framework SDK kan du uppdatera roboten till Agents SDK. Du kan granska de viktigaste ändringarna och uppdateringarna i Bot Framework SDK till agenternas SDK-migreringsvägledning. Supportärenden för Bot Framework SDK kommer inte längre att betjänas från och med den 31 december 2025.
Förutsättningar
C#-mallar
De aktuella robotexemplen använder .NET Core 3.1-mallar.
Om du vill lägga till robotmallarna i Visual Studio laddar du ned och installerar Bot Framework v4 SDK-mallar för Visual Studio VSIX-filen.
Kommentar
Du kan installera mallarna från Visual Studio.
- På menyn väljer du Tillägg och sedan Hantera tillägg.
-
I dialogrutan Hantera tillägg söker du efter och installerar Bot Framework v4 SDK-mallar för Visual Studio.
Information om hur du distribuerar .NET-robotar till Azure finns i hur du etablerar och publicerar en robot.
.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.
Så här installerar du Bot Framework-mallarna:
Öppna ett konsolfönster.
Ladda ned och installera .NET Core SDK-nedladdning version 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 .
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. |
Kommentar
Language Understanding (LUIS) dras tillbaka den 1 oktober 2025.
Från och med den 1 april 2023 kan du inte skapa nya LUIS-resurser.
En nyare version av språktolkning är nu tillgänglig som en del av Azure AI Language.
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.
Installera senaste npm.
npm install -g npm
Installera Yeoman. Se till att installera globalt.
npm install -g yo
Installera generator-botbuilder-java. Se till att installera globalt.
npm install -g generator-botbuilder-java
Kontrollera att Yeoman och generator-botbuilder-java har installerats korrekt.
yo botbuilder-java --help
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.
npm install -g windows-build-tools
Skapa och aktivera en virtuell miljö
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:
pip install botbuilder-core
pip install asyncio
pip install aiohttp
pip install cookiecutter==1.7.0
Viktigt!
Om du använder en 32-bitarsversion av Python kontrollerar du att du också kör pip install cryptography==2.8.
Skapa en robot
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.
Använd generatorn för att skapa en ekorobot.
yo botbuilder
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.
Från arbetskatalogen kör du följande kommando för att ladda ned mallen för ekoroboten och dess beroenden:
cookiecutter https://github.com/microsoft/BotBuilder-Samples/releases/download/Templates/echo.zip
Du uppmanas att ge roboten ett namn och en beskrivning. Ange följande värden:
-
bot_name: echo_bot
-
bot_description: En robot som ekar tillbaka användarsvaret.
Starta roboten
I Visual Studio:
- Öppna robotprojektet.
- Kör projektet utan att felsöka.
- Visual Studio skapar programmet, distribuerar det till localhost och startar webbläsaren för att visa programmets
default.htm sida.
Nu körs roboten lokalt på port 3978.
I Visual Studio Code:
Öppna robotprojektmappen.
Om du uppmanas att välja ett projekt väljer du det för roboten som du skapade.
På menyn väljer du Kör och sedan Kör utan felsökning.
- Om du uppmanas att välja en miljö väljer du .Net Core.
- Om det här kommandot uppdaterade startinställningarna sparar du ändringarna och kör kommandot igen.
Körningskommandot skapar programmet, distribuerar det till localhost och startar webbläsaren för att visa programmets default.htm sida.
Nu körs roboten lokalt på port 3978.
Från en kommandotolk eller terminal:
Ändra kataloger till projektmappen för din robot.
Använd dotnet run för att starta roboten.
dotnet run
Det här kommandot skapar programmet och distribuerar det till localhost.
Programmets standardwebbsida visas inte, men just nu körs roboten lokalt på port 3978.
Från en terminal går du till katalogen där du sparade roboten och kör sedan kommandona nedan.
Skapa Maven-projektet och paketera det i en .jar fil (arkiv).
mvn package
Kör roboten lokalt.
Ersätt arkivnamnet med det faktiska namnet från föregående kommando.
java -jar .\target\<archive-name>.jar
Nu är du redo att starta emulatorn.
I en terminal eller kommandotolk ändrar du kataloger till den som skapats för din robot och startar den med npm start.
cd my-chat-bot
npm start
Nu körs roboten lokalt på port 3978.
Från kommandoraden/terminalen ändrar du kataloger till echo_bot.
cd echo_bot
Installera beroendena för ekorobotmallen.
pip install -r requirements.txt
När beroendena har installerats kör du följande kommando för att starta roboten:
python app.py
Du vet att roboten är redo att testas när du ser den sista raden som visas på skärmbilden nedan:
Kopiera http-adressen på den sista raden. Du behöver det när du använder emulatorn för att interagera med din robot.
Starta emulatorn och anslut din robot
Starta Bot Framework-emulatorn.
Välj Öppna robot på fliken Välkommen till emulatorn.
Ange robotens URL, som är din lokala värd och port, med /api/messages tillagd i sökvägen. Adressen är vanligtvis: http://localhost:3978/api/messages.
Välj sedan Anslut.
Skicka ett meddelande till roboten så svarar roboten igen.
Nästa steg