Administración de recursos de botManage bot resources

se aplica a: SDK V4APPLIES TO: SDK v4

Los bots suelen usar servicios diferentes, como LUIS.ai o QnaMaker.ai.Bots usually consume different services, such as LUIS.ai or QnaMaker.ai. Cuando está desarrollando un bot, es preciso que pueda realizar un seguimiento de todos ellos.When you are developing a bot, you need to be able to keep track of them all. Puede usar diversos métodos como appsettings.json, web.config o .env.You can use various methods such as appsettings.json, web.config, or .env.

Importante

Antes de la versión Bot Framework SDK 4.3, se ofrecía el archivo .bot como un mecanismo para administrar los recursos.Prior to the Bot Framework SDK 4.3 release, we offered the .bot file as a mechanism to manage resources. Sin embargo, en adelante, se recomienda usar el archivo appsettings.json o .env para administrar estos recursos.However, going forward we recommend that you use appsettings.json or .env file for managing these resources. Los bots que utilicen el archivo .bot seguirán funcionando por ahora, aunque este archivo está en desuso .Bots that use .bot file will continue to work for now even though the .bot file has been deprecated. Si ha estado usando un archivo .bot para administrar recursos, siga los pasos aplicables para migrar la configuración.If you've been using a .bot file to manage resources, follow the steps that apply to migrate the settings.

Migración de la configuración a partir de un archivo .botMigrating settings from .bot file

Las siguientes secciones explican cómo migrar la configuración a partir del archivo .bot.The following sections cover how to migrate settings from the .bot file. Siga las instrucciones del escenario que sea aplicable en su caso.Follow the scenario that applies to you.

Escenario 1 : bot local que tiene un archivo .botScenario #1: Local bot that has a .bot file

En este escenario tiene un bot local que usa un archivo .bot, pero este no se ha migrado a Azure Portal.In this scenario you have a local bot that uses a .bot file, but the bot has not been migrated to the Azure portal. Siga los pasos siguientes para migrar la configuración del archivo .bot al archivo appsettings.json o .env.Follow the steps below to migrate settings from the .bot file to appsettings.json or .env file.

  • Si el archivo .bot está cifrado, deberá descifrarlo mediante el comando siguiente:If the .bot file is encrypted, you'll need to decrypt it using the following command:
msbot secret --bot <name-of-bot-file> --secret "<bot-file-secret>" --clear
  • Abra el archivo .bot descifrado, copie los valores y agréguelos al archivo appsettings.json o .env.Open the decrypted .bot file, copy the values and add them to the appsettings.json or .env file.
  • Actualice el código para que lea la configuración del archivo appsettings.json o .env.Update the code to read settings from appsettings.json or .env file.

En el método ConfigureServices, use el objeto de configuración que proporciona ASP.NET Core, por ejemplo:In the ConfigureServices method, use the configuration object that ASP.NET Core provides, for example:

Startup.csStartup.cs

var appId = Configuration.GetSection("MicrosoftAppId").Value;
var appPassword = Configuration.GetSection("MicrosoftAppPassword").Value;
options.CredentialProvider = new SimpleCredentialProvider(appId, appPassword);

Si es necesario, aprovisione recursos y conéctelos al bot mediante el archivo appsettings.json o .env.If needed, provision resources and connect them to your bot using the appsettings.json or .env file.

Escenario 2: Bot implementado en Azure con un archivo .botScenario #2: Bot deployed to Azure with a .bot file

En este escenario ya ha implementado un bot en Azure Portal mediante el archivo .bot y ahora desea migrar la configuración del archivo .bot al archivo appsettings.json o .env.In this scenario you have already deployed a bot to the Azure portal using the .bot file, and now you want to migrate settings from the .bot file to appsettings.json or .env file.

  • Descargue el código del bot de Azure Portal.Download the bot code from the Azure portal. Al descargar el código, se le pedirá que incluya el archivo appsettings.json o .env que contiene los valores de MicrosoftAppId y MicrosoftAppPassword y el resto de configuraciones adicionales.When you download the code, you'll be prompted to include appsettings.json or .env file that will have your MicrosoftAppId and MicrosoftAppPassword and any additional settings in it.
  • Abra el archivo appsettings.json o .env descargado y copie la configuración en el archivo appsettings.json o .env local.Open the downloaded appsettings.json or .env file, and copy the settings from it into your local appsettings.json or .env file. No olvide quitar las entradas botSecret y botFilePath del archivo appsettings.json o .env local.Don't forget to remove the botSecret and botFilePath entries from your local appsettings.json or .env file.
  • Actualice el código para que lea la configuración del archivo appsettings.json o .env.Update the code to read settings from appsettings.json or .env file.

En el método ConfigureServices, use el objeto de configuración que proporciona ASP.NET Core, por ejemplo:In the ConfigureServices method, use the configuration object that ASP.NET Core provides, for example:

Startup.csStartup.cs

var appId = Configuration.GetSection("MicrosoftAppId").Value;
var appPassword = Configuration.GetSection("MicrosoftAppPassword").Value;
options.CredentialProvider = new SimpleCredentialProvider(appId, appPassword);

También tendrá que quitar y de la sección botFilePath Configuración de la botFileSecret aplicación de la Azure Portal.You'll also need to remove the botFilePath and botFileSecret from the Application Settings section in the Azure portal.

Si es necesario, aprovisione recursos y conéctelos al bot mediante el archivo appsettings.json o .env.If needed, provision resources and connect them to your bot using the appsettings.json or .env file.

Escenario 3: bots que utilizan el archivo appsettings.json o .envScenario #3: For bots that use appsettings.json or .env file

En este escenario se aborda un caso en el que está empezando a desarrollar bots mediante SDK 4.3 desde cero y no dispone de ningún archivo .bot ya existente para migrar.This scenario covers the case in which you are starting to develop bots using SDK 4.3 from scratch and don't have existing .bot files to migrate. Todas las configuraciones que desea usar en su bot están en el archivo appsettings.json o .env como se muestra a continuación:All settings that you want to use in your bot are in the appsettings.json or .env file as shown below:

{
  "MicrosoftAppId": "<your-AppId>",
  "MicrosoftAppPassword": "<your-AppPwd>"
}

Para leer la configuración anterior en el código C#, usará el objeto de configuración que proporciona ASP .NET Core, por ejemplo: Startup.csTo read the above settings in your C# code, you'll use the configuration object that ASP.,NET Core provides for example: Startup.cs

var appId = Configuration.GetSection("MicrosoftAppId").Value;
var appPassword = Configuration.GetSection("MicrosoftAppPassword").Value;
options.CredentialProvider = new SimpleCredentialProvider(appId, appPassword);

Si es necesario, aprovisione recursos y conéctelos al bot mediante el archivo appsettings.json o .env.If needed, provision resources and connect them to your bot using the appsettings.json or .env file.

Recursos adicionalesAdditional resources

  • Para ver los pasos para implementar el bot, consulte el tema sobre implementación.For steps to deploy the bot, see deployment topic.
  • Aprenda a usar Azure Key Vault para proteger y administrar claves criptográficas y secretos usados por servicios y aplicaciones en la nube.Learn how to use Azure Key Vault to safeguard and manage cryptographic keys and secrets used by cloud applications and services.