Utilizar un bot de chat clásico como capacidad en el bot Bot Framework

Nota

Este artículo incluye información aplicable únicamente a los chatbots clásicos. Copilot Studio Esta función no está disponible en la nueva experiencia. Copilot Studio

Cuando se utiliza un chatbot clásico como uncapacidad con unbot, elbot determina si algo de lo que dice el usuario coincide con las frases del chatbot clásicoGatillo . Bot Framework Bot Framework Si hay una coincidencia, el Bot Framework bot pasa la conversación al chatbot clásico. El chatbot clásico extrae cualquier entidad y activa el tema correspondiente.

También puedes pasar una variable a capacidad tema como entrada desde Composer y usar las salidas que devuelve. Copilot Studio Bot Framework

Importante

Debes tener una licencia de prueba o completa para usar chatbots clásicos como capacidades. Copilot Studio Esta capacidad no está disponible con la licencia de Teams Copilot Studio .

Para configurar tu chatbot clásico como capacidad:

1. Agregue el Bot Framework bot a la lista de permitidos para el chatbot clásico.

2. Descargue el manifiesto capacidad para el chatbot clásico.

3. Utilice el manifiesto capacidad descargado en Bot Framework Composer para crear una conexión entre los bots.

4. Utilice el emulador para confirmar que bot funciona como un capacidad Bot Framework .

Requisitos previos

• Entender cómo funcionan las capacidades de Bot Framework.
• Comprender cómo usar Bot Framework Composer.
• Comprender cómo usar capacidades en Bot Framework Composer
• Obtener el id. de la aplicación del bot de Bot Framework.

Agrega tu Bot Framework bot a la lista de permitidos para tu chatbot clásico

Agrega el ID de la aplicación bot a la lista de permitidos para el chatbot clásico que quieres usar como capacidad. Bot Framework Los bots deben estar en el mismo inquilino.

1. En Bot Framework Composer, abre el bot que usará la capacidad. Seleccione Configurar y, a continuación, Recursos de desarrollo. Copie el id. en Id. de la aplicación de Microsoft.

2. En Copilot Studio, abre el chatbot clásico que quieres 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 su identificador de aplicación del bot de Bot Framework y seleccione Siguiente.

   Precaución

   Un chatbot clásico no puede actuar como un capacidad para otros chatbots 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 id. de aplicación para un bot de Bot Framework.

   Copilot Studio valida el ID de la aplicación bot y confirma que pertenece a un bot en el mismo inquilino. Bot Framework

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 Framework se muestra por su nombre para mostrar si escribió uno, o por su id. de la aplicación si no escribió 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.

Nota

Los bots Bot Framework agregados a la lista de permitidos no son exportados como parte del contenido del bot.

Descargue el manifiesto del chatbot clásico capacidad para su chatbot clásico

Bot Framework Los bots pueden usar un manifiesto capacidad para configurar una conexión con el chatbot clásico que produjo el manifiesto. Copilot Studio

Todos los chatbots clásicos tienen manifiestos capacidad. Estos son archivos JSON que incluyen el nombre, la interfaz y las frases desencadenadoras de una capacidad.

Unbot puede usar un manifiesto capacidad para saber cuándo Gatillo el chatbot clásico (por ejemplo, en respuesta ante algo que un usuario le dice). Bot Framework

Copilot Studio capacidad manifiesta seguir versión 2.2 del Bot Framework esquema de manifiesto capacidad y consta de los archivos intents.lu y manifest.json .

A Bot Framework bot puede decidir que el chatbot clásico debe manejar la solicitud del usuario, basándose en los datos del manifiesto. Pasa al chatbot clásico todo lo que dijo el usuario. Luego, el chatbot clásico hace coincidir lo que dijo el usuario con untema, extrae todas las entidades necesarias para llenar los espacios y activa eltema. Copilot Studio Copilot Studio

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

• Manifiesto de prueba: permite que bot acceda a la versión de prueba de su chatbot clásico. Bot Framework Use el manifiesto de prueba para validar los cambios en su capacidad antes de publicarlo.

  • El manifiesto de prueba está disponible inmediatamente para cada chatbot clásico recién creado.
  • Se actualiza automáticamente para reflejar los cambios cada vez que guardas tu chatbot clásico.

• Manifiesto publicado: permite que bot acceda a Conectar en la versión publicada de su chatbot clásico. Bot Framework

  • El manifiesto publicado solo está disponible para los chatbots clásicos que se hayan publicado al menos una vez.
  • Se actualiza automáticamente para reflejar los cambios cada vez que publicas tu agente. ...

Nota

El Manifiesto publicado no está disponible para los chatbots clásicos que nunca se han publicado.

Para generar el manifiesto publicado de tu bot, publica tu chatbot clásico.

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

Los manifiestos de capacidades también se muestran en la página Detalles del copiloto. 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 un archivo .zip etiquetado como _<bot name>manifest para el Manifiesto publicado, o <bot name>test__manifest para el Manifiesto de prueba.

Nota

El manifiesto capacidad no incluye temas del sistema ni diálogos de Composer que se agregan a un chatbot clásico. Solo se incluyen los temas creados por los autores de copilotos y los activadores de intenciones de Composer que los autores agregan al bot.

Conectar a un Copilot Studio capacidad en Compositor

Utilice los manifiestos capacidad para crear una conexión capacidad en su bot en Composer. Copilot Studio Bot Framework

1. En un proyecto de Bot Framework Composer, seleccione Agregar y luego Conectarse a una capacidad.

2. Busque y Seleccionar un archivo .zip de manifiesto y luego Seleccionar Copilot Studio Siguiente .

3. Seleccionar los temas o intenciones en tu chatbot clásico que deseas agregar a tu Bot Framework bot, y luego Seleccionar Siguiente.

4. Revisa y edita las frases Gatillo para tu chatbot clásico y luego Seleccionar Siguiente.

5. Asegúrese de que la opción Usar Orchestrator para proyectos de varios bots está seleccionada y, a continuación, seleccione Continuar.

6. Verifique que el capacidad se agregue a su bot correctamente y que un nuevo Gatillo con el nombre de su chatbot clásico aparezca en el proyecto en Composer. Copilot Studio Bot Framework

Ubique el tema en el manifiesto de capacidades

Utilice un evento para Gatillo a Copilot Studio tema en capacidad. Para llamar a un tema específico desde Composer, consulte el tema por el nombre del evento asociado en el manifiesto de capacidad.

1. Seleccione la acción Conectar a una capacidad.

2. Bajo Nombre del diálogo de capacidades, seleccione Mostrar manifiesto de capacidad.

3. Encuentre actividades en el manifiesto. Esta propiedad contiene propiedades anidadas que representan los temas disponibles en su chatbot clásico.

4. Encuentra el tema al que quieres llamar y busca su propiedad nombre. Cuando el capacidad recibe un evento con este nombre, activa el tema. Copilot Studio

   En este ejemplo, el nombre de la actividad del evento es dispatchTo_new_topic_87609dabd86049f7bc6507c6f7263aba_33d.

Llama a Copilot Studio capacidad tema

En lugar de confiar en lo que un usuario dice a Gatillo a Copilot Studio capacidad tema, puedes llamarlo directamente. Solo puedes llamar directamente a los temas que figuran en el manifiesto capacidad. Copilot Studio

1. En el lienzo de creación de Composer, seleccione Agregar y, a continuación, Acceder a recursos externos y luego seleccione Conectarse a una capacidad.

2. En la lista Nombre del diálogo capacidad , Seleccionar tu chatbot clásico.

3. Encuentra el nombre de la actividad del evento para el chatbot clásico tema al que quieres llamar. Copie el valor, omitiendo las comillas, y guárdelo para usarlo en los siguientes pasos.

4. Seleccione Cerrar.

5. En la sección Actividad, seleccione Mostrar código.

6. Escriba o pegue el siguiente código. Reemplace TOPIC_ACTIVITY_NAME con el nombre de la actividad del evento de tu tema. Asegúrese de que no haya comillas en la propiedad nombre.

   [Activity
       type = event
       name = TOPIC_ACTIVITY_NAME
   ]
   

Pasar una variable de entrada a un Copilot Studio capacidad tema

Bot Framework El compositor puede pasar una variable a uncapacidad tema como entrada. Copilot Studio Para aprender a crear temas que acepten variables de entrada, consulte Trabajar con variables Copilot Studio . ...

Si en su manifiesto capacidad aparece un tema que puede recibir una variable de entrada, puede pasarle una variable de Composer. Copilot Studio

1. En el lienzo de creación de Composer, seleccione Agregar y, a continuación, Acceder a recursos externos y luego seleccione Conectarse a una capacidad.

2. En la lista Nombre del diálogo capacidad , Seleccionar tu chatbot clásico.

3. Encuentra el nombre de la actividad del evento para el chatbot clásico tema al que quieres llamar. Copie el valor, omitiendo las comillas, y guárdelo para usarlo en los siguientes pasos.

4. Encuentra la propiedad valor del tema. La propiedad valor contiene la propiedad $ref. Copie ese valor y guárdelo para usarlo en el siguiente paso.

   Advertencia

   Si un Copilot Studio tema no tiene entradas, no tendrá una propiedad valor .

5. Encuentre la propiedad definiciones, luego busque una propiedad anidada que coincida con el valor $ref que encontró en el paso anterior. Tenga en cuenta los nombres y tipos de las entradas de tema. Copilot Studio Los usará en los siguientes pasos.

6. Seleccione Cerrar.

7. En la sección Actividad, seleccione Mostrar código.

8. Escriba o pegue el siguiente código. Reemplace estos valores:

   1. Reemplace TOPIC_ACTIVITY_NAME con el nombre de la actividad del evento de tu tema.
   2. Reemplace PVA_INPUT_VARIABLE con una variable de entrada de su tema.
   3. Reemplace COMPOSER_INPUT_VARIABLE con una variable Composer que proporcionará un valor.

   [Activity
       Type = event
       Name = TOPIC_ACTIVITY_NAME
       Value = ${addProperty(json("{}"), 'PVA_INPUT_VARIABLE', COMPOSER_INPUT_VARIABLE)}
   ]
   

   En este ejemplo, la variable Composer dialog.storeLocation proporciona un valor a la variable de entrada pva_StoreLocation en el chatbot clásico tema dispatchTo_new_topic_127cdcdbbb4a480ea113c5101f309089_21a34f16.

Recibir una variable de salida de un Copilot Studio capacidad tema

Es posible recibir salidas de un Copilot Studio capacidad tema en Composer. Para aprender a crear Copilot Studio temas que devuelvan resultados, consulte Trabajar con variables.

1. En el lienzo de creación de Composer, seleccione Agregar y, a continuación, Acceder a recursos externos y luego seleccione Conectarse a una capacidad.

2. En la lista Nombre del diálogo capacidad , Seleccionar tu chatbot clásico.

3. Encuentra el nombre de la actividad del evento para tu chatbot clásico tema al que deseas llamar. Copie el valor, omitiendo las comillas, y guárdelo para usarlo en los siguientes pasos.

4. Busque la propiedad resultValue del tema. La propiedad resultValue contiene la propiedad $ref. Copie ese valor y guárdelo para usarlo en el siguiente paso.

   Advertencia

   Si un Copilot Studio tema no tiene salidas, no tendrá una propiedad resultValue .

5. Encuentre la propiedad definiciones, luego busque una propiedad anidada que coincida con el valor $ref que encontró en el paso anterior. Tenga en cuenta los nombres y tipos de las variables de salida de tema. Copilot Studio Los usará en los siguientes pasos.

   En este ejemplo, tema devuelve dos salidas de tipo String, pva_State Copilot Studio y pva_Item .

6. Seleccione Cerrar.

7. En la sección Actividad, seleccione Mostrar código.

8. Escriba o pegue el siguiente código. Reemplace TOPIC_ACTIVITY_NAME con el nombre de la actividad del evento de tu tema. Asegúrese de que no haya comillas en la propiedad nombre.

   [Activity
       type = event
       name = TOPIC_ACTIVITY_NAME
   ]
   

9. En el área de código, configure Propiedad en una variable de Composer para recibir y almacenar los valores de salida de Copilot Studio capacidad tema.

10. En el lienzo de creación de Composer, seleccione Agregar, luego seleccione Administrar propiedades y luego seleccione Establecer propiedades.

11. Establezca Propiedad en el valor de Composer que debe almacenar el valor extraído. Entonces establece Valor a la variable Composer en la que almacenó las salidas de tema.

    En este ejemplo, los valores de salida de dialog.skillResult.pvaState y dialog.skillResult.pvaItem se extraen en nuevas variables de Composer dialog.State y dialog.Item.

Pon a prueba tu chatbot clásico como un capacidad con un Bot Framework bot

Utilice el Bot Framework Emulador para probar que su Bot Framework bot está llamando correctamente a un chatbot clásico como capacidad.

Importante

Su Bot Framework bot debe agregarse a la lista de permitidos del chatbot clásico para que la conexión capacidad funcione.

Más información

• Resumen de capacidades
• Manifiesto de capacidad
• Documentación de Bot Framework Composer
• Capacidades en Composer
• Conéctese a una capacidad remota en Composer
• Probar una capacidad en el emulador