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

SE APLICA A: SDK v4

En este artículo se describe cómo compilar el primer bot con Bot Framework SDK para C#, Java, JavaScript o Python y cómo probar el bot con Bot Framework Emulator.

La creación del primer bot no requiere una suscripción de Azure ni un recurso del servicio de Bot de Azure AI. Este inicio rápido se centra en la creación del primer bot localmente. Si quiere obtener información sobre cómo crear un bot en Azure, consulte Creación de un recurso de Azure Bot.

Nota:

Los SDK de JavaScript, C# y Python de Bot Framework seguirán siendo compatibles, pero el SDK de Java se va a retirar con la compatibilidad final a largo plazo que finaliza en noviembre de 2023. Solo se realizarán correcciones críticas de seguridad y errores dentro de este repositorio.

Los bots existentes creados con el SDK de Java seguirán funcionando.

Para la creación de nuevos bots, considera el uso de Power Virtual Agents y lee sobre cómo elegir la solución de bot de chat adecuada.

Para obtener más información, consulta El futuro de la creación de bots.

Requisitos previos

Plantilla de C++

Los ejemplos de bot actuales usan plantillas de .NET Core 3.1.

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

Nota:

Puedes instalar las plantillas desde Visual Studio.

  1. En el menú, selecciona Extensiones, y a continuación Administrar extensiones.
  2. En el cuadro de diálogo Administrar extensiones, busque e instale plantillas del SDK de Bot Framework v4 para Visual Studio.

Para obtener información sobre cómo implementar bots de .NET en Azure, consulte Aprovisionamiento y publicación de un bot.

Creación de un bot

En Visual Studio, crea un proyecto de bot mediante la plantilla Echo Bot (Bot Framework v4 - .NET Core 3.1). Elige Bots de IA en los tipos de proyecto para mostrar solo plantillas de bot.

Gracias a la plantilla, el proyecto contiene todo el código necesario para crear el bot en esta guía de inicio rápido. No es necesario ningún código adicional para probar el bot.

Inicio del bot

En Visual Studio:

  1. Abre el proyecto de bot.
  2. Ejecuta el proyecto sin depuración.
  3. Visual Studio compila la aplicación, la implementa en localhost e inicia el navegador web para mostrar la página default.htm de 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. Haz clic en Abrir bot en la pestaña de Bienvenido/a de Emulator.

  3. Escribe 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.

    open a bot

  4. A continuación, seleccione Conectar.

    Envía un mensaje al bot y te responderá.

    echo message

Pasos siguientes

  • Para obtener información sobre cómo depurar mediante Visual Studio o Visual Studio Code y Bot Framework Emulator, consulta Depuración de un bot.
  • Para obtener información sobre ngrok, ve Tunelización (ngrok).