Tutorial: Creación de un bot básicoTutorial: Create a basic bot

se aplica a: SDK V4APPLIES TO: SDK v4

En este tutorial se describe cómo crear un bot básico con Bot Framework SDK.This tutorial describes how to create a basic bot with the Bot Framework SDK. Si ya ha creado un bot básico y lo ha hecho ejecutar localmente, lea el artículo Tutorial: Implementación de un bot básico.If you've already created a basic bot and have it running locally, read the Tutorial: Deploy a basic bot article.

Aprenderá a:You will learn how to:

  • Creación de un bot básicoCreate a basic bot
  • Ejecución del bot en la máquina localRun the bot on your local machine
  • Pruebe con el Bot Framework EmulatorTest it using the Bot Framework Emulator

PrerrequisitosPrerequisites

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 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

Pasos siguientesNext steps