Questo articolo descrive come creare il primo bot con Bot Framework SDK per C#, Java, JavaScript o Python e come testare il bot con Bot Framework Emulator.
La creazione del primo bot non richiede una sottoscrizione di Azure o una risorsa servizio Bot di intelligenza artificiale di Azure. Questa guida introduttiva è incentrata sulla creazione del primo bot in locale. Per informazioni su come creare un bot in Azure, vedere Creare una risorsa di Azure Bot.
Nota
Gli SDK JavaScript, C# e Python di Bot Framework continueranno a essere supportati, ma Java SDK verrà ritirato con il supporto finale a lungo termine che termina a novembre 2023.
Verranno eseguite solo correzioni di bug e sicurezza critiche all'interno di questo repository.
I bot esistenti creati con Java SDK continueranno a funzionare.
I modelli di .NET Core consentono di creare rapidamente nuovi bot di intelligenza artificiale conversazionale usando Bot Framework v4.
A partire da maggio 2020, questi modelli e il codice generato richiedono .NET Core 3.1 o versione successiva.
È possibile usare questo comando per determinare le versioni dell'interfaccia della riga di comando di .NET Core installate.
dotnet --version
Installare i tre modelli C# di Bot Framework: echo, core e modelli di bot vuoti.
dotnet new -i Microsoft.Bot.Framework.CSharp.EchoBot
dotnet new -i Microsoft.Bot.Framework.CSharp.CoreBot
dotnet new -i Microsoft.Bot.Framework.CSharp.EmptyBot
Verificare che i modelli siano stati installati correttamente.
dotnet new --list
Nota
I passaggi precedenti installano tutti e tre i modelli di Bot Framework. Non è necessario installare tutti i modelli e installare solo quelli che verranno usati. Questo articolo usa il modello echo bot .
Un account Azure se si vuole eseguire la distribuzione in Azure.
Modelli Java
Usare il generatore Yeoman per creare rapidamente un bot di intelligenza artificiale conversazionale usando le funzionalità di intelligenza artificiale di base in Bot Framework v4. Per altre informazioni, vedere yeoman.io.
Il generatore supporta tre diverse opzioni di modello, come illustrato di seguito.
Modello
Descrizione
Echo Bot
Un buon modello se vuoi un po ' più di "Hello World!", ma non molto di più. Questo modello gestisce le nozioni di base dell'invio di messaggi a un bot e l'elaborazione dei messaggi da parte del bot ripetendoli all'utente. Questo modello genera un bot che semplicemente "ripete" all'utente qualsiasi elemento che l'utente dice al bot.
Empty Bot
Un modello valido se si ha familiarità con Bot Framework v4 e si vuole semplicemente un progetto di base. È anche una buona opzione se si vuole prendere il codice di esempio dalla documentazione e incollarlo in un bot minimo per imparare.
Core Bot
Un modello valido se si vogliono creare bot avanzati, perché usa dialoghi a più turni e LUIS di Intelligenza artificiale di Azure per implementare la comprensione del linguaggio. Questo modello crea un bot in grado di estrarre luoghi e date per prenotare un volo.
Nota
Language Understanding (LUIS) verrà ritirato il 1° ottobre 2025.
A partire dal 1° aprile 2023, non sarà possibile creare nuove risorse LUIS.
Una versione più recente di Language Understanding è ora disponibile come parte del linguaggio di intelligenza artificiale di Azure.
CLU (Conversational Language Understanding), una funzionalità del linguaggio di intelligenza artificiale di Azure, è la versione aggiornata di LUIS.
Per altre informazioni sul supporto per la comprensione del linguaggio in Bot Framework SDK, vedere Comprensione del linguaggio naturale.
Installare Yeoman
Assicurarsi di aver installato node.js versione 12.10 o successiva.
Conoscenza di restify e programmazione asincrona in JavaScript
Visual Studio Code o l'IDE preferito, se si vuole modificare il codice del bot.
Modelli JavaScript e TypeScript
Per installare Yeoman e il generatore Yeoman per Bot Framework v4:
Aprire un terminale o un prompt dei comandi con privilegi elevati.
Passare alla directory relativa ai bot JavaScript. Crearne una se non esiste già.
mkdir myJsBots
cd myJsBots
Assicurarsi di avere le versioni più recenti di npm e Yeoman.
npm install -g npm
npm install -g yo
Installare il generatore Yeoman.
Yeoman è uno strumento per la creazione di applicazioni. Per altre informazioni, vedere yeoman.io.
npm install -g generator-botbuilder
Nota
L'installazione degli strumenti di compilazione di Windows elencati di seguito è necessaria solo se si usa Windows come sistema operativo di sviluppo.
Per alcune installazioni, il passaggio di installazione per restify restituisce un errore correlato a node-gyp.
In tale circostanza si può provare a eseguire questo comando con autorizzazioni elevate:
Questa chiamata può anche bloccarsi senza uscire se Python è già installato nel sistema:
Conoscenza della programmazione asincrona in Python
Creare e abilitare un ambiente virtuale
Un ambiente virtuale è una combinazione di uno specifico interprete Python e librerie diverse dalle impostazioni globali. L'ambiente virtuale è specifico di un progetto e viene mantenuto nella cartella del progetto. Un vantaggio dell'uso di un ambiente virtuale è che quando si sviluppa un progetto nel tempo, l'ambiente virtuale riflette sempre le dipendenze esatte del progetto. Per altre informazioni sugli ambienti virtuali, vedere Creazione di ambienti virtuali.
Passare alla directory in cui si vuole creare il bot. Eseguire quindi i comandi seguenti per la piattaforma preferita. Dopo aver attivato l'ambiente virtuale, la riga di comando o il terminale devono essere preceduti da (venv). In questo modo è possibile sapere che l'ambiente virtuale è attivo. È possibile disattivare l'ambiente virtuale in qualsiasi momento digitando : deactivate.
macOS/Linux
python3 -m venv venv
source venv/bin/activate
Windows
python -m venv venv
venv\Scripts\activate.bat
Modelli Python
Installare i pacchetti necessari eseguendo i comandi seguenti pip install :
In Visual Studio creare un nuovo progetto bot e usare il modello Echo Bot (Bot Framework v4 - .NET Core 3.1). Per visualizzare solo i modelli di bot, scegliere il tipo di progetto Bot di intelligenza artificiale.
In Visual Studio Code aprire una nuova finestra del terminale.
Passare alla directory in cui si vuole creare il progetto bot.
Creare un nuovo progetto echo bot usando il comando seguente. Sostituire <your-bot-name> con il nome da usare per il progetto bot.
dotnet new echobot -n <your-bot-name>
Aprire una nuova finestra del terminale.
Passare alla directory in cui si vuole creare il progetto bot.
Creare un nuovo progetto echo bot usando il comando seguente. Sostituire <your-bot-name> con il nome da usare per il progetto bot.
dotnet new echobot -n <your-bot-name>
Grazie al modello, il progetto contiene tutto il codice necessario per creare il bot in questa guida introduttiva. Non è necessario altro codice per testare il bot.
Eseguire il comando seguente per creare un bot echo dai modelli. Il comando usa le opzioni predefinite per i relativi parametri.
yo botbuilder-java -T "echo"
Yeoman richiede alcune informazioni per la creazione del bot. Per questa esercitazione usare i valori predefiniti.
? 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"
Il generatore supporta molte opzioni della riga di comando che è possibile usare per modificare le impostazioni predefinite del generatore o per effettuare il pre-seeding di un prompt. Le opzioni fanno distinzione tra maiuscole e minuscole.
Opzione di riga di comando
Descrizione
--help, -h
Elencare il testo della Guida per tutte le opzioni della riga di comando supportate
--botName, -N
Nome assegnato al progetto bot
--packageName, -P
Nome del pacchetto Java da usare per il bot
--template, -T
Modello utilizzato per generare il progetto. Le opzioni sono echo, empty, core. Per altre informazioni sui diversi modelli, vedere il repository GitHub per il linguaggio, C#, JavaScript, Python o Java.
--noprompt
Il generatore non richiederà conferma prima di creare un nuovo bot. Qualsiasi opzione relativa ai requisiti non passata nella riga di comando userà un valore predefinito ragionevole. Questa opzione è progettata per abilitare la generazione automatica di bot a scopo di test.
Grazie al modello, il progetto contiene tutto il codice necessario per creare il bot in questa guida introduttiva. Non è necessario alcun altro codice per testare il bot.
Yeoman richiede alcune informazioni per la creazione del bot. Per questa esercitazione usare i valori predefiniti.
? 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
Grazie al modello, il progetto contiene tutto il codice necessario per creare il bot in questa guida introduttiva. Non è necessario alcun altro codice per testare il bot.
Selezionare Apri bot nella scheda Benvenuto dell'emulatore.
Immettere l'URL del bot, ovvero l'host locale e la porta, con /api/messages aggiunta al percorso. L'indirizzo è in genere: http://localhost:3978/api/messages.
