Programar ejecuciones de agentes

Puedes configurar tu agente para que ejecute tareas automáticamente de forma recurrente. Una programación sirve como activador automático para las instrucciones o los mensajes predefinidos del agente.

Agrega una programación de ejecución

Console

Para agregar una programación de ejecución para tu agente, haz lo siguiente:

  1. Abre tu agente en modo de edición.
  2. En el lienzo del Agent Designer, haz clic en la pestaña Programar.

  3. Haz clic en + Agregar programación y configura la recurrencia y la hora de ejecución:

    1. Frecuencia de repetición: Selecciona la frecuencia con la que se debe ejecutar el agente para ejecutar el mensaje proporcionado. Las siguientes opciones están disponibles:

      • Hourly: Ejecuta la tarea cada cantidad de horas especificada y en un minuto específico dentro de esa hora.
      • Daily: Ejecuta la tarea una vez al día a la hora especificada.
      • Weekly: Ejecuta la tarea una vez a la semana en el día y la hora especificados.
      • Monthly: Ejecuta la tarea una vez al mes en el día y la hora especificados.
      • Annually: Ejecuta la tarea una vez al año en el mes, el día y la hora especificados.

    2. Execution time and timezone: Define la configuración de intervalo específica según la frecuencia seleccionada y selecciona la zona horaria de ejecución.

    3. Prompt: Ingresa la instrucción que recibirá el agente a la hora programada. Esto define la tarea que ejecutará el agente.

  4. Haz clic en Guardar para crear la programación y agregarla a tu agente en estado Borrador.

  5. Opcional: Prueba tu programación para verificar si funciona según lo esperado.

  6. Para activar tu programación y volver a iniciar tu agente con los cambios actualizados, haz clic en Actualizar.

Prueba la programación de ejecución

Después de configurar una programación, puedes probar de inmediato la ejecución del agente para asegurarte de que realice la tarea según lo esperado sin esperar el próximo intervalo programado.

Console

Para probar la programación de ejecución, haz lo siguiente:

  1. En el lienzo del Agent Designer, haz clic en la pestaña Programar.

  2. Busca la tarjeta de programación que deseas probar y haz clic en Ejecutar en vista previa.

    Esto activa el agente con el mensaje y la configuración guardados.

Edita una programación de ejecución

Edita una programación de ejecución para realizar cambios en la frecuencia, la hora, la zona horaria o el mensaje.

Console

Para editar una ejecución programada existente, haz lo siguiente:

  1. En el lienzo del Agent Designer, haz clic en la pestaña Programar.
  2. Busca la tarjeta de programación que deseas probar y haz clic en Editar.
  3. Modifica la Frecuencia de repetición, la Hora de ejecución, la Zona horaria y el Mensaje según lo seleccionado.
  4. Haz clic en Guardar.
  5. Haz clic en Actualizar para asegurarte de que todos los cambios, incluida la nueva programación, se guarden y se apliquen al agente.

Borra una programación de ejecución

Si ya no se necesita una tarea recurrente, puedes borrarla y quitarla de la lista Programaciones de agentes.

Console

Para borrar una programación de ejecución, haz lo siguiente:

  1. En el lienzo del Agent Designer, haz clic en la pestaña Programar.
  2. Busca la tarjeta de programación que deseas probar y haz clic en Borrar.
  3. Confirma la eliminación para quitar de forma permanente la programación de ejecución de tu agente.

Actualiza las programaciones de agentes

Las programaciones de agentes operan con tus credenciales de usuario. Para garantizar la privacidad y la seguridad de los datos, estas credenciales vencen cada 14 días. Debes actualizar manualmente las programaciones de tus agentes para asegurarte de que sigan ejecutándose automáticamente sin interrupciones.

Console

Para actualizar las programaciones de todos los agentes, haz lo siguiente:

  1. Abre tu app de Gemini Enterprise y ve a la página Galería de agentes.

  2. Realiza una de las siguientes acciones para actualizar tus programaciones:

    • Ve a la sección Tus agentes y haz clic en event_repeat (Actualizar las programaciones existentes).

    • Abre un agente en modo de edición y haz lo siguiente:

      1. En el lienzo del Agent Designer, haz clic en la pestaña Programar.
      2. Haz clic en Actualizar programaciones.

Se actualizarán tus credenciales de usuario y todos los agentes programados seguirán ejecutándose durante otro período de 14 días.

Consulta y aprueba las ejecuciones programadas

Todas las ejecuciones programadas, incluidas las que están pendientes de aprobación, se muestran en tu historial de chat.

Console

Para consultar y aprobar las ejecuciones programadas, haz lo siguiente:

  1. Abre tu app de Gemini Enterprise y ve a la sección Chats en el menú de navegación.
  2. Busca y abre el hilo de conversación correspondiente a tu agente programado.
  3. Si la ejecución programada está en pausa, revisa la acción propuesta y haz clic en Aprobar para completar la tarea.

Limitaciones

  • Debes actualizar manualmente tus programaciones cada 14 días para evitar que fallen tus agentes programados.
  • Puede haber un retraso máximo de 5 minutos en la ejecución de la programación del agente.
  • Las programaciones solo se admiten en ubicaciones multirregionales.

¿Qué sigue?