Creación de un bot con el SDK de Bot Framework

SE APLICA A: SDK v4

En este inicio rápido, aprenderá a compilar el primer bot con Bot Framework SDK para C#, Java, JavaScript o Python y cómo probar el bot con el Bot Framework Emulator.

La creación del primer bot no requiere una suscripción de Azure ni un recurso de Azure Bot Service. Este inicio rápido se centra en la creación del primer bot localmente. Si quiere aprender a crear un bot en Azure, consulte Creación de un recurso de Azure Bot.

Prerrequisitos

Plantillas

Para agregar las plantillas de bot a Visual Studio, descargue e instale el archivo VSIX de Plantillas del SDK de Bot Framework v4 para Visual Studio .

Nota

El paquete VSIX incluye las versiones de .NET Core 2.1 y .NET Core 3.1 de las plantillas de C#. Al crear nuevos bots en Visual Studio 2019 o versiones posteriores, debe usar las plantillas de .NET Core 3.1. Los ejemplos de bot actuales usan plantillas de .NET Core 3.1. Encontrará los ejemplos que usan las plantillas de .NET Core 2.1 en la rama 4.7-archive del repositorio BotBuilder-Samples.

Para instalar las plantillas en Visual Studio, en la barra de menús superior, vaya aExtensiones Administrar extensiones>. A continuación, busque e instale bot Framework v4 SDK para Visual Studio.

Para obtener información sobre cómo implementar bots de .NET Core 3.1 en Azure, consulte cómo implementar el bot en Azure.

Creación de un bot

En Visual Studio, cree un proyecto de bot mediante la plantilla Echo Bot (Bot Framework v4 - .NET Core 3.1) . Para ver solo las plantillas de bot, elija Bots de IA en los tipos de proyecto.

Gracias a la plantilla, el proyecto contiene todo el código necesario para crear el bot en este inicio rápido. No necesita más código para probar el bot.

Sugerencia

Si crea un bot principal :

  • Solo el directorio de la solución recibe el nombre del bot.
  • Necesitará un modelo de lenguaje luis. Puede crear un modelo de lenguaje en luis.ai. Después de crear el modelo, actualice el archivo de configuración.

Inicio del bot

En Visual Studio:

  1. Abra el proyecto de bot.
  2. Ejecute el proyecto sin depurar.
  3. Visual Studio compila la aplicación, la implementa en localhost e inicia el explorador web para mostrar la página de default.htm la aplicación.

En este momento, el bot se ejecuta de forma local en el puerto 3978.

Inicio del emulador y conexión del bot

  1. Inicie Bot Framework Emulator.

  2. Seleccione Abrir bot en la pestaña Bienvenida del emulador.

  3. Escriba la dirección URL del bot, que es el host local y el puerto, con /api/messages agregado a la ruta de acceso. La dirección suele ser: http://localhost:3978/api/messages.

    abrir un bot

  4. A continuación, seleccione Conectar.

    Envíe un mensaje al bot y el bot responderá de nuevo.

    mensaje de eco

Recursos adicionales

  • Consulte Depuración de un bot para obtener información sobre cómo depurar mediante Visual Studio o Visual Studio Code y el Bot Framework Emulator.
  • Consulte Tunelización (ngrok) para obtener información sobre cómo instalar ngrok.

Pasos siguientes