Configuración del registro del bot
SE APLICA A: SDK v4
La configuración de recursos de Azure Bot, como el nombre para mostrar, el icono y la descripción, se pueden ver y modificar en el panel Perfil de bot. La configuración de recursos de Azure Bot, como el punto de conexión de mensajería, el identificador de aplicación de Microsoft y Application Insights, se pueden ver y modificar en el panel Configuración.
Perfil del bot
A continuación, se muestra la lista de campos de Perfil de bot:
| Campo | Descripción |
|---|---|
| Icon | Un icono personalizado para identificar visualmente el bot en canales y como icono de tu bot en Microsoft Teams y otros servicios. |
| Nombre para mostrar | El nombre de su bot en los canales y directorios. Puedes cambiar este valor más adelante. |
| Bot handle (Identificador de bot) | Un identificador único del bot. No se puede cambiar este valor después de crear tu bot con el servicio de bot. |
| Descripción | Una descripción del bot. Algunos canales muestran la descripción. Puedes cambiar este valor más adelante. |
Para guardar los cambios, selecciona Aplicar en la parte inferior de la hoja.
Configuración
A continuación se muestra la lista de los campos Configuración:
| Campo | Descripción |
|---|---|
| Messaging endpoint (Punto de conexión de mensajería) | El punto de conexión para comunicarse con el bot. |
| Microsoft App ID (Id. de aplicación de Microsoft) | Identificador único del bot. Este valor no se puede cambiar. Para generar una nueva contraseña, haga clic en el vínculo Administrar. |
| Versión de transformación de esquema | Versión de transformación del esquema del bot que se va a usar para este bot. Para obtener más información, consulta Conectar un bot a los canales. |
| Application Insights Instrumentation key (Clave de instrumentación de Application Insights) | Clave única para la telemetría del bot. Copie la clave de Azure Application Insights en este campo si desea recibir telemetría del bot para este bot. Este valor es opcional. Para obtener más detalles sobre este campo, consulte Claves de App Insights. |
| Clave de API de Application Insights | Clave única para el análisis del bot. Copie la clave de API de Azure Application Insights en este campo si desea ver el análisis sobre su bot en el panel. Este valor es opcional. Para obtener más detalles sobre este campo, consulte Claves de App Insights. |
| Application Insights Application ID (Id. de aplicación de Application Insights) | Id. exclusivo para el análisis del bot. Copie la clave de id. de Azure Application Insights en este campo si desea ver el análisis sobre su bot en el panel. Este valor es opcional. Para obtener más detalles sobre este campo, consulte Claves de App Insights. |
Para guardar los cambios, selecciona Aplicar en la parte inferior de la hoja.
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
La versión de Java del SDK de Bot Framework solo admite bots multiinquilino. La versión de Python del SDK de Bot Framework admite bots multiinquilino y de inquilino único. 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 | Admite bots multiinquilino y de un solo inquilino. Proporcione las propiedades como argumentos a las llamadas de os.environ.get método. |
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. |
Información adicional
Puede usar az bot update para actualizar la configuración del bot desde la línea de comandos.