Preguntas frecuentes sobre Bot Framework Azure

En este artículo se responde a las preguntas más habituales de Azure.

SE APLICA A: SDK v4

¿Cómo creo mi propio registro de aplicación?

Puede crear su propio Registro de aplicaciones cuando:

• Creó el bot en el portal de Bot Framework.
• El registro de aplicaciones se crea para un tercero que no tiene acceso a Azure.
• Deberá crear manualmente su propio identificador de aplicación (y contraseña).

Siga los pasos descritos aquí.

1. Inicie sesión en la cuenta de Azure. Si aún no tiene ninguna cuenta de Azure, puede registrarse para obtener una cuenta gratuita.

2. Vuelva al panel de registros de aplicaciones y haga clic en Nuevo registro en la barra de acciones de la parte superior.

   

3. Escriba un nombre para mostrar para el registro de aplicación en el campo Nombre y seleccione los tipos de cuenta compatibles.

   

4. Seleccione Registrar.

   Transcurridos unos instantes, el registro de aplicación recién creado debe abrir un panel. En el panel Información general, copie el id. de aplicación (cliente) y guárdelo. Lo necesitará para completar el campo Id. de aplicación relacionado durante la creación del bot, como se explica más adelante en este artículo.

   

Creación de un bot mediante Azure Portal

Si va a crear el bot en Azure Portal mediante el recurso Azure Bot, debe generar una clave secreta (secreto de cliente) para el registro de la aplicación.

1. Seleccione Certificados y secretos en la columna de navegación izquierda del panel del registro de la aplicación.

2. En ese panel, a la derecha, seleccione el botón Nuevo secreto de cliente. En el cuadro de diálogo emergente, escriba una descripción opcional para el secreto, seleccione la expiración del grupo de botones de radio Expiración.

   

3. Seleccione Agregar.

4. Copie el valor del secreto de la tabla en Secretos de cliente y guárdelo.

   

5. Durante el registro del bot, al crear el identificador de aplicación y la contraseña, escriba el identificador de aplicación y el secreto que guardó en los cuadros de entrada adecuados, tal como se muestra en la ilustración siguiente.

   Nota:

   El secreto solo estará visible mientras se encuentre en esta hoja y no podrá recuperarlo después de abandonar la página. Asegúrese de copiarlo en un lugar seguro.

   

Puede encontrar un ejemplo de cómo aplicar los pasos anteriores en Adición de autenticación a un bot.

¿Qué archivos necesito comprimir para la implementación?

Debe crear manualmente un archivo ZIP con todos los archivos del proyecto, como se describe en el paso: comprima manualmente el directorio de código. Asegúrese de seleccionar todos los archivos y carpetas de la carpeta del proyecto del bot. A continuación, mientras sigue en la carpeta del proyecto, comprima todos los archivos y carpetas seleccionados, como se muestra en la imagen siguiente.

¿Qué versión de la CLI de Azure debo usar para implementar un bot?

Use la versión más reciente de la Interfaz de la línea de comandos de Azure (CLI) de lo contrario, obtendrá errores de comandos en desuso. Consulte Instalación de la CLI de Azure.

¿Qué debo hacer al obtener errores de desuso de la CLI de Azure?

Actualice a la última versión de la CLI de Azure. En el caso de la versión 2.2.0 o posterior de la CLI de Azure, debe usar az deployment sub create y az deployment group create en lugar de los comandos az deployment create y az group deployment create respectivamente.

Registro de cambios de los comandos de la CLI de Azure que se usan para implementar un bot en Azure

Versión de CLI de Azure	Comando1	Comando 2
CLI de Azure, versión 2.2.0 o posterior	az deployment group create	az deployment sub create
CLI de Azure, versión 2.1.0 o posterior	az group deployment create	az deployment create

Para más información, consulte registro de cambios de CLI de Azure.

¿Cuáles son los comandos en desuso de la CLI relacionados con "iaz deployment"?

Los comandos en desuso az deployment utilizados son los siguientes:

En desuso	Sustituido por
az deployment <create/list show/delete/validate/export/cancel>	az deployment **sub** <create/list/show/delete/validate/export/cancel>
az deployment operation <list/show>	az deployment operation **sub** <list/show>
az group deployment <create/list/show/delete/validate/export/cancel>	az deployment **group** <create/list/show/delete/validate/export/cancel>
az group deployment operation <list/show>	az deployment operation **group** < list/show>

¿Cómo saber si los comandos de la CLI de Azure están en desuso?

Para saber si un comando de la CLI de Azure está en desuso, ejecute el comando con la opción -h (ayuda) como se muestra en la imagen siguiente.

Registro de cambios de la CLI de Azure

Obtenga más información sobre el registro de cambios de la CLI de Azure.

Azure Resource Manager (ARM)

A continuación se muestra una lista consolidada de los comandos que se ajustan al diseño actual de la CLI de Azure: az {command group} {?sub-command-group} {operation} {parameters}.

• az resource: mejora los ejemplos del módulo de recursos.
• az policy assignment list: permite enumerar las asignaciones de directivas en el ámbito del grupo de administración.
• Se han agregado az deployment group y az deployment operation group para la implementación de plantilla en grupos de recursos. Es un duplicado de az group deployment y az group deployment operation.
• Se han agregado az deployment sub y az deployment operation sub para la implementación de plantilla en el ámbito de la suscripción. Es un duplicado de az deployment y az deployment operation.
• Se han agregado az deployment mg y az deployment operation mg para la implementación de plantilla en grupos de administración.
• Se han agregado ad deployment tenant y az deployment operation tenant para la implementación de plantilla en el ámbito del inquilino.
• az policy assignment create: se ha agregado una descripción al parámetro --location.
• az group deployment create: se ha agregado el parámetro --aux-tenants para admitir varios inquilinos.

¿Qué es el recurso de Azure Bot?

El recurso de Azure Bot es una actualización del bot de aplicación web o del registro de canales de bot, lo que facilita a los desarrolladores empezar a usar la herramienta de desarrollo de bots de Bot Framework Composer. En lugar de crear recursos como una aplicación web durante la creación del bot, los recursos se crean mediante Bot Framework Composer, lo que ofrece más flexibilidad sobre los recursos que se implementan. Composer proporciona un lienzo de diseño visual que facilita el desarrollo de bots.

¿Por qué está en desuso el bot de aplicación web y el registro de canal de bot?

Funcionalmente, Azure Bot, Web App Bot y Registro de canales de bot usan Bot Service de la misma manera "en segundo plano". La ruta de acceso del bot de Azure es más fácil y más configurable para los desarrolladores. Los elementos heredados se quitan de Azure Marketplace, aunque los recursos existentes seguirán ejecutándose y serán compatibles.

¿Mi bot de aplicación web o el registro del canal del bot seguirán funcionando y durante cuánto tiempo?

Sí, el Bot de aplicación web o el recurso basado en el registro del canal de bot seguirán ejecutándose. No hay planes para quitar la compatibilidad con los recursos de bot existentes.

¿Es necesario migrar mi bot existente a Azure Bot?

No, no es necesario migrar el bot existente; seguirá ejecutándose tal como está.

¿Puedo migrar mi recurso de bot existente a un bot de Azure?

No, esto no se admite actualmente. Si el bot no se usa en producción, puede eliminar el recurso de bot antiguo y reutilizar el nombre del bot y el identificador de la aplicación en un nuevo recurso de bot (después de un tiempo para que el registro anterior se elimine). El nuevo bot de Azure está diseñado para crear el bot mediante Composer, por lo que las ganancias de dicha migración serían mínimas.

¿Cuál es la diferencia entre Azure Bot y el Registro de canales de Bot o Bot de aplicación web?

Bot Service detrás de Azure Bot y el Registro de canales de bot/Bot de aplicación web es lo mismo; el cambio se muestra en cómo se crean los recursos que se usan en el bot, como las aplicaciones web, reconocimiento del lenguaje, etc. En lugar del tamaño único que se ajusta a todas las plantillas que usó el Bot de aplicación web, Bot Framework Composer se puede usar para crear recursos para el bot con mucha más flexibilidad que las plantillas de bot de aplicación web permitidas. El Registro de canales de bot y Azure Bot son básicamente las mismas funcionalidades cuyo nombre ha cambiado. La experiencia de usuario es ligeramente diferente en Azure Portal para ayudar a los clientes a conectarse a Bot Framework Composer.

En este artículo se responde a las preguntas más habituales de Azure.

SE APLICA A: SDK v4

Puede crear su propio Registro de aplicaciones cuando:

• Creó el bot en el portal de Bot Framework.
• El registro de aplicaciones se crea para un tercero que no tiene acceso a Azure.
• Deberá crear manualmente su propio identificador de aplicación (y contraseña).

Siga los pasos descritos aquí.

1. Inicie sesión en la cuenta de Azure. Si aún no tiene ninguna cuenta de Azure, puede registrarse para obtener una cuenta gratuita.

2. Vuelva al panel de registros de aplicaciones y haga clic en Nuevo registro en la barra de acciones de la parte superior.

   

3. Escriba un nombre para mostrar para el registro de aplicación en el campo Nombre y seleccione los tipos de cuenta compatibles.

   

4. Seleccione Registrar.

   Transcurridos unos instantes, el registro de aplicación recién creado debe abrir un panel. En el panel Información general, copie el id. de aplicación (cliente) y guárdelo. Lo necesitará para completar el campo Id. de aplicación relacionado durante la creación del bot, como se explica más adelante en este artículo.

   

Creación de un bot mediante Azure Portal

Si va a crear el bot en Azure Portal mediante el recurso Azure Bot, debe generar una clave secreta (secreto de cliente) para el registro de la aplicación.

1. Seleccione Certificados y secretos en la columna de navegación izquierda del panel del registro de la aplicación.

2. En ese panel, a la derecha, seleccione el botón Nuevo secreto de cliente. En el cuadro de diálogo emergente, escriba una descripción opcional para el secreto, seleccione la expiración del grupo de botones de radio Expiración.

   

3. Seleccione Agregar.

4. Copie el valor del secreto de la tabla en Secretos de cliente y guárdelo.

   

5. Durante el registro del bot, al crear el identificador de aplicación y la contraseña, escriba el identificador de aplicación y el secreto que guardó en los cuadros de entrada adecuados, tal como se muestra en la ilustración siguiente.

   Nota:

   El secreto solo estará visible mientras se encuentre en esta hoja y no podrá recuperarlo después de abandonar la página. Asegúrese de copiarlo en un lugar seguro.

   

Puede encontrar un ejemplo de cómo aplicar los pasos anteriores en Adición de autenticación a un bot.

Debe crear manualmente un archivo ZIP con todos los archivos del proyecto, como se describe en el paso: comprima manualmente el directorio de código. Asegúrese de seleccionar todos los archivos y carpetas de la carpeta del proyecto del bot. A continuación, mientras sigue en la carpeta del proyecto, comprima todos los archivos y carpetas seleccionados, como se muestra en la imagen siguiente.

Use la versión más reciente de la Interfaz de la línea de comandos de Azure (CLI) de lo contrario, obtendrá errores de comandos en desuso. Consulte Instalación de la CLI de Azure.

Actualice a la última versión de la CLI de Azure. En el caso de la versión 2.2.0 o posterior de la CLI de Azure, debe usar az deployment sub create y az deployment group create en lugar de los comandos az deployment create y az group deployment create respectivamente.

Registro de cambios de los comandos de la CLI de Azure que se usan para implementar un bot en Azure

Versión de CLI de Azure	Comando1	Comando 2
CLI de Azure, versión 2.2.0 o posterior	az deployment group create	az deployment sub create
CLI de Azure, versión 2.1.0 o posterior	az group deployment create	az deployment create

Para más información, consulte registro de cambios de CLI de Azure.

Los comandos en desuso az deployment utilizados son los siguientes:

En desuso	Sustituido por
az deployment <create/list show/delete/validate/export/cancel>	az deployment **sub** <create/list/show/delete/validate/export/cancel>
az deployment operation <list/show>	az deployment operation **sub** <list/show>
az group deployment <create/list/show/delete/validate/export/cancel>	az deployment **group** <create/list/show/delete/validate/export/cancel>
az group deployment operation <list/show>	az deployment operation **group** < list/show>

Para saber si un comando de la CLI de Azure está en desuso, ejecute el comando con la opción -h (ayuda) como se muestra en la imagen siguiente.

Registro de cambios de la CLI de Azure

Obtenga más información sobre el registro de cambios de la CLI de Azure.

Azure Resource Manager (ARM)

A continuación se muestra una lista consolidada de los comandos que se ajustan al diseño actual de la CLI de Azure: az {command group} {?sub-command-group} {operation} {parameters}.

• az resource: mejora los ejemplos del módulo de recursos.
• az policy assignment list: permite enumerar las asignaciones de directivas en el ámbito del grupo de administración.
• Se han agregado az deployment group y az deployment operation group para la implementación de plantilla en grupos de recursos. Es un duplicado de az group deployment y az group deployment operation.
• Se han agregado az deployment sub y az deployment operation sub para la implementación de plantilla en el ámbito de la suscripción. Es un duplicado de az deployment y az deployment operation.
• Se han agregado az deployment mg y az deployment operation mg para la implementación de plantilla en grupos de administración.
• Se han agregado ad deployment tenant y az deployment operation tenant para la implementación de plantilla en el ámbito del inquilino.
• az policy assignment create: se ha agregado una descripción al parámetro --location.
• az group deployment create: se ha agregado el parámetro --aux-tenants para admitir varios inquilinos.

El recurso de Azure Bot es una actualización del bot de aplicación web o del registro de canales de bot, lo que facilita a los desarrolladores empezar a usar la herramienta de desarrollo de bots de Bot Framework Composer. En lugar de crear recursos como una aplicación web durante la creación del bot, los recursos se crean mediante Bot Framework Composer, lo que ofrece más flexibilidad sobre los recursos que se implementan. Composer proporciona un lienzo de diseño visual que facilita el desarrollo de bots.

Funcionalmente, Azure Bot, Web App Bot y Registro de canales de bot usan Bot Service de la misma manera "en segundo plano". La ruta de acceso del bot de Azure es más fácil y más configurable para los desarrolladores. Los elementos heredados se quitan de Azure Marketplace, aunque los recursos existentes seguirán ejecutándose y serán compatibles.

Sí, el Bot de aplicación web o el recurso basado en el registro del canal de bot seguirán ejecutándose. No hay planes para quitar la compatibilidad con los recursos de bot existentes.

No, no es necesario migrar el bot existente; seguirá ejecutándose tal como está.

No, esto no se admite actualmente. Si el bot no se usa en producción, puede eliminar el recurso de bot antiguo y reutilizar el nombre del bot y el identificador de la aplicación en un nuevo recurso de bot (después de un tiempo para que el registro anterior se elimine). El nuevo bot de Azure está diseñado para crear el bot mediante Composer, por lo que las ganancias de dicha migración serían mínimas.

Bot Service detrás de Azure Bot y el Registro de canales de bot/Bot de aplicación web es lo mismo; el cambio se muestra en cómo se crean los recursos que se usan en el bot, como las aplicaciones web, reconocimiento del lenguaje, etc. En lugar del tamaño único que se ajusta a todas las plantillas que usó el Bot de aplicación web, Bot Framework Composer se puede usar para crear recursos para el bot con mucha más flexibilidad que las plantillas de bot de aplicación web permitidas. El Registro de canales de bot y Azure Bot son básicamente las mismas funcionalidades cuyo nombre ha cambiado. La experiencia de usuario es ligeramente diferente en Azure Portal para ayudar a los clientes a conectarse a Bot Framework Composer.