Compartir a través de

Información general sobre Bot Framework Composer

  • Artículo

Nota

Este artículo solo se aplica a bots de chat clásicos. Para ampliar los agentes creados en Copilot Studio, no es necesario utilizar Bot Framework Composer. Todas las funciones descritas en este artículo están disponibles para los agentes, directamente en Copilot Studio.

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

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

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

Composer con Copilot Studio permite acceder a la memoria conversacional y al contexto, incluidas las variables definidas en 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 videos, formularios y más en el copiloto.

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

Los temas personalizados agregados con Composer se implementan, alojan y ejecutan junto con el resto del contenido del copiloto de 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 Copilot Studio. A continuación, presentamos algunos términos clave para comprender:

  • diálogo: Los diálogos son los elementos básicos bloque de creación en Composer y sirven como contenedores para los activadores. 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.

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

  • Gatillo: Los activadores 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 Copilot Studio. Para obtener más información sobre desencadenadores, consulte Desencadenadores.

  • acción: Las acciones son los componentes principales de un Gatillo que le permiten enviar un 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 Copilot Studio.

Funciones de Composer no compatibles con Copilot Studio

Las siguientes características de Composer no son compatibles con 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 Copilot Studio.
Reconocedor personalizado El reconocedor personalizado no es compatible con Composer para Copilot Studio.
Habilidades de bot No se pueden invocar habilidades de bot en el contenido de Composer destinado a Copilot Studio.
QnA Maker Esta característica no está disponible en Composer para Copilot Studio.
OAuth Inicio de sesión y cierre de sesión de usuario Este tipo de acciones no se admiten en Composer para Copilot Studio.
Entradas y salidas de diálogo Las entradas y salidas de diálogo no son compatibles con Composer para 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 Copilot Studio.

Directrices para crear contenido de Copilot Studio en Composer

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

  • Los temas de su copiloto de 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 Copilot Studio para editarlos.

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

  • El acceso a las variables globales de 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 Copilot Studio. Utilice la característica Publicar en 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 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 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 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 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 una inmersión profunda en 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:

Contenido relacionado

Comience a utilizar Composer Bot Framework