Registro de un bot con Azure

  • Artículo

SE APLICA A: SDK v4

Si actualmente no alojas el bot en Azure, puedes hacerlo disponible en Azure y usar Azure para conectar el bot a canales. Para ello, escribe en Azure la dirección web donde se aloja el bot.

En este artículo se muestra cómo registrar este bot con el servicio de Bot de Azure AI.

Importante

Solo deberás registrar un bot si no está alojado en Azure. Los bots creados con la CLI de Azure ya están registrados con el servicio de Bot de Azure AI.

La identidad del bot se puede administrar de varias maneras diferentes en Azure.

  • Como identidad administrada asignada por el usuario, por lo que no es necesario administrar las credenciales del bot usted mismo.
  • Como una aplicación de un inquilino único.
  • Como una aplicación multiinquilino.

La compatibilidad con la identidad administrada asignada por el usuario y los tipos de aplicación de inquilino único se agregó al SDK de Bot Framework para C# y JavaScript en la versión 4.15.0. Estos tipos de aplicaciones no se admiten en los otros lenguajes o en Bot Framework Composer, Bot Framework Emulator o ngrok.

Tipo de aplicación Soporte técnico
Identidad administrada asignada por el usuario Azure AI Bot Service y los SDK de C# y JavaScript
Inquilino único Servicio de Bot de Azure AI y los SDK de C# y JavaScript
Multiinquilino Servicio de Bot de Azure AI, todos los lenguajes del SDK de Bot Framework, Composer, el emulador y ngrok

En este artículo no se describe cómo crear o implementar el bot para registrarse. Para más información, vea:

Crear el recurso

Crea el recurso de Azure Bot, que te permitirá registrar el bot con Servicio de Bot de Azure AI.

Sugerencia

No se pueden crear nuevos recursos de bot de aplicación web y registro de canales de bot; sin embargo, los recursos existentes configurados e implementados seguirán funcionando. Los bots creados a partir de una plantilla VSIX o Yeoman a partir de la versión 4.14.1.2 del SDK o posterior contienen plantillas de ARM que generarán un recurso de Azure Bot.

  1. Vaya a Azure Portal.

  2. En el panel derecho, selecciona Crear un recurso.

  3. Escribe bot en el cuadro de búsqueda y, luego, presiona Entrar.

  4. Selecciona la tarjeta Azure Bot.

    Select Azure bot resource

  5. Seleccione Crear.

  6. Escribe los valores en los campos obligatorios y revisa y actualiza la configuración.

    1. Proporciona información en Detalles del proyecto. Selecciona si el bot tendrá residencia de datos global o local. Actualmente, la característica de residencia de datos local está disponible para los recursos de la región "westeurope" y "centralindia". Para obtener más información, consulta Regionalización en Servicio de Bot de Azure AI.

      The project details settings for an Azure Bot resource

    2. Proporciona información en identificador de aplicación de Microsoft. Selecciona cómo se administrará la identidad del bot en Azure y si deseas crear una nueva identidad o usar una existente.

      The Microsoft app ID settings for an Azure Bot resource

  7. Seleccione Revisar + crear.

  8. Si se superan las pruebas de validación, selecciona Crear.

  9. Cuando finalice la implementación, seleccione Ir al recurso. Deberías ver el bot y los recursos relacionados que aparecen en el grupo de recursos que seleccionaste.

  10. Si aún no tienes el SDK Bot Framework, selecciona Descargar en GitHub para obtener información sobre cómo consumir los paquetes para tu idioma preferido.

    Create bot in SDK

Ya estás listo para compilar el bot con Bot Framework SDK.

Sugerencia

Cuando Azure crea un nuevo recurso de Azure Bot de inquilino único o multiinquilino con un nuevo identificador de aplicación, también genera una contraseña.

Información de identidad del bot

Sigue estos pasos para agregar información de identidad al archivo de configuración del bot. El archivo difiere en función del lenguaje de programación que utilizas para crear el bot.

Importante

Las versiones de Java y Python del SDK de Bot Framework solo admiten bots multiinquilino. Las versiones de C# y JavaScript admiten los tres tipos de aplicación para administrar la identidad del bot.

Lenguaje Nombre de archivo Notas
C# appsettings.json Admite los tres tipos de aplicación para administrar la identidad del bot.
JavaScript .env Admite los tres tipos de aplicación para administrar la identidad del bot.
Java application.properties Solo admite bots multiinquilino.
Python config.py Solo admite bots multiinquilino. Proporcione las propiedades de identidad como argumentos a las llamadas del método os.environ.get.

La información de identidad que necesitas agregar depende del tipo de aplicación del bot. Proporciona los siguientes valores en el archivo de configuración.

Disponible solo para bots de JavaScript y C#.

Propiedad Valor
MicrosoftAppType UserAssignedMSI
MicrosoftAppId Id. de cliente de la identidad administrada asignada por el usuario.
MicrosoftAppPassword No aplicable. Deja esto en blanco para un bot de identidad administrada asignada por el usuario.
MicrosoftAppTenantId El id. de inquilino de la identidad administrada asignada por el usuario.

Para actualizar el servicio de aplicaciones

Si tienes un recurso de App Service (aplicación web) existente para el bot y el bot es una aplicación de identidad administrada asignada por el usuario, es posible que tengas que actualizar el servicio de aplicaciones del bot:

  1. Ve a la hoja de App Service de la aplicación web del bot.
  2. En Configuración, seleccione Identidad.
  3. En la hoja Identidad, selecciona Asignación de usuario yAgregar (+).
  4. En la hoja identidad administrada asignada por el usuario:

    1. Seleccione su suscripción.

    2. En Identidades administradas asignadas por el usuario, selecciona la identidad administrada del bot. Si la identidad administrada se generó automáticamente, tendrá el mismo nombre que el bot.

    3. Selecciona Agregar para usar esta identidad para el bot.

      The App Service Identity blade with the managed identity for the bot selected.

Para obtener la aplicación o el identificador de inquilino

Para obtener la aplicación o el identificador de inquilino del bot:

  1. Ve a la hoja de recursos del bot de Azure para el bot.
  2. Ve a la hoja Configuración del bot. En esta hoja, puedes copiar el identificador de aplicación de Microsoft del bot o el identificador de inquilino de la aplicación.

Generación de una nueva contraseña

Los bots de inquilino único y multiinquilino tienen un secreto de aplicación o una contraseña que necesitas para algunas operaciones. Azure AI Bot Service oculta el secreto del bot. Sin embargo, el propietario del recurso de App Service del bot puede generar una nueva contraseña:

  1. Ve a la hoja de recursos del bot de Azure para el bot.
  2. Ve a la hoja Configuración del bot.
  3. Selecciona Administrar, junto a identificador de aplicación de Microsoft, para ir a la hoja Certificados y secretos del servicio de aplicaciones.
  4. Sigue las instrucciones de la hoja para crear un nuevo secreto de cliente y registrar el valor en un lugar seguro.

Registro de aplicación manual

Se necesita un registro manual cuando:

  • No puedes realizar registros en tu organización y necesitas otra entidad para crear el identificador de aplicación para el bot que estás compilando.
  • Deberás crear manualmente tu propio identificador de aplicación y contraseña.

Actualización del bot

Para actualizar el archivo de configuración del bot para incluir tu identificador de aplicación y contraseña, consulta Id. de aplicación y contraseña en cómo Configurar las opciones de registro del bot.

Información adicional

Consulta estos artículos para más información sobre las aplicaciones de Azure en general.

Asunto Artículo
Registro de aplicación Inicio rápido: Registro de una aplicación en la plataforma de identidad de Microsoft
Identidades administradas ¿Qué son las identidades administradas de recursos de Azure?
Aplicaciones de un solo inquilino y aplicaciones multiinquilino Inquilinos en Microsoft Entra ID

Pasos siguientes

Administración de un bot