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

se aplica a: SDK V4APPLIES TO: SDK v4

En este artículo se muestra cómo compilar un bot mediante el generador de Yeoman Bot Builder y el SDK de Bot Framework para JavaScript y, a continuación, cómo probarlo con el Bot Framework Emulator.This article shows you how to build a bot by using the Yeoman Bot Builder generator and the Bot Framework SDK for JavaScript, and then how to test 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.

Requisitos previosPrerequisites

PlantillasTemplates

Para instalar Yeoman y el generador de Yeoman para Bot Framework v4:To install Yeoman and the Yeoman generator for Bot Framework v4:

  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 tiene las versiones más recientes de npm y Yeoman.Make sure you have the latest versions of npm and Yeoman.

    npm install -g npm
    npm install -g yo
    
  4. Instale el generador de Yeoman.Install the Yeoman generator. Yeoman es una herramienta para crear aplicaciones.Yeoman is a tool for creating applications. Para obtener más información, vea yeoman.io.For more information, see yeoman.io.

        npm install -g generator-botbuilder
    

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 está generando 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 no cerrarse 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

  1. Use el generador para crear un bot de eco.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. Seleccione Open Bot (Abrir bot) en la pestaña Welcome (Bienvenida) del emulador.Select 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, y se agrega a la ruta /api/messages 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.

    abrir un bot

  4. A continuación, seleccione Conectar.Then select Connect.

    Envíe un mensaje al bot y el bot responderá de nuevo.Send a message to your bot, and the bot will respond back.

    mensaje de eco

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