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 las indicaciones predefinidas del agente.

Agrega un programa 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 Diseñador de agentes, haz clic en la pestaña Programación.
  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 la instrucción proporcionada. Las siguientes opciones están disponibles:

      • Por hora: Ejecuta la tarea cada cierta cantidad de horas y en un minuto específico dentro de esa hora.
      • Diaria: Ejecuta la tarea una vez al día a la hora especificada.
      • Semanal: Ejecuta la tarea una vez por semana en el día y la hora especificados.
      • Mensual: Ejecuta la tarea una vez al mes en el día y la hora especificados.
      • Anualmente: Ejecuta la tarea una vez al año en el mes, el día y la hora especificados.
    2. Hora y zona horaria de ejecución: Define la configuración de intervalo específica según la frecuencia seleccionada y elige la zona horaria de ejecución.

    3. Instrucción: Ingresa la instrucción específica que recibirá el agente a la hora programada. Define la tarea que ejecutará el agente.

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

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

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

Prueba el programa 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 siguiente intervalo programado.

Console

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

  1. En el lienzo del Diseñador de agentes, haz clic en la pestaña Programación.
  2. Busca la tarjeta de programación que quieras probar y haz clic en Ejecutar en vista previa.

    Esto activa el agente con la instrucción y la configuración guardadas.

Cómo editar un programa de ejecución

Edita un programa de ejecución para cambiar la frecuencia, la hora, la zona horaria o la instrucción.

Console

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

  1. En el lienzo del Diseñador de agentes, haz clic en la pestaña Programación.
  2. Busca la tarjeta de programación que quieras probar y haz clic en Editar.
  3. Modifica la frecuencia de repetición, el tiempo de ejecución, la zona horaria y la instrucción según lo seleccionado.
  4. Haz clic en Guardar.
  5. Haz clic en Actualizar para asegurarte de que todos los cambios, incluido el nuevo programa, se guarden y apliquen al agente.

Cómo borrar una programación de ejecución

Si ya no necesitas una tarea recurrente, puedes borrarla y quitarla de la lista de Programas del agente.

Console

Para borrar un programa de ejecución, haz lo siguiente:

  1. En el lienzo de Agent Designer, haz clic en la pestaña Schedule.
  2. Busca la tarjeta de programación que quieras 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 los programas de los agentes

Los programas del agente 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 los programas de tu agente para asegurarte de que sigan ejecutándose automáticamente sin interrupciones.

Console

Para actualizar los programas de todos los agentes, haz lo siguiente:

  1. Abre tu app de Gemini Enterprise y ve a la página Agent Gallery.
  2. Realiza una de las siguientes acciones para actualizar tus programas:

    • Ve a la sección Tus agentes y haz clic en event_repeat (Actualiza las programaciones existentes).
    • Abre un agente en modo de edición y haz lo siguiente:

      1. En el lienzo de Agent Designer, haz clic en la pestaña Schedule.
      2. Haz clic en Actualizar agendas.

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

Cómo ver y aprobar ejecuciones programadas

En tu historial de chat, se enumeran todas las ejecuciones programadas, incluidas las que están en espera de aprobación.

Console

Para ver 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 al 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 los agentes programados.
  • Puede haber un retraso máximo de 5 minutos en la ejecución del programa del agente.
  • Las programaciones solo se admiten en ubicaciones multirregionales.

¿Qué sigue?