Creación de un botCreate a bot

se aplica a: SDK V4APPLIES TO: SDK v4

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

PrerrequisitosPrerequisites

PlantillasTemplates

Para agregar las plantillas de bot Visual Studio, descargue e instale las plantillas del SDK de Bot Framework v4 para Visual Studio archivo VSIX.To add the bot templates to Visual Studio, download and install the Bot Framework v4 SDK Templates for Visual Studio VSIX file.

Nota

El paquete VSIX incluye las versiones .net Core 2,1 y .net Core 3,1 de las plantillas de C#.The VSIX package includes both .NET Core 2.1 and .NET Core 3.1 versions of the C# templates. Al crear nuevos bots en Visual Studio 2019, debe usar las plantillas de .NET Core 3.1.When creating new bots in Visual Studio 2019, you should use the .NET Core 3.1 templates. Los ejemplos de bot actuales usan plantillas de .NET Core 3.1.The current bot samples use .NET Core 3.1 templates. Encontrará los ejemplos que usan las plantillas de .NET Core 2.1 en la rama 4.7-archive del repositorio BotBuilder-Samples.You can find the samples that use .NET Core 2.1 templates in the 4.7-archive branch of the BotBuilder-Samples repository. Para obtener información sobre la implementación de bots de .NET Core 3,1 en Azure, consulte implementación de un bot en Azure.For information about deploying .NET Core 3.1 bots to Azure, see how to deploy your bot to Azure.

Creación de un botCreate a bot

En Visual Studio, cree un proyecto de bot mediante la plantilla Echo Bot (Bot Framework v4 - .NET Core 3.1) .In Visual Studio, create a new bot project using the Echo Bot (Bot Framework v4 - .NET Core 3.1) template. Elija Bots de IA en los tipos de proyecto para mostrar solo plantillas de bot.Choose AI Bots from the project types to show only bot templates.

Cuadro de diálogo Crear un nuevo proyecto, en Visual StudioVisual Studio create a new project dialog

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 principal, necesitará un modelo de lenguaje LUIS.If 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 Visual StudioIn Visual Studio

  1. Abra el proyecto de bot.Open your bot project.
  2. Ejecute el proyecto sin depurar.Run the project without debugging.

Esto compilará la aplicación, la implementará en localhost e iniciará el explorador web para mostrar la página default.htm de la aplicación.This will build the application, deploy it to localhost, and launch the web browser to display the application's default.htm page. 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 Abrir bot en la Emulator de bienvenida de la aplicación.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 Depuración de un bot para obtener información sobre cómo depurar Visual Studio o Visual Studio Code y el Bot Framework Emulator.See Debug a bot for how to debug using Visual Studio or Visual Studio Code and the Bot Framework Emulator.
  • Consulte Tunelización (ngrok) para obtener información sobre cómo instalar ngrok.See Tunneling (ngrok) for information on how to install ngrok.

Pasos siguientesNext steps