Usar acciones de complemento en Copilot Studio (versión preliminar)

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.

Puede ampliar las capacidades de su copiloto agregando una o más acciones de complemento. Su copiloto utiliza acciones de complemento para responder a los usuarios automáticamente, usando acciones generativas o puede llamarlas explícitamente desde un tema.

[Este artículo es documentación preliminar y está sujeto a modificaciones].

Tipos de acción del complemento principal

Las acciones de los complementos se basan en uno de los siguientes tipos de acciones principales:

• Acción de conector prediseñada
• Acción de conector personalizado
• Flujo de nube de Power Automate
• Habilidad de Bot Framework

Importante

No puede usar complementos conversacionales creados en Copilot Studio como acciones de complemento.

Cada acción principal tiene información adicional que describe su propósito, lo que permite al copiloto usar GPT para generar preguntas. Estas preguntas son necesarias para rellenar las entradas necesarias para realizar la acción. Por lo tanto, no necesita crear manualmente nodos de preguntas para reunir todas las entradas necesarias, como las entradas de un flujo. Las entradas se manejan por usted durante el tiempo de ejecución.

Las acciones de los complementos pueden generar una respuesta contextual a la consulta de un usuario, usando los resultados de la acción. Como alternativa, puede crear explícitamente una respuesta para la acción del complemento.

Propina

Cuando use preguntas generadas a partir de la acción de un complemento, informe a sus usuarios de que parte de la conversación está generada por la IA.

Por ejemplo, agregue un mensaje adicional en el tema del sistemaInicio de conversación. Este tema determina el mensaje que se muestra a sus usuarios cuando comienza una nueva conversación.

Agregar una acción de complemento

1. Abra su copiloto y seleccione Temas y complementos en el panel de navegación.

2. Seleccione + Crear.

3. Seleccione Acción del complemento (vista previa).

   

4. En el asistente Agregar una acción (vista previa), busque una acción de complemento que desea usar y selecciónela.

   La lista predeterminada que se muestra tiene flujos de Power Automate y conectores personalizados disponibles en su entorno. Esta lista incluye conectores prediseñados de uso común y habilidades de Bot Framework registradas con su copiloto. Para obtener más información, consulte Crear complementos de IA para Microsoft Copilot (versión preliminar).

   

   Importante

   Algunas acciones de complementos creadas a partir de complementos de IA, como las solicitudes dinámicas y las basadas en las API de Dataverse, requieren autenticación.

5. Configurar la conexión para la acción.

   Dependiendo del complemento, su conexión se configura automáticamente, como se muestra en el ejemplo. Alternativamente, se le pedirá que configure la conexión si se proporcionan instrucciones en el asistente. Una vez que su conexión se configure correctamente, seleccione Siguiente.

   

6. Revise y realice cambios en la configuración de acciones del complemento si hacen falta. Seleccione Finalizar para agregar la acción del complemento a su copiloto.

   

Llamar una acción de complemento

Si ha habilitado acciones generativas, la acción de su complemento se puede llamar automáticamente en respuesta a una consulta de usuario relevante.

Alternativamente, puede llamar a una acción de complemento explícitamente desde un tema.

Pruebe la acción de su complemento

Hágale a su copiloto una pregunta relevante mediante el chat de prueba. Puede alternar (mostrar u ocultar) la vista del panel de chat en la parte inferior del menú de navegación.

Su copiloto selecciona y ejecuta la acción del complemento, según el nombre y la descripción. Puede escribir descripciones de alta calidad, usando el modo de seguimiento dedicado para ver qué acciones de complemento ha seleccionado su copiloto en la página Acciones generativas.

Alternativamente, si ha agregado una acción de complemento a un tema, puede probarla introduciendo un mensaje similar a una de las frases desencadenantes para ese tema.

Puede ver una acción del complemento meteorológico que se está probando en esta captura de pantalla:

Las conversaciones impulsadas por GPT pueden ser más fluidas que las preguntas escritas tradicionalmente. Los usuarios pueden responder más de una pregunta en un solo turno o corregir los valores que ingresaron anteriormente.

En este ejemplo, puede ver que el usuario del copiloto primero eligió verificar el clima de Orlando, FL pero luego, en la etapa de confirmación, indicó que quería cambiar su ubicación en Seattle. Este cambio en el valor de entrada se puede realizar en cualquier momento, no solo en la etapa de confirmación.

Realizar cambios en la configuración de acción de complemento

Hay muchas formas de configurar la acción del complemento. En el paso final del asistente de acción del complemento, llamado Revisar y finalizar, puede realizar cambios en la configuración de la acción del complemento haciendo clic en Editar junto a la sección correspondiente.

Detalles de la acción

Aquí puede configurar los detalles de su acción, incluido el nombre para mostrar del modelo y la descripción del modelo para su acción de complemento. Por lo general, el nombre y descripción se completan previamente según la acción que seleccionó.

En esta página, puede seleccionar la casilla de verificación Preguntar al usuario antes de ejecutar esta acción, que es útil para acciones que realizan cambios para un usuario, como insertar o actualizar un registro en una tabla.

Entradas

La sección Entradas le permite administrar el nombre para mostrar y la descripción de cada entrada en su acción. El nombre y la descripción ayudan al copiloto a generar una pregunta para el usuario. Por ejemplo, una pregunta generada para la entrada de ubicación podría ser: ¿Cuál es la ubicación donde le gustaría verificar el clima? Puede ingresar una ciudad, región, estado, país, punto de referencia o código postal"

Puede cambiar la opción Identificar como a un tipo de entidad específico, dependiendo de la entrada que se recopila, lo que puede ayudar al copiloto a extraer con precisión un valor de la respuesta de un usuario.

De forma predeterminada, cada entrada está configurada para Rellenar dinámicamente con la mejor opción. El copiloto intenta completar el valor a partir del contexto disponible, como extraer un valor del mensaje del usuario. Si no se encuentra un valor apropiado, genera una pregunta para pedirle un valor al usuario. Puede anular una entrada con un valor en lugar de preguntarle al usuario. Para anular esto, cambie la lista desplegable ¿Cómo completará el copiloto esta entrada? a Establecer como un valor e introduzca un valor. Este valor puede ser un valor literal, una variable existente o una fórmula de Power Fx.

Salidas

De forma predeterminada, su acción de complemento está configurada para generar automáticamente una respuesta contextual para un usuario, según su consulta y el resultado de la acción. Por ejemplo, si un usuario pregunta "¿Cuál es la temperatura actual en Londres?", se genera una respuesta contextual utilizando GPT, como "La temperatura actual en Londres es de 9 grados centígrados".

Alternativamente, puede optar por crear una respuesta específica para que se devuelva su acción de complemento. Al igual que con el editor de confirmación, puede insertar referencias a variables de salida de la acción usando el selector de variables, como se muestra en este ejemplo.

Llamar una acción de complemento desde dentro de un tema

Puede llamar a una acción de complemento explícitamente desde tema, de forma similar a cuando llama a otros tipos de acciones, como Flujos de Power Automate. Dependiendo de su caso de uso, puede usar su flujo como parte de un tema más amplio, que usa más nodos. O, como en el ejemplo del clima, agregar un único nodo de acción de complemento a tema podría ser todo lo que necesita.

Para llamar a una acción de complemento desde un tema:

1. En Microsoft Copilot Studio, vaya a la página Temas del copiloto que desea editar.

2. Cree un nuevo tema y asígnele un nombre Obtener pronóstico del tiempo.

3. Agregue las siguientes frases desencadenadoras:

   • lloverá
   • pronóstico de hoy
   • obtener pronóstico del tiempo
   • ¿cuál es la previsión meteorológica?

   

4. Seleccione Agregar nodo (+) y luego Llamar una acción. Cambie a la pestaña Acciones del complemento (vista previa) y luego seleccione la acción del complemento que creó anteriormente, Obtener pronóstico del tiempo.

   

5. Su nodo de acción de complemento (vista previa) ahora está agregado a su tema.

   

6. Seleccione Guardar.

Reemplazar las entradas al llamar una acción de complemento desde un tema

De forma predeterminada, cuando se ejecuta la acción de su complemento, su copiloto genera preguntas para que el usuario complete las entradas requeridas. Sin embargo, es posible que desee anular una o más entradas y proporcionar un valor explícito en lugar de preguntarle al usuario. Puede anular en la configuración de acción del complemento dentro de la sección Entradas. O bien, puede anular los valores solo cuando la acción de su complemento se use desde un tema específico:

1. Seleccione Establecer valor en el nodo y elija la entrada que desea anular.

   

2. Ingrese el valor de la entrada escribiendo un valor, seleccionando una variable o usando una fórmula.

   

Ahora que esta entrada se ha anulado, el copiloto no le pedirá un valor al usuario.

Habilitar la autenticación de complementos de IA

Algunas acciones de complementos, cuando se crean según copmplementos de IA, requieren autenticación para funcionar correctamente, como Dynamic Prompt u otras que llaman a una API Dataverse.

Los complementos siempre se ejecutan en el tiempo de ejecución de Microsoft Copilot en el contexto del usuario final y no se pueden ejecutar a menos que se habilite la autenticación. Se admiten dos tipos de métodos de autenticación:

• Autenticación integrada (Teams y Power Apps): esta configuración de autenticación se puede emplear si su copiloto está en el canal de Teams. La configuración también funciona con copilotos integrados en cualquier aplicación Power Platform que utilice tokens creados con el estándar PPAPI.

• Autenticación manual (copilotos de terceros): este método de autenticación implica la configuración de una conexión de Entra ID.

Para crear una conexión de autenticación manual:

1. Configure una aplicación de Entra ID.

2. Configure la autenticación manual en su copiloto Copilot Studio.

3. Permita que su aplicación use la delegación para capturar un símbolo (token) en nombre del usuario. Asegúrese de agregar los ámbitos necesarios.