Descripción general del evento Gatillo (versión preliminar)
Puede configurar agentes personalizados para realizar acciones o llamar a temas en respuesta ante algo que sucede mediante el uso de activadores de eventos. A diferencia de los activadores tema, que requieren la entrada de un usuario, los activadores de eventos permiten que su agente actúe de forma autónoma en respuesta ante el evento definido que ocurre.
Importante
El uso de activadores de eventos es una actividad pública Característica en vista previa (GB). El uso de activadores de eventos es gratuito para los participantes de versión preliminar, pero requiere mensajes que cuenten para sus cuotas de uso. Las vistas previas de características no se han diseñado para un uso de producción y pueden tener una funcionalidad restringida. Estas características están disponibles antes del lanzamiento oficial para que los clientes puedan tener un acceso anticipado y proporcionar comentarios.
Nota
Esta función solo está disponible para agentes con la orquestación generativa habilitada.
Cómo funcionan los desencadenadores de eventos
Los activadores de eventos requieren un evento elegido que genera una carga útil Gatillo y la envía a 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 agente autor en las instrucciones de agente y las instrucciones enviadas a través de la carga útil Gatillo.
Los agentes solo actúan según el diseño y las instrucciones de su autor. Por ejemplo, puede agregar un Gatillo para cuando se agrega un nuevo miembro del equipo, y designar respuesta para que sea la acción para enviar al nuevo empleado un mensaje de bienvenida con recursos de incorporación.
Los activadores de eventos se activan en función de eventos externos a agente. Son diferentes de los activadores tema, que se utilizan para activar temas o acciones en función de frases Gatillo ingresadas 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 evento Gatillo, consulte Agregar un evento Gatillo.
Otros ejemplos de desencadenantes de eventos incluyen:
- Cuando se crea un elemento en SharePoint
- Cuando se crea un archivo en OneDrive
- Cuando se completa un tarea en Planner
- Cuando llega un nuevo correo electrónico a Outlook
- Ha transcurrido una determinada cantidad de tiempo (una Recurrencia Gatillo)
Importante
Los activadores disponibles dependen de las políticas de datos prevención de pérdidas de su organización, configuradas en Power Automate por un Administrador.
El flujo de trabajo Gatillo
Un Gatillo es una parte de un flujo de trabajo que contiene varias partes:
- Un evento Gatillo registra que ocurrió un evento específico.
- El Gatillo envía una carga útil que contiene información sobre el evento e instrucciones.
- El agente tiene instrucciones para elegir una o más acciones según la carga útil.
Encuentra el Gatillo que se adapta a tu evento
Copilot Studio tiene una biblioteca de activadores para una variedad de eventos que pueden ocurrir en Microsoft y servicios asociados. La configuración Gatillo determina los parámetros del evento que inicia Gatillo. También determina el contenido de la carga útil Gatillo.
La mayoría de los activadores le permiten especificar parámetros sobre el evento que hace que Gatillo se active. Por ejemplo, en Cuando llega un nuevo correo electrónico Gatillo para Outlook, puede especificar que solo los correos electrónicos con una línea de asunto que contenga la cadena detalles del proyecto activen Gatillo, en lugar de todos los correos electrónicos entrantes.
Defina la carga útil Gatillo
La carga útil Gatillo es un mensaje JSON o de texto simple que contiene información sobre un evento. La carga útil se envía a su agente como un mensaje. Al agregar un Gatillo , puede conservar el contenido de carga útil predeterminado para ese Gatillo o agregar sus propias instrucciones. Más tarde, puede modificar el contenido de la carga útil, incluso agregando variables y operadores de cadena, en Power Automate.
Por ejemplo, el mensaje predeterminado en Cuando llega un nuevo correo electrónico Gatillo es Usar contenido de Body. Cuando agente recibe la carga útil, tiene el contenido del cuerpo del correo electrónico y las instrucciones para usar ese contenido.
Puedes agregar instrucciones para enviar a tu agente dentro de la carga útil que le indica a agente cómo actuar cuando es activado por Gatillo. Si tiene varios activadores, cada carga útil Gatillo puede tener instrucciones específicas y detalladas, sin necesidad de escribir instrucciones largas y complicadas en las instrucciones generales de agente ni confundir a agente sobre qué instrucciones se aplican a qué Gatillo.
Por ejemplo, en una carga útil Cuando llega un nuevo correo electrónico Gatillo, puede agregar Buscar elementos de acción para el destinatario en Body. Cuando agente recibe la carga útil, recibe la instrucción de buscar elementos de acción dentro del cuerpo del correo electrónico.
Sin embargo, evite escribir instrucciones de carga útil que entren en conflicto con las instrucciones generales de agente. Los conflictos en las instrucciones pueden provocar un error o resultados inesperados. Asegúrese de Probar todos los cambios que impliquen activadores de eventos.
Después de crear un Gatillo, puede agregar o cambiar variables u operadores de cadena en una carga útil Gatillo y modificar las instrucciones de carga útil existentes usando Power Automate.
Instrucciones agente versus instrucciones de carga útil
Las instrucciones de carga útil son específicas sobre cómo reaccionar ante un evento. También puedes usar las instrucciones agente para indicarle a tu agente cómo manejar la información de un Gatillo y cómo actuar cuando recibe una carga útil Gatillo, así como para determinar el comportamiento general de tu agente. Por ejemplo, para un agente que crea tareas por hacer Microsoft en función de los correos electrónicos entrantes, las instrucciones podrían ser: Cuando reciba elementos de acción de un nuevo correo electrónico, cree una tarea por hacer tarea en la lista de tareas.
Sin embargo, las instrucciones agente podrían no funcionar mejor para todas las situaciones. Si su agente tiene múltiples activadores o múltiples objetivos complejos, debe utilizar instrucciones en la carga útil Gatillo .
Continuando con el último ejemplo, puede agregar una instrucción en la carga útil Gatillo para Buscar elementos de acción para el destinatario en Body. Cuando agente recibe la carga útil, se le indica que busque elementos de acción. Las instrucciones generales de agente le indican luego que cree tareas por hacer para cada elemento de acción que encuentre.
Crear instrucciones para los agentes requiere práctica. Visita la guía de escritura para obtener más consejos y prueba siempre todos los cambios que realices en tu agente.
Llamar a una acción o tema
Cuando un agente recibe una carga útil Gatillo, las instrucciones que le ha dado determinan la acción o tema que llama en tema. Sus instrucciones permiten que su agente realice una acción o Seleccionar según la información que tenga disponible.
Su agente no crea una nueva acción o tema en el momento. Como agente autor, necesitas definir las acciones o temas desde los que puede Seleccionar. Para saber cómo su agente determina qué acción o tema llamar, vaya a ¿Cómo funciona el modo generativo?
Si tu agente no reacciona como esperabas, puedes usar el mapa de actividad para ver si falta alguna información de entrada clave.
Algunas mejoras que puedes realizar en las instrucciones incluyen:
- Agregar instrucciones más detalladas en la carga útil Gatillo o en las instrucciones agente. Es posible que tu agente necesite más orientación, como qué información usar en un campo de entrada específico para la acción.
- Incluyendo instrucciones en la carga útil Gatillo.
- Instruir a su agente para llamar a una acción específica o tema.
- Respuesta para instrucciones conflictivas entre la carga útil Gatillo y las instrucciones agente.
- Agregando a las descripciones de las acciones, para que agente tenga más información para determinar cuándo llamarlo.
- Agregar descripciones a los campos de entrada de acciones para ayudar a su agente a completar los parámetros correctamente. Si las entradas de una acción son las mismas cada vez, puedes establecer el valor tú mismo.
- Llamar a menos de 15 acciones o temas consecutivamente. Los agentes complejos que ejecutan muchas acciones o temas como una sola secuencia pueden tener dificultades para ejecutarlos de manera confiable.
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.
Agentes de publicación con activadores de eventos
Antes de publicar tu agente con un nuevo evento Gatillo, el agente no reacciona automáticamente a ese Gatillo. Asegúrate de probar el agente a fondo antes de publicarlo, porque después de publicar un agente con un nuevo Gatillo, tu agente reacciona automáticamente cada vez que se activan sus activadores. ... Puedes ver un registro paso a paso de los desencadenantes y reacciones de tu agente en la página de Actividad .
Para obtener información sobre cómo activar activadores durante las pruebas, vaya a Probar un Gatillo.
Los activadores de eventos solo pueden usar las credenciales agente autor's para la autenticación (es decir, las credenciales que utilizó para autorizar las conexiones) para su Gatillo. Esto puede permitir que los usuarios de un agente utilicen el agente para acceder a datos y sistemas utilizando esa misma autorización. Para obtener más información, vaya a Solución de problemas y limitaciones.
Autenticar acciones después de publicar
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 falla una acción, no puede continuar la sesión. Si desea que su agente se ejecute de forma autónoma, cada acción debe configurarse con una autenticación funcional que no requiera la entrada del usuario. También puedes indicarle a tu 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 crear un Power Automate acción de flujo que utiliza el conector problemático para completar la acción.
Solución de problemas y limitaciones
Limitaciones de cupo
Si los disparadores se activan con demasiada frecuencia, es posible que su agente termine utilizando más recursos de los esperados. Es posible que su agente exceda la carga de servicio. límites de cuota, y su servicio podría verse limitado.
Los administradores pueden Monitorear el uso de recursos a través de Power Platform. También pueden bloquear el uso de activadores de eventos en un Más pequeño.
Para evitar exceder los límites de cuota:
- Tenga cuidado al agregar desencadenadores muy frecuentes o que se repiten indefinidamente. Por ejemplo, una recurrencia Gatillo se activa cada vez que transcurre un período de tiempo determinado. Cuanto más tiempo transcurra entre activaciones, más recursos utilizará Gatillo.
- Realice un seguimiento de cuántos activadores están activos en un ambiente.
Los activadores solo pueden usar credenciales de creador
Actualmente, los activadores de eventos solo pueden usar las credenciales agente autor's para la autenticación. Si publica o crea un Compartir con activadores de eventos autenticados, los usuarios podrán acceder a información o solicitarle al agente que realice acciones usando las credenciales del autor.
Para evitar que los usuarios accedan o modifiquen datos o sistemas protegidos, considere cuidadosamente si los agentes con activadores de eventos utilizan datos y sistemas que requieren autenticación y de qué manera lo hacen. Los autores deben tener cuidado al compartir o publicar agentes que contengan activadores de eventos.
Los administradores también pueden bloquear a los usuarios para que no utilicen activadores de eventos con sus agentes. Copilot Studio Para obtener más información, vaya a Bloquear activadores de eventos .
Limitaciones en el uso de fuentes de conocimiento con activadores de eventos
Los agentes no pueden hacer referencia a algunas fuentes de conocimiento en respuesta a un evento Gatillo. Algunas fuentes 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 estas fuentes de conocimiento cuando se haga referencia a ellas en respuesta en un evento Gatillo:
- SharePoint
- Dataverse
- Conectores de grafos
- AI Builder Indicaciones
Haga referencia a estas fuentes de conocimiento en respuesta a un evento Gatillo en su lugar:
- Sitios web públicos
- Archivos subidos
- Datos empresariales mediante conectores