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

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

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 el tema, podrá elegir entre plantilla .NET o Node.js para crear un bot mediante Bot Framework SDK v4.In the topic, you'll be able to choose either .NET or Node.js template to create a bot using the Bot Framework SDK v4.

Nota

El bot que cree se registrará automáticamente con Azure Bot Service.The bot you create is automatically registered with the Azure Bot Service. Si ya tiene un bot hospedado en otro lugar y desea registrarlo, consulte el artículo: Registro de un bot con Azure Bot Service.If you already have a bot hosted elsewhere and you want to register it, see the article: Register a bot with Azure Bot Service.

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 de Azure Portal y, a continuación, seleccione AI + Machine Learning > Web App Bot.Click Create new resource link found on the upper left-hand corner of the Azure portal, then select AI + Machine Learning > Web App bot.

crear bot

  1. Se abrirá una nueva hoja con información sobre Web App Bot.A new blade will open with information about the Web App Bot.

  2. En la hoja Bot Service, indique la información solicitada sobre el bot según se especifica en la tabla debajo de la imagen.In the Bot Service blade, 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)Create Web App Bot blade

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 un registro de aplicación manualmente para Bot Service, asegúrese de que los tipos de cuenta compatibles se han establecido en "Cuentas de cualquier directorio organizativo" o "Cuentas de cualquier directorio organizativo y cuentas Microsoft personales (por ejemplo, Xbox o Outlook.com)".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.)’
  1. 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 el botón Ir al recurso para abrir la hoja de recursos del bot.Click Go to resource button to open the bot's resources blade.

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 Administración del bot, haga clic en Probar en Chat en web.In the Bot Management 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.

Prueba del Chat en web de Azure

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

Registro de aplicación manualManual app registration

Un registro manual es necesario en situaciones como:A manual registration is necessary for situations like:

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

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. En la sección Bot Management (Administración de bots), haga clic en Build (Compilar).In the Bot Management section, click Build.
  2. Haga clic en el vínculo Download Bot source code (Descargar código fuente del bot) del panel derecho.Click on Download Bot source code link in the right-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.
    1. 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.

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 su bot y esté listo para cargar el código del bot en Azure Portal, siga las instrucciones del tema Configuración de la implementación continua para actualizar automáticamente el código después de realizar 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 continous deployment topic to automatically update code after you make changes.