Creación de un bot con Bot Framework SDK para JavaScriptCreate a bot with the Bot Framework SDK for JavaScript

SE APLICA A: SíSDK v4 No SDK v3APPLIES TO: yesSDK v4 no SDK v3

Este inicio rápido le guía por la creación de un bot sencillo mediante el generador Bot Builder de Yeoman y Bot Framework SDK para JavaScript y su prueba posterior con Bot Framework Emulator.This quickstart walks you through building a single bot by using the Yeoman Bot Builder generator and the Bot Framework SDK for JavaScript, and then testing it with the Bot Framework Emulator.

La creación de un bot con Azure Bot Service y la creación local de un bot son maneras paralelas e independientes de crear un bot.Creating a bot with Azure Bot Service and creating a bot locally are independent, parallel ways to create a bot.

PrerrequisitosPrerequisites

Nota

La instalación de las herramientas de compilación de Windows que se indican a continuación solo se necesitan si se usa Windows como sistema operativo de desarrollo.The install of Windows build tools listed below is only required if you use Windows as your development operating system. En algunas instalaciones, el paso de instalación de restify genera un error relacionado con node-gyp.For some installations the install step for restify is giving an error related to node-gyp. Si este es el caso, intente ejecutar este comando con permisos elevados.If this is the case you can try running this command with elevated permissions. Esta llamada también puede bloquearse si Python ya está instalado en el sistema:This call may also hang without exiting if python is already installed on your system:

# only run this command if you are on Windows. Read the above note.
npm install -g windows-build-tools

Creación de un botCreate a bot

Creación del bot e inicialización de sus paquetesTo create your bot and initialize its packages

  1. Abra un terminal o un símbolo del sistema con privilegios elevados.Open a terminal or elevated command prompt.

  2. Cambie al directorio para sus bots de JavaScript.Switch to the directory for your JavaScript bots. Créelo primero si aún no tiene uno.Create it first if you don't already have one.

    mkdir myJsBots
    cd myJsBots
    
  3. Asegúrese de que la versión de npm está actualizada.Ensure your version of npm is up to date.

    npm install -g npm
    
  4. Después, instale o actualice Yeoman y el generador para JavaScriptNext, install or update Yeoman and the generator for JavaScript. (Yeoman es una herramienta para crear aplicaciones.(Yeoman is a tool for creating applications. Para obtener más información, consulte yeoman.io).For more information, see yeoman.io.)

    npm install -g yo generator-botbuilder
    
  5. Luego, use el generador para crear un bot de eco.Then, use the generator to create an echo bot.

    yo botbuilder
    

    Yeoman le solicitará alguna información con la que se va a crear el bot.Yeoman prompts you for some information with which to create your bot. En este tutorial, use los valores predeterminados.For this tutorial, use the default values.

    ? 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
    

Gracias a la plantilla, el proyecto contiene todo el código necesario para crear el bot en esta guía de inicio rápido.Thanks to the template, your project contains all the code that's necessary to create the bot in this quickstart. No es necesario ningún código adicional para probar el bot.You don't need any additional code to test your bot.

Nota

Si crea un bot Core, necesitará un modelo de lenguaje LUISIf you create a Core bot, you'll need a LUIS language model. (puede crear un modelo de lenguaje en luis.ai).(You can create a language model at luis.ai). Después de crear el modelo, actualice el archivo de configuración.After creating the model, update the configuration file.

Inicio del botStart your bot

En un terminal o símbolo del sistema, mueva los directorios al que creó para el bot e inícielo con npm start.In a terminal or command prompt change directories to the one created for your bot, and start it with npm start.

cd my-chat-bot
npm start

En este momento, el bot se ejecuta de forma local en el puerto 3978.At this point, your bot is running locally on port 3978.

Inicio del emulador y conexión del botStart the Emulator and connect your bot

  1. Inicie Bot Framework Emulator.Start the Bot Framework Emulator.

  2. Haga clic en Abrir bot de la pestaña de bienvenida del emulador.Click Open Bot on the Emulator's Welcome tab.

  3. Escriba la dirección URL del bot, que es la dirección URL del puerto local, con la adición de /api/messages a la ruta de acceso, normalmente http://localhost:3978/api/messages.Enter your bot's URL, which is the URL of the local port, with /api/messages added to the path, typically http://localhost:3978/api/messages.

    pantalla de apertura de un botopen a bot screen

  4. Haga clic en Conectar.Then click Connect.

    Envíe un mensaje al bot y este responderá con un mensaje.Send a message to your bot, and the bot will respond back with a message.

    Ejecución del emulador

Recursos adicionalesAdditional resources

Consulte Tunelización (ngrok) para más información sobre cómo conectarse a un bot hospedado de forma remota.See tunneling (ngrok) for how to connect to a bot hosted remotely.

Pasos siguientesNext steps