Información general sobre Bot Framework Composer
Nota
Microsoft Copilot Studio ahora admite estas características sin Composer.
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 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 Copilot Studio a Composer. El diálogo principal nunca debe eliminarse, ya que corresponde a su copiloto de 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 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 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. |
Inicio de sesión de OAuth 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.
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.
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.
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 archivodialog1.en-us.lg
y un archivodialog1.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:
- Diálogos de Bot Framework Composer
- Eventos y desencadenadores de Bot Framework Composer
- Generación de lenguaje
- Flujo de conversación y memoria
Referencias
Para aprender más sobre el desarrollo en Composer, consulte estos recursos:
- Bot Framework Documentación de Composer
- Paseo por Composer
- Tutorial: Crear un nuevo bot
- Tutorial: Agregar tarjetas y botones a su bot
- Tutorial: Incorporar la generación de lenguaje al bot
- Bot Framework Composer en GitHub
Contenido relacionado
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de