Configurar automatizaciones de agentes

Configurar una automatización planificada

Configure su agente para que se ejecute automáticamente con una frecuencia recurrente; no se requiere ningún evento de proyecto.
Nota: La automatización no estará activa hasta que se cambie a "Activo" y se guarde.

1. Con el Tipo de activador establecido en Planificado, añada una Descripción opcional para identificar lo que hace esta automatización.

2. En Planificación, abra el menú Ejecutar y seleccione una frecuencia: Todos los días, Días de la semana, Semanal, Mensual (por fecha), como el día 15 de cada mes, o Mensual (por día), como el segundo lunes de cada mes.

3. En Entrega, elija dónde aparece el resultado de la automatización:

   • Destino: dónde se publican los resultados (como un mensaje directo con el agente o en un canal específico).

   • Ubicación: cómo se organizan los resultados (como un mensaje nuevo en cada ejecución o en la misma conversación).

4. Opcional: En Entrega adicional, entregue los resultados a un canal externo. Dejar como Ninguno si no es necesario.

5. Continúe con Probar una automatización y Activar una automatización a continuación.

Configurar la automatización de eventos de una aplicación

Defina el evento de Procore que hace que su agente se ejecute automáticamente.
Nota: La automatización no estará activa hasta que se cambie a "Activo" y se guarde.

1. Establezca el Tipo de desencadenante en Evento de aplicación.

2. En Fuente del desencadenante, seleccione la plataforma conectada que proporciona el evento desencadenante (por ejemplo, Procore).

3. Introduzca un Nombre para la automatización. (Requerido)

4. Añada una descripción de lo que hace esta automatización. (Opcional)

5. En Desencadenador, seleccione el evento del proyecto que hará que el agente se inicie, como el siguiente:

   • RFI creada: el agente se ejecuta cuando se crea una nueva RFI en un proyecto.

   • Submittal actualizado: el agente se ejecuta cuando se edita un submittal.

   • Registro diario completado: el agente se ejecuta cuando un registro diario se marca como completo.

6. Opcional: Añada filtros de desencadenante. Después de seleccionar un evento desencadenante, aparece el campo Añadir filtros de desencadenante para que pueda describir sus reglas de ejecución en un lenguaje sencillo. Esto reduce los escenarios que ejecuta el agente, alineándose con su objetivo y evitando eventos innecesarios y uso de crédito. Considere hacer referencia a campos de Procore (como Estado, Persona asignada, Fecha límite) y opciones de campo (como Borrador, Abierto, Cerrado), como estos:

   • Órdenes de cambio: solo se ejecutan cuando el evento tiene un impacto en los costes Sí o Desconocido.

   • RFI: solo se ejecutan cuando el estado de la RFI es Abierto y el responsable está asignado al arquitecto.

7. Continúe con Probar una automatización y Activar una automatización a continuación.
   Nota: Una automatización no se ejecutará hasta que se cambie a Activo y Guardado.

Probar una automatización

Ejecute una simulación para vista previa de los resultados antes de la activación. Nota: Una prueba no utiliza créditos y no puede modificar elementos de Procore ni realizar acciones como enviar notificaciones.

• Automatizaciones planificadas: en la sección Ejecución de prueba , haga clic en Ejecutar una vez ahora para desencadenar una ejecución única inmediata.

• Automatizaciones de eventos de aplicación: en la sección Activador de prueba , seleccione un elemento de Procore existente (por ejemplo, seleccione una RFI específica o un evento de cambio) en el menú desplegable o realizando una búsqueda y, a continuación, ejecute la prueba.

  Nota: Si su proyecto no contiene elementos del tipo de evento seleccionado, aún puede activar y guardar la automatización, pero no se puede ejecutar una prueba hasta que exista dicho elemento.

Revise los resultados dentro de su hilo de chat activo para confirmar que la configuración funciona según lo previsto. Estos modelos donde la salida puede requerir la aprobación humana. Si es necesario, ajuste las instrucciones del agente o la configuración de automatización y vuelva a realizar la prueba.

Establecer la automatización como activa o inactiva

1. Haga clic en el interruptorpara cambiar la automatización a Activa o Inactiva.
   Nota: Establecer una automatización en "Inactiva" desactiva la automatización en segundo plano y conserva sus configuraciones para uso futuro.

2. Para confirmar su selección, lea la solicitud y haga clic en Activar automatización o Establecer como inactivo. La automatización no está activa hasta que también haya guardado los cambios como se describe en el siguiente paso.

3. Haga clic en el botón Guardar cambios en la parte superior del panel de configuración del agente.

    Importante

   • Créditos: cuando se ejecuta una automatización activa, el sistema deduce créditos del saldo del proyecto. Los eventos de aplicación en directo se procesan en lotes de 1 a 5 minutos para optimizar el consumo de créditos. Obtenga más información en la sección Cómo se agrupan las automatizaciones de eventos de aplicación a continuación.
   • Revisión: revise constantemente la precisión de los resultados automatizados en directo. Una prueba exitosa no reemplaza la verificación humana en curso.
   • Límite del sistema: el sistema pausa automáticamente las automatizaciones cuando se superan los límites de la tasa de actividad, para proteger su saldo acreedor. Consulte Gestión de errores a continuación.

Cómo se agrupan los eventos de automatización por lotes

Procore agrupa de forma inteligente los cambios frecuentes del proyecto utilizando ventanas de eventos móviles.

• Ventana de 1 minuto: cuando llega el primer evento del proyecto, se inicia un temporizador de 1 minuto. Si se produce otro evento durante ese minuto, el temporizador se reinicia para agrupar los nuevos datos en el mismo lote.

• Límite de 5 minutos: la ventana de recopilación sigue creciendo a medida que llegan nuevas actualizaciones, hasta un máximo de 5 minutos desde la hora del primer evento. Una vez que pasan 5 minutos, el sistema deja de esperar y ejecuta el agente una vez para procesar todas las actualizaciones recopiladas.

• Filtrado de duplicados: todos los eventos duplicados exactos capturados durante la ventana de procesamiento por lotes se filtran automáticamente para garantizar un procesamiento de datos limpio.

• Próximos ciclos de lote: cualquier actualización de proyecto nueva que se produzca después de que se cierre la ventana de 5 minutos iniciará automáticamente un nuevo lote y reiniciará la secuencia del temporizador.

Gestión de errores

Procore puede enviarle notificaciones sobre la actividad del agente y posibles problemas, por ejemplo, cuando un agente se ejecuta más de 20 veces en un minuto. El sistema pausa la automatización y sus tareas en segundo plano para evitar un uso excesivo de crédito.