Usar acciones con copilotos personalizados (versión preliminar)
Puede ampliar las capacidades de su copiloto agregando una o más acciones. Su copiloto utiliza las acciones 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 acciones principales
Si activa el modo generativo, su copiloto puede seleccionar automáticamente la acción más adecuada o tema, para responder a un usuario en tiempo de ejecución.
En el modo clásico, un copiloto solo puede utilizar temas para responder al usuario. Sin embargo, aún puede diseñar tu copiloto para llamar a acciones explícitamente desde dentro de los temas.
Las acciones 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
- Indicadores de AI Builder
- Habilidad de Bot Framework
Importante
No puede usar acciones conversacionales creadas en Copilot Studio como acciones con copilotos personalizados.
Cada acción principal tiene información adicional que describe su propósito, lo que permite al copiloto utilizar IA generativa 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 pueden generar una respuesta contextual a la consulta de un usuario, utilizando los resultados de la acción. Como alternativa, puede crear explícitamente una respuesta para la acción.
Propina
Cuando utilice preguntas generadas a partir de una acción, informe a sus usuarios que parte de la conversación es generada por IA.
Por ejemplo, agregue un mensaje adicional en el tema del sistema Inicio de conversación. Este tema determina el mensaje que se muestra a sus usuarios cuando comienza una nueva conversación.
Agrega una acción
Abra su copiloto personalizado eligiendo Copilotos en el panel de navegación de la izquierda y seleccionando su copiloto de la lista.
Seleccione Acciones para ver las acciones del copiloto.
Seleccione + Agregar una acción.
En el asistente Elegir una acción (versión preliminar), busque la acción que desee utilizar 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.
Importante
Algunas acciones creadas a partir de complementos de IA, como las indicaciones dinámicas y las basadas en la API de Dataverse, requieren autenticación.
Dependiendo de la acción, 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.
Revise y realice cambios en la configuración de acciones del complemento si hacen falta. Seleccione Finalizar para agregar la acción a su copiloto.
Seleccione Siguiente.
Llamar a una acción
Si ha habilitado acciones generativas, su acción se llama automáticamente en respuesta a una consulta de usuario relevante.
Alternativamente, puede llamar a una acción explícitamente desde dentro de un tema.
Probar su acción
Llamar a una acción
Su copiloto selecciona y ejecuta su acción según el nombre y la descripción. Puede crear descripciones de alta calidad utilizando el modo de seguimiento dedicado para ver qué acciones seleccionó su copiloto en la página acciones generativas.
Alternativamente, si ha agregado un a tema, puede probarlo introduciendo un mensaje similar a una de las frases desencadenantes para ese tema.
Puedes ver una acción meteorológica que se está probando en esta captura de pantalla:
Alternativamente, si ha agregado una acción a un tema, puede realizar una prueba activando su tema con una frase desencadenante adecuada.
Configurar entradas y salidas para una acción
Realizar cambios en la configuración de acción
Hay muchas formas de configurar la acción. En el paso final del asistente de acción, llamado Revisar y finalizar, puede realizar cambios en la configuración de su acción haciendo clic en Editar junto a la sección correspondiente.
Detalles de la acción
Aquí puede configurar detalles sobre su acción, incluido el Nombre para mostrar del modelo y la Descripción del modelo para su acción. Por lo general, el nombre y descripción se completan previamente según la acción que seleccionó.
Las propiedades Nombre para mostrar y Descripción para cada entrada ayudan al copiloto a comprender el propósito de la entrada, para generar una pregunta apropiada para el usuario y reconocer el valor correcto en la respuesta de un usuario. Por ejemplo, los siguientes son el nombre predeterminado y la descripción del parámetro de entrada de ubicación para el conector MSN El Tiempo.
- Nombre: ubicación
- Descripción: texto consulta de búsqueda de ubicación. Las entradas válidas son Ciudad, Región, Estado, País o región, Punto de referencia, Código postal, Latitud y Longitud
Cuando le pregunta al usuario una ubicación, el copiloto genera una pregunta similar a: ¿Cuál es el lugar del que desea consultar el tiempo? Puede introducir una ciudad, región, estado, país o región, 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.
Para controlar el comportamiento de su copiloto al solicitar un valor o validar la respuesta de un usuario, puede configurar valores adicionales para las entradas.
Salidas
De forma predeterminada, su acción 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. 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 a una acción desde dentro de un tema
Puede llamar a una acción explícitamente desde un tema, de manera similar a llamar 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 tiempo, agregar un solo nodo de acción a tema podría ser todo lo que necesita.
Para llamar a una acción desde dentro de un tema:
En Copilot Studio, vaya a la página Temas del copiloto que desea editar.
Cree un nuevo tema y asígnele un nombre Obtener pronóstico del tiempo.
Agregue las siguientes frases desencadenadoras:
- ¿lloverá?
- pronóstico de hoy
- obtener pronóstico del tiempo
- ¿cuál es la previsión meteorológica?
Seleccione Agregar nodo (+) y luego Llamar una acción. Cambie a la pestaña Acciones del complemento (versión preliminar) y luego seleccione la acción que creó anteriormente, Obtener pronóstico del tiempo.
Su nodo de acción de complemento (versión preliminar) ahora está agregado a su tema.
Seleccione Guardar.
Reemplazar las entradas al llamar una acción desde un tema
De forma predeterminada, cuando se ejecuta su acción, 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 su acción se usa desde un tema específico:
Seleccione Establecer valor en el nodo y elija la entrada que desea anular.
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 para acciones de IA
Algunas acciones, cuando se crean en base a acciones de IA, requieren autenticación para funcionar correctamente, como el aviso dinámico u otras que llaman a una API de Dataverse.
Las acciones 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 la autenticación esté habilitada. Se admiten dos tipos de métodos de autenticación:
Vaya a las propiedades de acción del conector.
En Autenticación de usuario final, seleccione Autenticación de autor de copiloto.
Publique y pruebe la experiencia en el panel de prueba del copiloto o en el canal deseado.
Usar acciones de flujo con credenciales de usuario final
Las acciones de flujo se pueden configurar para usar credenciales de usuario final. Si utiliza el flujo en un canal compatible, esto no requiere configuración especial en el cuadro de diálogo del copiloto y los usuarios finales pueden administrar sus conexiones para un flujo determinado en una experiencia proporcionada.
Autenticación para acciones basadas en complementos de su biblioteca
Cuando se crean en base a complementos de IA, las acciones requieren autenticación para funcionar correctamente. Esto se ve más comúnmente con acciones basadas en mensajes u otras que llaman a API de Dataverse. Las acciones basadas en complementos siempre se ejecutan en el contexto del usuario final y no se pueden ejecutar a menos que la autenticación esté habilitada. Se admiten dos tipos de métodos de autenticación:
Autenticación integrada (Teams y Power Apps): puede utilizar este método de autenticación si desea publicar su copiloto en un canal de Teams. Este método también funciona para copilotos integrados en cualquier aplicación de 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 Microsoft Entra ID.
Para crear una conexión de autenticación manual:
Configure una aplicación de Microsoft Entra ID.
Configure la autenticación manual para su copiloto de Copilot Studio.
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.
