User manualManual de usuario › Agents, plans and schedules › Putting agents to work › Scheduling an agentAgentes, planes y programaciones › Poner a trabajar a los agentes › Programar un agente

Scheduling an agent

Programar un agente

A schedule says when an agent runs by itself and who receives the briefing it writes.

Una agenda dice cuándo corre solo un agente y quién recibe el briefing que escribe.

👤 Who: Whoever operates agents📍 Where: Copilot → Agents → agent → Schedules

👤 Quién: Quien opera agentes📍 Dónde: Copilot → Agentes → agente → Agendas

Add a schedule

Agregar una agenda

Open the Schedules tab of the agent and press Add a schedule.
Choose the Cadence: Hourly, Daily, Weekly or Monthly. An agent can have one schedule of each cadence, and the cadence cannot be changed afterwards.
Set the Local time. For Hourly only the minute counts.
Set the Day of week for a weekly schedule, or the Day of month for a monthly one. A day past the end of a short month fires on its last day.
Leave the time zone as it is to follow your organisation's, or turn on Pin a time zone instead of following the tenant's and type one, such as America/Argentina/Cordoba.
Say Who receives it. Add Roles (everyone holding the role) or Named recipients. A named recipient is entered by the user's identifier, not by name.
Choose Through which channels. Tick In-app.
Leave Enabled on and save.

Abrí la pestaña Agendas del agente y tocá Agregar una agenda.
Elegí la Cadencia: Cada hora, Diaria, Semanal o Mensual. Un agente puede tener una agenda de cada cadencia, y la cadencia no se puede cambiar después.
Poné la Hora local. Para Cada hora solo cuenta el minuto.
Poné el Día de la semana en una agenda semanal, o el Día del mes en una mensual. Un día posterior al fin de un mes corto dispara el último día de ese mes.
Dejá la zona horaria como está para seguir la de tu organización, o encendé Fijar una zona horaria en vez de seguir la del tenant y escribí una, como America/Argentina/Cordoba.
Decí Quién lo recibe. Agregá Roles (todos los que tengan el rol) o Destinatarios nombrados. Un destinatario nombrado se carga con el identificador del usuario, no con su nombre.
Elegí Por qué canales. Tildá En la app.
Dejá Habilitada encendida y guardá.

⚠️

Only the in-app channel delivers. E-mail and Push can be ticked, but nothing is sent through them yet: each one is recorded as a failed delivery. With in-app, each recipient gets a notification in the bell that opens the briefing.Solo entrega el canal de la app. Correo y Push se pueden tildar, pero todavía no se envía nada por ellos: cada uno queda registrado como una entrega fallida. Con el canal de la app, cada destinatario recibe una notificación en la campana que abre el briefing.

How a schedule fires

Cómo dispara una agenda

The scheduler checks every five minutes, so a run starts within a few minutes of the time you set.
A run that is up to two hours late still happens. Later than that, it is skipped and recorded as missed.
The recipients of an agent's briefings are those of all its schedules together. Someone added to the daily schedule also receives the briefing of the weekly run.
A paused agent does not run. Each time its schedule comes due, a skipped run is recorded with the reason.
When the monthly AI limit is used up, the run is skipped as Skipped — budget.
An agent with no schedule runs only when someone presses Run now. If it finds something, the briefing is saved but addressed to nobody.

El programador revisa cada cinco minutos, así que una corrida arranca a los pocos minutos de la hora que pusiste.
Una corrida con hasta dos horas de atraso igual se hace. Más tarde que eso, se saltea y queda registrada como perdida.
Los destinatarios de los briefings de un agente son los de todas sus agendas juntas. Alguien agregado a la agenda diaria también recibe el briefing de la corrida semanal.
Un agente en pausa no corre. Cada vez que le toca la agenda, queda registrada una corrida salteada con el motivo.
Cuando se agota el límite mensual de IA, la corrida se saltea como Salteada — presupuesto.
Un agente sin agenda corre solo cuando alguien toca Correr ahora. Si encuentra algo, el briefing se guarda pero no se dirige a nadie.

Change, disable or delete

Cambiar, deshabilitar o borrar

In the menu of a schedule, Edit lets you change the time, the recipients and the channels, or turn Enabled off to stop it without losing it. Delete asks for confirmation and removes it. The Last fired column shows when it last ran, or Never.

En el menú de una agenda, Editar te deja cambiar la hora, los destinatarios y los canales, o apagar Habilitada para frenarla sin perderla. Borrar pide confirmación y la elimina. La columna Último disparo muestra cuándo corrió por última vez, o Nunca.

Common issues

Problemas habituales

The schedule never fires: Check, in order: the schedule is Enabled; the agent is Active and has an active mandate; your installation has scheduled runs turned on (ask whoever operates it). Skipped runs appear in the Runs tab with the reason.
"Pick at least one channel, otherwise the briefing reaches nobody.": Tick In-app.
"A weekly schedule needs a day of the week.": Choose the Day of week.
"A monthly schedule needs a day between 1 and 31.": Type a valid Day of month.
"Name the time zone, or go back to following the tenant's.": You turned on the pinned time zone and left it empty.
"Nobody — this schedule delivers to no one.": The schedule has no roles and no recipients. Edit it and add them.
"The schedule could not be saved.": Most often the agent already has a schedule with that cadence. Edit the existing one.
A recipient did not receive the briefing: Check that the role is written exactly as it exists in your organisation, and that the person has the permission to read briefings.

La agenda nunca dispara: Revisá, en orden: que la agenda esté Habilitada; que el agente esté Activo y tenga un mandato activo; que tu instalación tenga encendidas las corridas programadas (consultá a quien la opera). Las corridas salteadas aparecen en la pestaña Corridas con el motivo.
«Elegí al menos un canal, si no el briefing no le llega a nadie.»: Tildá En la app.
«Una agenda semanal necesita un día de la semana.»: Elegí el Día de la semana.
«Una agenda mensual necesita un día entre 1 y 31.»: Escribí un Día del mes válido.
«Nombrá la zona horaria, o volvé a seguir la del tenant.»: Encendiste la zona horaria fija y la dejaste vacía.
«Nadie: esta agenda no le entrega a nadie.»: La agenda no tiene roles ni destinatarios. Editala y agregalos.
«No se pudo guardar la agenda.»: Lo más común es que el agente ya tenga una agenda con esa cadencia. Editá la que existe.
Un destinatario no recibió el briefing: Revisá que el rol esté escrito exactamente como existe en tu organización, y que la persona tenga el permiso para leer briefings.