Creación de un bot con Azure Bot ServiceCreate a bot with Azure Bot Service

se aplica a: SDK V4APPLIES TO: SDK v4

Azure Bot Service proporciona los componentes principales para crear bots, incluido Bot Framework SDK para desarrollar bots y Bot Service para conectar los bots con los canales.Azure Bot Service provides the core components for creating bots, including the Bot Framework SDK for developing bots and the bot service for connecting bots to channels. En este artículo se muestra cómo crear un bot con el SDK de bot Framework V4 y elegir una plantilla de .NET o de Node.js.This article shows how to create a bot using the Bot Framework SDK v4 and choosing either .NET or Node.js template.

Tiene dos enfoques para crear un bot con Azure:You have two approaches to create a bot with Azure:

  1. Aplicación web.Web App. Cree un bot y regístrelo con Azure mediante una aplicación Web, tal como se muestra en este artículo.Create a bot and register it with Azure using a Web application as shown in this article. Use este enfoque si desarrolla y hospeda un bot en Azure.You use this approach if you develop and host a bot in Azure.
  2. Registro de canales de bot.Bot channels registration. Crear y desarrollar su bot localmente y hospedarlo en una plataforma diferente de Azure.Create and develop your bot locally and host it on a platform different from Azure. Al registrar el bot, se proporciona la dirección web en la que se hospeda el bot.When you register your bot, you provide the web address where your bot is hosted. Todavía puede hospedarlo en Azure.You can still host it in Azure. Siga los pasos descritos en el artículo registro de los canales de bot .Follow the steps described in the Bot channels registration article.

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.

PrerrequisitosPrerequisites

Creación de un nuevo servicio de botsCreate a new bot service

  1. Inicie sesión en Azure Portal.Log in to the Azure portal.

  2. Haga clic en el vínculo crear un recurso que se encuentra en la esquina superior izquierda del Azure portal.Click Create a resource link found in the upper left-hand corner of the Azure portal.

  3. En el cuadro de búsqueda, escriba Bot y, en la lista desplegable, seleccione Bot de aplicación web.In the search box enter bot and in the drop-down list select Web App Bot.

    bot de aplicación Web

  4. En la página Bot de aplicación web , haga clic en el botón crear .In the Web App Bot page, click the Create button.

    creación de bot de aplicación Web

  5. En el formulario de Bot de aplicación web , proporcione la información solicitada sobre el bot tal y como se especifica en la tabla que aparece debajo de la imagen.In the Web App Bot form, provide the requested information about your bot as specified in the table below the image.

    Creación de la hoja Web App Bot (bot de aplicación web)

    ConfiguraciónSetting Valor sugeridoSuggested value DescripciónDescription
    Nombre del botBot name Nombre para mostrar del botYour bot's display name Nombre para mostrar del bot que aparece en los canales y directorios.The display name for the bot that appears in channels and directories. Este nombre se puede cambiar en cualquier momento.This name can be changed at anytime.
    SuscripciónSubscription Su suscripciónYour subscription Seleccione la suscripción de Azure que quiere usar.Select the Azure subscription you want to use.
    Grupo de recursosResource Group myResourceGroupmyResourceGroup Puede crear un grupo de recursos o elegir uno existente.You can create a new resource group or choose from an existing one.
    UbicaciónLocation Ubicación predeterminadaThe default location Seleccione la ubicación geográfica del grupo de recursos.Select the geographic location for your resource group. Puede elegir cualquier ubicación de la lista, aunque a menudo es mejor elegir la más cercana al cliente.Your location choice can be any location listed, though it's often best to choose a location closest to your customer. No se puede cambiar la ubicación una vez creado el bot.The location cannot be changed once the bot is created.
    Plan de tarifaPricing tier F0F0 Seleccione un plan de tarifa.Select a pricing tier. Puede actualizar el plan de tarifa en cualquier momento.You may update the pricing tier at any time. Para más información, consulte Precios de Azure Bot Service.For more information, see Bot Service pricing.
    Nombre de la aplicaciónApp name Un nombre únicoA unique name Nombre único de la dirección URL del bot.The unique URL name of the bot. Por ejemplo, si el nombre del bot es myawesomebot, la dirección URL del bot será http://myawesomebot.azurewebsites.net.For example, if you name your bot myawesomebot, then your bot's URL will be http://myawesomebot.azurewebsites.net. El nombre solo debe usar caracteres alfanuméricos y de subrayado.The name must use alphanumeric and underscore characters only. Hay un límite de 35 caracteres para este campo.There is a 35 character limit to this field. No se puede cambiar el nombre de la aplicación una vez creado el bot.The App name cannot be changed once the bot is created.
    Plantilla de botBot template Bot de ecoEcho bot Elija SDK v4.Choose SDK v4. Seleccione C# o Node.js para esta guía de inicio rápido y, a continuación, haga clic en Seleccionar.Select either C# or Node.js for this quickstart, then click Select.
    Plan de App Service/UbicaciónApp service plan/Location Su plan de App ServiceYour app service plan Seleccione una ubicación para el plan de App Service.Select an app service plan location. Su elección de ubicación puede ser cualquier ubicación de la lista, aunque con frecuencia es mejor elegir la misma ubicación que la del servicio de bot.Your location choice can be any location listed, though it's often best to choose the same location as the bot service.
    Cuentas de LUIS Solo disponible para la plantilla de bot básicoLUIS Accounts Only available for Basic Bot template Nombre de recurso de Azure de LUISLUIS Azure Resource Name Después de migrar los recursos de LUIS a un recurso de Azure, escriba el nombre del recurso de Azure para asociar esta aplicación LUIS a ese recurso de Azure.After migrating LUIS Resources over to an Azure Resource, input the Azure Resource name to associate this LUIS Application with that Azure Resource.
    Application InsightsApplication Insights PorOn Decida si quiere Activar o DesactivarApplication Insights.Decide if you want to turn Application Insights On or Off. Si selecciona Activar, también debe especificar una ubicación regional.If you select On, you must also specify a regional location. Su elección de ubicación puede ser cualquier ubicación de la lista, aunque con frecuencia es mejor elegir la misma ubicación que la del servicio de bot.Your location choice can be any location listed, though it's often best to choose the same location as the bot service.
    Id. y contraseña de aplicación de MicrosoftMicrosoft App ID and password Creación automática del id. y contraseña de la aplicaciónAuto create App ID and password Use esta opción si tiene que escribir manualmente un id. y contraseña de aplicación de Microsoft.Use this option if you need to manually enter a Microsoft App ID and password. En caso contrario, se crearán automáticamente un id. y contraseña nuevos de aplicación de Microsoft en el proceso de creación del bot.Otherwise, a new Microsoft App ID and password will be created for you in the bot creation process. Al crear manualmente un registro de aplicaciones para el servicio bot, asegúrese de que los tipos de cuenta admitidos estén establecidos en cuentas de cualquier directorio de la organización o en las cuentas personales de Microsoft (por ejemplo, Outlook.com, Xbox, etc.).When creating an app registration manually for the Bot Service, please ensure that the supported account types is set to Accounts in any organizational directory or Accounts in any organizational directory and personal Microsoft accounts (e.g. Outlook.com, Xbox, etc.)
  6. Haga clic en Crear para crear el servicio e implementar el bot en la nube.Click Create to create the service and deploy the bot to the cloud. Este proceso puede tardar varios minutos.This process may take several minutes.

    Para confirmar que el bot se ha implementado, active las Notificaciones.Confirm that the bot has been deployed by checking the Notifications. Las notificaciones cambiarán de Implementación en curso... a Implementación correcta.The notifications will change from Deployment in progress... to Deployment succeeded. Haga clic en ir al vínculo de recursos para abrir la página de recursos del bot.Click Go to resource link to open the bot's resources page.

Una vez ha creado el bot, pruébelo en Chat en web.Now that your bot is created, test it in Web Chat.

Probar el botTest the bot

En la sección configuración , haga clic en probar en chat web.In the Settings section, click Test in Web Chat. Azure Bot Service cargará el control Chat en web y se conectará al bot.Azure Bot Service will load the Web Chat control and connect to your bot.

El bot en Azure en el chat Web.

Escriba un mensaje y el bot debería responder.Enter a message and your bot should respond.

Descarga de códigoDownload code

El código se puede descargar para trabajar en el localmente.You can download the code to work on it locally.

  1. Vaya a la hoja de información general .Go to the Overview blade.

  2. Seleccione Descargar código fuente de bot en la barra de herramientas superior o en la parte inferior del panel.Select Download bot source code in the top toolbar or at the bottom of the pane.

  3. Siga las indicaciones para descargar el código y, después, descomprima la carpeta.Follow the prompts to download the code, and then unzip the folder.

    Al descargar el bot, se le ofrecerá la opción de incluir la configuración (que contiene las claves y secretos) del bot en la descarga, lo que puede ser necesario para que el bot funcione.When downloading your bot, you will be given the option to include the settings (containing the keys and secrets) for your bot in your download, which may be necessary for your bot to work. Si elige , el archivo appsettings.json o .env tendrá las claves.If you choose Yes, the appsettings.json or .env file will have the keys.

Vínculos en el panel de información general para descargar el código fuente de bot.

Información adicionalAdditional information

Registro de aplicación manualManual app registration

Es posible que necesite un registro manual cuando:You might need a manual registration when:

  • No puede realizar registros en su organización y necesita otra entidad para crear el identificador de aplicación para el bot que está compilando.You are unable to make the registrations in your organization and need another party to create the App ID for the bot you're building.
  • Deberá crear manualmente su propio identificador de aplicación (y contraseña).You need to manually create your own app ID (and password).

Consulte Preguntas más frecuentes sobre el registro de aplicación.See FAQ - App Registration.

Pasos siguientesNext steps

Después de descargar el código, puede continuar desarrollando el bot localmente en el equipo.After you download the code, you can continue to develop the bot locally on your machine. Una vez que pruebe el bot y esté listo para cargar el código de bot en el Azure Portal, siga las instrucciones que aparecen en configuración del tema de implementación de continuos para actualizar el código automáticamente después de realizar los cambios.Once you test your bot and are ready to upload the bot code to the Azure portal, follow the instructions listed under set up continuos deployment topic to automatically update code after you make changes.