Compartir a través de

Información general sobre Bot Framework Composer

  • Artículo

Importante

Las capacidades y características de Power Virtual Agents son ahora parte de Microsoft Copilot Studio tras importantes inversiones en IA generativa e integraciones mejoradas en Microsoft Copilot.

Algunos artículos y capturas de pantalla pueden hacer referencia a Power Virtual Agents mientras actualizamos la documentación y el contenido de capacitación.

Nota

Microsoft Copilot Studio ahora admite estas características sin Composer.

Mejore su bot desarrollando temas personalizados con Bot Framework Composer y luego agregándolos a su copiloto de Microsoft Copilot Studio.

Composer está integrado en Microsoft Copilot Studio para permitir que los desarrolladores y los usuarios comerciales creen bots juntos. Composer permite ampliar un bot con funcionalidad de Bot Framework, que incluye:

  • Diálogos adaptables
  • Generación de idioma (LG)
  • Expresiones regulares (RegEx)
  • Tarjetas adaptables

Composer con Microsoft Copilot Studio permite acceder a la memoria conversacional y al contexto, incluidas las variables definidas en Microsoft Copilot Studio. Esta memoria y contexto le permiten crear temas para manejar interrupciones, cancelaciones y cambios de contexto. También puede agregar tarjetas adaptables para mostrar elementos interactivos como imágenes y vídeos, formularios y más en el bot.

Hay una variedad de funciones y expresiones prediseñadas en Composer para que las use, así como la capacidad de definir múltiples variaciones de una frase para que el bot seleccione aleatoriamente en runtime.

Los temas personalizados agregados con Composer se implementan, alojan y ejecutan junto con el resto del contenido del copiloto de Microsoft Copilot Studio, y no requieren más hosting de Azure.

Importante

La integración de Composer no está disponible para los usuarios que solo tengan la licencia de Teams Microsoft Copilot Studio Debe tener una licencia de prueba o completa de Microsoft Copilot Studio.

Requisitos previos

Comprender los términos clave de Composer

Composer utiliza un conjunto diferente de términos para describir conceptos similares utilizados en Microsoft Copilot Studio. A continuación, presentamos algunos términos clave para comprender:

  • diálogo: Los diálogos son el bloque de creación básico en Composer y sirven como contenedores para desencadenadores. Cada cuadro de diálogo representa una parte de la funcionalidad del bot que contiene instrucciones sobre lo que hace el bot y cómo reacciona a la entrada del usuario. Para obtener más información sobre los diálogos, consulte Diálogos como bloques de creación conversacionales en Composer.

  • cuadro de diálogo principal: El cuadro de diálogo principal de un bot es el primer cuadro de diálogo que aparece en el explorador de bots y se crea cuando importa su copiloto de Microsoft Copilot Studio a Composer. El diálogo principal nunca debe eliminarse, ya que corresponde a su copiloto de Microsoft Copilot Studio.

  • desencadenador: Los desencadenadores son el componente principal de un diálogo y le permiten capturar y responder a eventos. Cada desencadenador tiene una condición y una colección de acciones para ejecutar cuando se cumple la condición. Los desencadenadores son el equivalente a los temas en Microsoft Copilot Studio. Para obtener más información sobre desencadenadores, consulte Desencadenadores.

  • acción: Las acciones son los componentes principales de un disparador que le permiten enviar una respuesta, crear y asignar valores a propiedades, manipular el flujo de conversación, administrar diálogos y muchas otras actividades. Las acciones son el equivalente a los nodos en Microsoft Copilot Studio.

Funciones de Composer no compatibles con Microsoft Copilot Studio

Las siguientes características de Composer no son compatibles con Microsoft Copilot Studio:

Característica no compatible Información adicional
Reconocedor de (language understanding) LUIS El reconocedor predeterminado en Composer está configurado como reconocimiento de lenguaje natura (NLU) de Microsoft Copilot Studio.
Bot Framework Orchestrator Bot Framework Orchestrator no es compatible con Composer para Microsoft Copilot Studio.
Reconocedor personalizado El reconocedor personalizado no es compatible con Composer para Microsoft Copilot Studio.
Habilidades de bot No se pueden invocar habilidades de bot en el contenido de Composer destinado a Microsoft Copilot Studio.
QnA Maker Esta característica no está disponible en Composer para Microsoft Copilot Studio.
Inicio de sesión de OAuth y cierre de sesión de usuario Este tipo de acciones no se admiten en Composer para Microsoft Copilot Studio.
Entradas y salidas de diálogo Las entradas y salidas de diálogo no son compatibles con Composer para Microsoft Copilot Studio.
Detección de entidades en frases de activación en Composer No se puede utilizar # getUserName my name is {username=userName} en Composer.
Pruebas en el emulador de Bot Framework Todo el contenido de Composer debe publicarse y luego probarse en Microsoft Copilot Studio.

Directrices para crear contenido de Microsoft Copilot Studio en Composer

Hay algunas pautas clave que se deben seguir al usar Composer para crear el contenido para Microsoft Copilot Studio:

  • Los temas del bot de Microsoft Copilot Studio se muestran en Composer como cuadros de diálogo. No puede editar estos cuadros de diálogo en Composer; al seleccionarlos abrirá los temas pertinentes en Microsoft Copilot Studio para editarlos.

    Captura de pantalla de la lista de temas en Composer que se importaron desde un copiloto de Microsoft Copilot Studio.

  • El acceso a las variables globales de Microsoft Copilot Studio se realiza en Composer usando el ámbito virtualagent. Este alcance no aparece en el menú de referencia de propiedades de Composer, pero puede acceder a él ingresando una expresión directamente.

  • Publicar conetnido en Composer hace que los cambios estén disponibles para pruebas, pero no se publica automáticamente su copiloto de Microsoft Copilot Studio. Utilice la característica Publicar en Microsoft Copilot Studio para publicar los cambios de su copiloto en los canales.

  • Use la acción Comenzar un tema de Microsoft Copilot Studio para llamar a los temas de Microsoft Copilot Studio en Composer.

    Captura de pantalla del menú Agregar acción de Composer.

  • Puede agregar nuevos desencadenadores de Composer de cualquier tipo a su diálogo principal (también llamado "raíz").

  • Puede enviar mensajes y hacer preguntas desde estos desencadenadores de Composer.

  • No puede usar el reconocedor de expresiones regulares en el diálogo principal. El uso del reconocedor de expresiones regulares en el diálogo principal impide que publique su contenido de Composer en Microsoft Copilot Studio. Sin embargo, puede utilizar el reconocedor de expresiones regulares en cualquier otro diálogo de Composer.

  • Puede agregar cualquier evento y disparador de Composer a diálogos recién creados.

  • En la pestaña Respuestas de bot, la sección del Común debe estar vacía. Si se usan activos allí, se producen errores de validación y evita que publique su contenido de Composer en Microsoft Copilot Studio.

    Captura de pantalla de la sección de respuestas de bot comunes vacía.

  • Cada diálogo de Composer tiene sus propios recursos de respuesta de bot (.lg) y reconocimiento del lenguaje (.lu). Por ejemplo, un bot que habla inglés (EE. UU.) y tiene un cuadro de diálogo llamado dialog1 tiene un archivo dialog1.en-us.lg y un archivo dialog1.en-us.lu .

  • El diálogo principal en Composer nunca debe eliminarse, ya que corresponde a su copiloto de Microsoft Copilot Studio. El diálogo principal puede tener cero o más desencadenadores.

  • Puede capturar telemetría en los diálogos y desencadenadores de Composer y usar Application Insights para analizarlo con Consultas de Kusto para diálogos adaptativos. Para obtener más información, consulte Capturar telemetría con Application Insights.

Para un análisis en profundidad de los diálogos, eventos y desencadenadores de Composer y cómo crear contenido de bot avanzado con Bot Framework, consulte los siguientes recursos:

Referencias

Para aprender más sobre el desarrollo en Composer, consulte estos recursos: