Creación de un bot con Bot Framework SDK para PythonCreate a bot with the Bot Framework SDK for Python

SE APLICA A: SíSDK v4 No SDK v3APPLIES TO: yesSDK v4 no SDK v3

Esta guía de inicio rápido le orienta en el desarrollo de un bot con la plantilla Echo Bot de Python y, a continuación, con la prueba con Bot Framework Emulator.This quickstart walks you through building a bot using the Python Echo Bot template, and then testing it with the Bot Framework Emulator.

PrerrequisitosPrerequisites

Creación de un botCreate a bot

Nota

A algunos desarrolladores puede resultarles útil crear bots de Python en un entorno virtual.Some developers may find it useful to create Python bots in a virtual envrionment. Los pasos siguientes funcionarán independientemente de si desarrolla en un entorno virtual o en la máquina local.The steps below will work regardless if you're developing in a virtual environment or on your local machine.

  1. Abra un terminal.Open a terminal. Para instalar los paquetes necesarios, ejecute los comandos siguientes:Install the necessary packages by running the following commands:
  • pip install botbuilder-core
  • pip install asyncio
  • pip install aiohttp
  • pip install cookiecutter==1.7.0

El último paquete, cookiecutter, se utilizará para generar el bot.The last package, cookiecutter, will be used to generate your bot. Compruebe que cookiecutter se instaló correctamente; para ello, ejecute cookiecutter --help.Verify that cookiecutter was installed correctly by running cookiecutter --help.

  1. Para crear el bot, ejecute:To create your bot run:
cookiecutter https://github.com/microsoft/botbuilder-python/releases/download/Templates/echo.zip

Este comando crea un bot de eco basado en la plantilla de eco de Python.This command creates an Echo Bot based on the Python echo template.

  1. Se le pedirá el nombre del bot y una descripción.You will be prompted for the name of the bot and a description. Asigne el nombre echo-bot al bot y establezca la descripción en A bot that echoes back user response., como se muestra a continuación:Name your bot echo-bot and set the description to A bot that echoes back user response. as shown below:

establecer nombre y descripción

Copie los últimos cuatro dígitos de la dirección en la última línea (normalmente 3978), ya que los utilizará en el paso siguiente.Copy the last for digits in the address on the last line (usually 3978) since you will be using them in the next step. Ahora ya está preparado para iniciar el bot.You are now ready to start your bot.

Inicio del botStart you bot

  1. Desde un terminal, vaya a la carpeta echo-bot en la que guardó el bot.From a terminal navigate to the echo-bot folder where you saved your bot. Ejecute pip install -r requirements.txt para instalar los paquetes necesarios para ejecutar el bot.Run pip install -r requirements.txt to install any required packages to run your bot.

  2. Una vez que se instalen los paquetes, ejecute python app.py para iniciar el bot.Once the packages are installed run python app.py to start your bot. Sabrá que el bot está listo para probarlo cuando vea la última línea que se muestra en la siguiente captura de pantalla:You will know your bot is ready to test when you see the last line shown in the screenshot below:

bot en ejecución local

Inicio del emulador y conexión del botStart the Emulator and connect your bot

  1. Inicie el emulador y haga clic en el botón Abrir bot.Start the Emulator and click the Open Bot button.

  2. Después de hacer clic en el botón, se abrirá una ventana de cuadro en la que se establecen los valores necesarios para ejecutar el bot.After clicking the button a box window will open where you set the necessary values to run the bot. Use el número que guardó anteriormente y establezca la dirección URL del bot en http://localhost:<saved number>/api/messages, como se muestra a continuación:Use the number you saved earlier and set the Bot URL to http://localhost:<saved number>/api/messages as seen below:

pantalla de apertura de un bot

  1. Haga clic en el botón Conectar y se debería iniciar el bot.Click the Connect button and your bot should start. Intente probar el bot; para ello, escriba cualquier cosa y haga clic en Entrar, como se muestra a continuación:Try testing the bot by typing anything and clicking Enter as seen below:

conexión y prueba

Recursos adicionalesAdditional resources

Consulte Tunelización (ngrok) para más información sobre cómo conectarse a un bot hospedado de forma remota.See tunneling (ngrok) for how to connect to a bot hosted remotely.

Pasos siguientesNext steps