Creación de un bot con Bot Framework SDK para .NETCreate a bot with the Bot Framework SDK for .NET

se aplica a: SDK V4APPLIES TO: SDK v4

En este artículo se muestra cómo crear un bot mediante la plantilla de C# y cómo probarlo con el emulador de bot Framework.This article shows you how to build a bot by using the C# template, 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 agregar las plantillas de bot a Visual Studio, descargue e instale las plantillas del SDK de bot Framework V4 para el archivo VSIX de Visual Studio .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

Compilar con Visual StudioBuild with Visual Studio

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 Studio, inicie el proyecto.In Visual Studio, start the project. 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 pestaña de 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, 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.

    abrir una pantalla de bot CSopen a bot screen cs

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

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

    Emulador que ejecuta CSEmulator running cs

Recursos adicionalesAdditional resources

  • Consulte el archivo Léame de las plantillas de SDK de .net Core para obtener más información sobre las plantillas de .net Core.See the .NET Core SDK Templates README for more information about the .NET Core templates.
  • Vea cómo depurar un bot para depurar con Visual Studio o Visual Studio Code y el emulador de bot Framework.See how to 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