Registro de un bot con Azure

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.

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.

Se ha agregado compatibilidad con la identidad administrada asignada por el usuario y los tipos de aplicación de inquilino único al SDK de Bot Framework para C#, JavaScript y Python. Estos tipos de aplicaciones no se admiten en los otros lenguajes o en Bot Framework Composer, Bot Framework Emulator o Túneles de desarrollo.

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

• El inicio rápido de Creación de un bot
• Tutorial de implementación de un bot básico

Crear el recurso

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

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.

   

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.

      

   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.

      

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.

    

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

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.

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.

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.

      

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.

Pasos siguientes