Información general del desencadenador de eventos (versión preliminar)

Puede configurar agentes personalizados para que realicen acciones o llamen a temas en respuesta a algo que está sucediendo mediante desencadenadores de eventos. A diferencia de los desencadenadores de temas, que requieren la entrada de un usuario, los desencadenadores de eventos permiten que su agente actúe de forma autónoma en respuesta al evento definido que se produce.

Importante

La habilitación de desencadenadores de eventos puede afectar a la forma de calcular la facturación. Obtenga más información sobre la facturación para el modo generativo.

Nota

Esta característica solo está disponible para agentes con orquestación generativa habilitada.

Funcionamiento de los desencadenadores de eventos

Los desencadenadores de eventos requieren un evento elegido que genera una carga útil del desencadenador y la envía al agente a través de un conector. La carga útil contiene información sobre el evento, incluidas variables para tipos específicos de datos. Cuando el agente recibe la carga útil, ejecuta las instrucciones proporcionadas por el autor del agente y las enviadas a través de la carga útil del desencadenador.

Los agentes solo actúan según el diseño y las instrucciones de su autor. Por ejemplo, puede agregar un desencadenador para cuando se agregue un nuevo miembro al equipo y designar la respuesta como la acción de enviar al nuevo empleado un mensaje de bienvenida con recursos de incorporación.

Los desencadenadores de eventos se desencadenan en función de eventos externos al agente. Son diferentes de los desencadenadores de temas, que se utilizan para activar temas o acciones en función de las frases desencadenadoras introducidas por los usuarios.

Este artículo explica cómo funcionan los desencadenadores de eventos, sus limitaciones y estrategias de solución de problemas. Para obtener más información sobre cómo agregar un desencadenador de eventos, consulte Agregar un desencadenador de eventos.

Entre otros ejemplos de desencadenadores de eventos se incluyen:

• Cuando se crea un elemento en SharePoint
• Cuando se crea un archivo en OneDrive
• Cuando se completa una tarea en Planner
• Ha pasado una cantidad de tiempo determinada (un desencadenador de periodicidad)

Importante

Los desencadenadores disponibles dependen de las directivas de prevención de pérdida de datos de su organización, configuradas en Power Automate por un administrador.

Facturación y uso de desencadenadores de eventos

La actividad de desencadenador de eventos se tiene en cuenta en las unidades de consumo para el uso y la facturación, incluso en la versión preliminar pública. Un mensaje se define como cualquier solicitud o mensaje enviado al agente que desencadena una acción o una respuesta del agente. Esto incluye las cargas útiles enviadas a los agentes desde desencadenadores de eventos. Por ejemplo, un desencadenador de periodicidad configurado para activarse cada 10 minutos envía una carga útil de desencadenador como un mensaje a un agente cada 10 minutos.

Para obtener más información, vea Administrar mensajes y capacidad de Copilot Studio.

El flujo de trabajo de desencadenador

Un desencadenador es una parte de un flujo de trabajo que contiene varias partes:

1. Un desencadenador de eventos registra que se ha producido un evento específico.
2. El desencadenador envía una carga útil que contiene información sobre el evento e instrucciones.
3. El agente tiene instrucciones para elegir una o más acciones o temas en función de la carga útil.

Encuentre el desencadenador que se adapte a su evento

Copilot Studio tiene una biblioteca de desencadenadores para una variedad de eventos que pueden ocurrir en Microsoft y servicios asociados. La configuración del desencadenador determina los parámetros del evento que inicia el desencadenador. También determina el contenido de la carga útil del desencadenador.

La mayoría de los desencadenadores permiten especificar parámetros sobre el evento que activa el desencadenador. Por ejemplo, en el desencadenador Cuando se agrega, modifica o elimina una fila para Dataverse, seleccione qué cambios de la tabla activan el desencadenador.

Definir la carga útil del desencadenador

La carga útil del desencadenador es un JSON o mensaje de texto sin formato que contiene información sobre un evento y se envía a su agente como un mensaje. Al agregar un desencadenador, puede mantener el contenido de carga útil predeterminado para ese desencadenador o agregar sus propias instrucciones. Más adelante, puede modificar el contenido de la carga útil, incluida la adición de variables y operadores de cadena, en Power Automate.

Por ejemplo, el mensaje predeterminado en el desencadenador Cuando se agrega, modifica o elimina una fila es Usar contenido de Body. Cuando el agente recibe la carga útil, tiene el contenido de la fila e instrucciones para usar ese contenido.

Puede agregar instrucciones para enviar a su agente dentro de la carga útil que dirigen el agente sobre cómo actuar cuando lo activa el desencadenador. Si tiene varios desencadenadores, cada carga útil del desencadenador puede tener instrucciones específicas y detalladas. Como resultado, puede evitar escribir una guía larga y complicada en las instrucciones generales del agente o confundir el agente sobre qué instrucciones se aplican a qué desencadenador.

Por ejemplo, en una carga útil de desencadenador Cuando se agrega, modifica o elimina una fila, puede agregar Enviar un resumen de los cambios en el chat. Cuando el agente recibe la carga útil, resume los cambios para el usuario en el chat del agente.

Sin embargo, evite escribir instrucciones de carga útil que entren en conflicto con las instrucciones generales del agente. Los conflictos en las instrucciones pueden causar un error o resultados inesperados. Asegúrese de probar todos los cambios relacionados con desencadenadores de eventos.

Después de crear un desencadenador, puede agregar o cambiar variables u operadores de cadena en una carga útil de desencadenador y modificar las instrucciones de carga existentes mediante Power Automate.

Instrucciones del agente frente a instrucciones de la carga útil

Las instrucciones de carga útil son específicas sobre cómo reaccionar ante un evento. También puede usar instrucciones de agente para dirigir a su agente sobre cómo manejar la información de un desencadenador y cómo actuar cuando recibe una carga útil de desencadenador, así como para determinar el comportamiento general de su agente. Por ejemplo, para un agente que comprueba si hay nombres de cuenta duplicados en las nuevas filas de tabla de Dataverse, las instrucciones podrían ser: Cuando se agregue una fila nueva, compruebe si se trata de una cuenta duplicada. Si hay un duplicado, cree una tarea de "Pendiente" para investigar e incluya detalles sobre los cambios y los duplicados..

Sin embargo, es posible que las instrucciones del agente no funcionen mejor para todas las situaciones. Si su agente tiene varios desencadenadores o varios objetivos complejos, debe usar las instrucciones en la carga útil del desencadenador en su lugar.

Continuando con el último ejemplo, puede agregar una instrucción en la carga útil del desencadenador para buscar nombres de cuenta duplicados en la misma tabla de Dataverse. Cuando el agente recibe la carga útil, se le indica que busque nombres de cuenta duplicados. Luego, las instrucciones generales del agente dicen: Si hay un duplicado, cree una tarea Pendiente para investigar e incluya detalles sobre los cambios y duplicados.

La creación de instrucciones para los agentes requiere práctica. Vaya a la guía de escritura para obtener más consejos y siempre pruebe todos los cambios que realice en su agente.

Llamar a una acción o tema

Cuando un agente recibe una carga útil de desencadenador, las instrucciones que se le proporcionan determinan la acción o el tema al que llama en respuesta, en función de la información que tiene disponible.

Su agente no crea una nueva acción o tema en el acto. Como autor de agente, debe definir las acciones o temas entre los que puede seleccionar. Para saber cómo determina el agente qué acción o tema llamar, vaya a ¿Cómo funciona el modo generativo?

Si su agente no reacciona como se esperaba, puede usar el mapa de actividad para ver si le falta alguna información de entrada clave.

Estas son algunas de las mejoras que puede hacer en las instrucciones:

• Agregar instrucciones más detalladas en la carga útil del desencadenador o de instrucciones de agente. Es posible que su agente necesite más instrucciones, como qué información usar en un campo de entrada específico para la acción.
• Incluir instrucciones en la carga útil del desencadenador.
• Instruir a su agente para que llame a una acción o tema específico.
• Comprobación de instrucciones contradictorias entre la carga útil del desencadenador y las instrucciones del agente.
• Agregar a las descripciones de las acciones, para que el agente tenga más información para determinar cuándo llamarlo.
• Agregar descripciones a los campos de entrada de la acción para ayudar a su agente completar los parámetros correctamente. Si las entradas de una acción son siempre las mismas, puede establecer el valor usted mismo.
• Llamar a menos de 15 acciones o temas de forma consecutiva. Los agentes complejos que ejecutan muchas acciones o temas como una sola secuencia pueden tener dificultades para ejecutarlos de manera fiable.

Si su agente aún tiene dificultades para llamar a la acción esperada, considere agregar un Power Automate flujo que cumpla su objetivo como una acción para su agente.

Publicación de agentes con desencadenadores de eventos

Antes de publicar su agente con un nuevo desencadenador de evento, el agente no reacciona automáticamente a ese desencadenador. Asegúrese de probar el agente a fondo antes de publicarlo, porque después de publicar un agente con un nuevo desencadenador, el agente reacciona automáticamente cada vez que se activan sus desencadenadores. Puedes ver un registro paso a paso de los desencadenadores y reacciones de su agente en la página Actividad.

Para obtener información sobre cómo activar desencadenadores durante las pruebas, vaya a Probar un desencadenador.

Los desencadenadores de eventos solo pueden usar las credenciales del autor agente para la autenticación (es decir, las credenciales que utilizó para autorizar las conexiones) para su desencadenador. Esto puede permitir a los usuarios de un agente usar el agente para acceder a datos y sistemas usando esa misma autorización. Para obtener más información, vaya a Solución de problemas y limitaciones.

Autenticación de acciones después de la publicación

Si a su agente le falta autenticación para realizar una acción o está configurado para solicitar autenticación de usuario, envía un mensaje al usuario solicitando credenciales. Si el flujo de un agente se interrumpe porque no puede recibir información o una acción falló, no puede continuar la sesión. Si desea que el agente se ejecute de forma autónoma, cada acción debe configurarse con una autenticación que funcione y que no requiera la entrada del usuario. También puede indicar a su agente que no solicite credenciales a los usuarios.

Es posible que los agentes no puedan ejecutar todos los conectores correctamente. Si un agente falla repetidamente al llamar a un conector, considere la posibilidad de crear una acción de flujo de Power Automate que utilice el conector problemático para completar la acción.

Solución de problemas y limitaciones

Limitaciones de cuotas

Si los desencadenadores se activan con demasiada frecuencia, es posible que su agente termine usando más recursos de los esperados. Su agente podría superar los límites de cuota de carga de servicio y su servicio podría verse limitado.

Los administradores pueden supervisar el uso de recursos a través de Power Platform. También pueden bloquear el uso de desencadenadores de eventos en un entorno.

Para evitar exceder los límites de cuota:

• Tenga cuidado al agregar desencadenantes muy frecuentes o desencadenantes que se repiten indefinidamente. Por ejemplo, un desencadenador de periodicidad se activa cada vez que pasa una cantidad determinada de tiempo. Cuanto menor sea la cantidad de tiempo entre activaciones, más recursos utilizará el desencadenador.
• Realice un seguimiento de cuántos desencadenadores están activos en un entorno.

Los desencadenadores solo pueden usar credenciales de creador

Actualmente, los desencadenadores de eventos solo pueden usar las credenciales del autor agente para la autenticación. Si publica o comparte un agente con desencadenadores de eventos autenticados, es posible que los usuarios puedan acceder a la información o solicitar al agente que realice acciones utilizando las credenciales del autor.

Para evitar que los usuarios accedan a datos o sistemas protegidos o los modifiquen, evalúe si los agentes utilizan los datos y sistemas que requieren autenticación con desencadenadores de eventos y cómo lo hacen. Los autores deben tener en cuenta cuando comparten o publican agentes que contienen desencadenadores de eventos.

Los administradores también pueden bloquear Copilot Studio a los usuarios para que no utilicen desencadenadores de eventos con sus agentes. Para obtener más información, vaya a Bloquear desencadenadores de eventos.

Limitaciones al usar fuentes de conocimiento con desencadenadores de eventos

Los agentes no pueden hacer referencia a algunas fuentes de conocimiento en respuesta a un desencadenador de eventos. Algunos orígenes de conocimiento requieren un agente para proporcionar autenticación para acceder, pero los agentes no pueden proporcionar esa autenticación de forma autónoma.

Evite estos orígenes de conocimiento cuando se haga referencia a ellos en respuesta a un desencadenador de eventos:

• SharePoint
• Dataverse
• Conectores de grafos
• Solicitudes de AI Builder

En su lugar, haga referencia a estos orígenes de conocimiento en respuesta a un desencadenador de eventos:

• Sitios web públicos
• Archivos cargados
• Datos empresariales, con conectores