Uso de un bot de chat clásico como aptitud en un bot de Bot Service

Cuando se usa un bot de chat clásico como aptitud con un bot de Bot Service, el bot de Bot Service determina si algo dice el usuario coincide con las frases de desencadenador del bot de chat clásico. Si hay una coincidencia, el bot de Bot Service puede pasar la conversación al bot de chat clásico. El bot clásico extrae cualquier entidad y desencadena el tema coincidente.

Para configurar su bot clásico como capacidad:

1. Agregue el bot de Bot Service a la lista de permitidos del bot de chat clásico.

2. Descargue el manifiesto de capacidad para el bot clásico.

3. Conéctese a una aptitud de Copilot Studio desde el bot.

4. Confirme que el bot funciona como una aptitud.

Requisitos previos

• Comprender cómo funcionan las aptitudes de Bot Service.
• Obtenga el identificador de aplicación del bot de Bot Service.

Adición del bot de Bot Service a la lista de permitidos para el bot de chat clásico

Agregue el identificador de aplicación del bot de Bot Service a la lista de permitidos del bot de chat clásico que quiere usar como aptitud. Los bots deben estar en el mismo inquilino.

1. Obtenga el identificador de aplicación de Microsoft para el bot de Bot Services. Puede encontrar esta información en Azure Portal o en las configuraciones del bot.

2. En Copilot Studio, abra el bot que quiera usar como capacidad.

3. En el menú de navegación, vaya a Configuración y seleccione Seguridad. Luego seleccione Lista de permitidos.

4. Seleccione Agregar autor de llamada permitido.

5. Pegue el identificador de aplicación del bot de Bot Service y seleccione Siguiente.

   Precaución

   Un bot de chat clásico no puede actuar como una capacidad para otros bots de chat clásicos. Si intenta agregar un id. de la aplicación que pertenece a un bot de Power Virtual Agent a la lista de permitidos, obtendrá un error. Solo puede agregar un identificador de aplicación para un bot de bot.

   Copilot Studio valida el identificador de aplicación del bot de Bot Service y confirma que pertenece a un bot en el mismo inquilino.

6. (Opcional) Agregue un Nombre para mostrar para el bot que ha agregado a la lista de permitidos.

7. Seleccione Guardar.

El bot de Bot Service aparece por su nombre para mostrar si especificó uno o por su identificador de aplicación si no especificó un nombre para mostrar. Para eliminarlo o editarlo en cualquier momento, seleccione el ícono a la derecha del nombre para mostrar o el id. de la aplicación.

Descargue el manifiesto de capacidad para su bot de chat clásico

Los bots de Bot Service pueden usar un manifiesto de aptitud de Copilot Studio para configurar una conexión al bot de chat clásico que generó el manifiesto.

Todos los bots de chat clásicos tienen manifiestos de capacidad. Un manifiesto de capacidad es un archivo JSON que incluye el nombre, la interfaz y las frases desencadenadoras.

Un bot de Bot Service puede usar un manifiesto de aptitud para saber cuándo desencadenar el bot de chat clásico (por ejemplo, en respuesta a algo que un usuario le dice).

Los manifiestos de aptitud de Copilot Studio siguen la versión 2.2 del esquema del manifiesto de aptitud de Bot Service y constan de archivos intents.lu y manifest.json .

Un bot de Bot Service puede decidir que un bot de chat clásico debe controlar la solicitud del usuario, en función de los datos del manifiesto. Pasa todo lo que el usuario dijo al bot de chat clásico. Entonces el bot clásico hace coincidir lo que el usuario ha dicho con un tema de Copilot Studio, extrae las entidades necesarias para el llenado de espacios y desencadena el tema de Copilot Studio.

Los manifiestos de capacidades de Copilot Studio se generan y actualizan automáticamente. Un bot clásico tiene dos manifiestos de capacidad:

• Manifiesto de prueba: permite que el bot de Bot Service se conecte a la versión de prueba del bot de chat clásico. Use el manifiesto de prueba para validar los cambios en su capacidad antes de publicarlo.

  • El manifiesto de prueba está disponible de inmediato para cada nuevo bot clásico creado.
  • Se actualiza automáticamente para reflejar los cambios cada vez que guarda su bot de chat clásico.

• Manifiesto publicado: permite que el bot de Bot Service se conecte a la versión publicada del bot de chat clásico.

  • El manifiesto publicado solo está disponible para bots de chat clásicos que se han publicado al menos una vez.
  • Se actualiza automáticamente para reflejar los cambios cada vez que publica su agente.

Ambos manifiestos de capacidades se muestran en el panel Administrar lista de permitidos.

Los manifiestos de habilidades también se muestran en la página de Detalles del chatbot. En el menú de navegación, seleccione Configuración y, a continuación, seleccione Detalles. La pestaña Detalles muestra otros metadatos, como Id. de entorno, Id. de inquilino e Id. de aplicación de bot.

Para descargar un manifiesto, selecciónelo. Se descarga como archivo .zip etiquetado <bot name>manifest para el manifiesto publicado o <bot name>test__manifest para el manifiesto de prueba.

Conexión a una aptitud de Copilot Studio desde el bot

Puede usar la información del manifiesto de aptitud de Copilot Studio para crear una conexión de aptitud en el bot de Bot Service.

Para obtener más información sobre la estructura del manifiesto de aptitud, consulte Manifiesto de aptitudes.

La sección de actividades del manifiesto de aptitud contiene los temas disponibles en el bot de chat clásico.

Puede implementar un consumidor de aptitudes en el bot de Bot Service para llamar a un bot de chat clásico como aptitud.

Prueba del bot de chat clásico como una aptitud con un bot de Bot Service

Puede bot Service Emulator para probar que el bot de Bot Service llama correctamente a un bot de chat clásico como aptitud.

Actualización de un bot de Bot Service multiinquilino a un bot de un solo inquilino

En la ilustración siguiente se muestra el escenario en el que un bot de Bot Service llama a un bot de chat clásico para usarlo como aptitud.

Tanto el bot de Bot Service como el bot clásico tienen un registro de aplicación de Id. de Microsoft Entra, al que hacen referencia las instancias de Azure Bot. Estos registros de aplicaciones de Microsoft Entra se crearon como multiinquilino. El bot de Bot Service solicita un token del inquilino de Bot Service y usa este token para autenticarse en Copilot Studio mediante Azure Bot Service. Copilot Studio usa el mismo mecanismo para ponerse en contacto con el bot de Bot Service.

El registro de la aplicación de chatbot de Copilot Studio ahora se crea como un inquilino único, por lo que esta comunicación ya no funciona. Microsoft Entra ID se niega a crear tokens para registros de aplicaciones de un solo inquilino que no están en el mismo inquilino.

Además, Copilot Studio valida el token entrante y rechaza las solicitudes de inquilinos que no espera, como el identificador de inquilino en el que se creó el registro de la aplicación del bot de chat clásico.

Para resolver este problema, hay dos posibles soluciones.

Bots de chat clásicos en el mismo inquilino que bot de Bot Service

En escenarios en los que el bot de chat de Copilot Studio ya está implementado en el mismo inquilino que el bot de Bot Service y solo lo usa este bot, actualice el bot a una configuración de un solo inquilino y vuelva a implementar el bot de Bot Service. Para más información sobre cómo configurar un bot de Bot Service para un solo inquilino, consulte Aprovisionamiento y publicación de un bot.

Bot de chat de Copilot Studio que no se puede actualizar a inquilino único

En escenarios en los que el bot de chat de Copilot Studio ya está implementado en el mismo inquilino que el bot de Bot Service, pero el bot no se puede actualizar tan solo el inquilino, debe actualizar el código del bot de Bot Service para crear el token para comunicarse con el bot de Copilot Studio. El token debe crearse para el inquilino en el que también se creó el bot de chat Copilot Studio. Además, se debe aceptar la respuesta, lo que probablemente requiera que siga los pasos descritos en Convertir una habilidad existente de multiinquilino a inquilino único.

Más información

• Resumen de capacidades
• Manifiesto de capacidad
• Probar una capacidad en el emulador