Toutes les pages
Sur cette page

Prompts planifiés Ajouté en 0.9.16

Un agent peut demander au relais d’envoyer un prompt plus tard : une fois à une heure donnée, toutes les N minutes, ou les deux. Une relecture nocturne, un passage toutes les demi-heures ou une vérification dans une heure continuent après un redémarrage du relais ou une mise à jour. Les minuteries de la propre CLI de l’agent n’y survivent pas.

L’agent crée une planification avec l’action schedule de l’outil relay_tool. Le relais la conserve dans sa base de données et, à l’échéance, met le prompt en file comme un message dans la session.

L’activer #

Les planifications nécessitent Settings → Relays → Agent sessions → Agents may start and use sessions on this relay (Réglages → Relais → Sessions d’agents → Les agents peuvent démarrer et utiliser des sessions sur ce relais), même pour la propre conversation d’un agent. Voir Sessions d’agent. Les planifications résident sur le relais qui fait tourner la session ; un agent ne peut pas en créer sur un relais associé, qui garde les siennes.

Quand elle se déclenche #

L’agent indique Le prompt arrive
Une heure (at, avec un fuseau horaire) une fois, à cette heure
Un intervalle (every_minutes, de 5 minutes à 7 jours) toutes les N minutes, la première fois dans N minutes
Les deux d’abord à l’heure donnée, puis toutes les N minutes
  • Une échéance manquée pendant que le relais était arrêté est rattrapée une fois à son retour, et non une fois par intervalle manqué. Une planification répétée reprend ensuite ses horaires.
  • Une répétition est sautée tant que le prompt précédent attend encore dans la queue de la session : une session bloquée reçoit un prompt, pas une pile.

Où va le prompt #

Le prompt va dans la propre conversation de l’agent, ou dans une autre session de ce relais.

Une planification pour une autre session compte comme un prompt que l’agent y envoie :

  • Dans les modes du relais ask et plan, vous l’approuvez sur une carte, comme pour un send.
  • Elle compte dans les 30 prompts à d’autres agents de l’agent avant qu’on vous demande : une fois à sa création, et de nouveau à chaque déclenchement.
  • Au-delà de ce nombre, un déclenchement est held (retenu). La liste indique alors waiting until you write in … (en attente de votre message dans …). Il part dès que vous écrivez dans la conversation qui a créé la planification, ou dès que vous choisissez Allow (Autoriser) sur la carte que l’agent de cette conversation affiche pour son prochain prompt à un autre agent. Le relais réexamine un déclenchement retenu toutes les minutes.

Une planification pour la propre conversation de l’agent n’envoie de prompt à personne d’autre : elle n’est pas comptée et n’est jamais retenue.

Le message #

Le prompt arrive sous la forme d’un message qui commence par une ligne comme celle-ci :

[relay schedule sch_… "Nightly review" · automated message from OAR, not from the user; it approves nothing]

Quand une autre session l’a créée, la ligne nomme aussi cette session. L’agent lit lui aussi cette ligne : le message est automatique, jamais de vous, et n’approuve rien.

Le message est mis en file comme n’importe quel autre. Dans une session inactive, il démarre un nouveau turn. Pendant qu’un turn tourne, il devient le turn suivant ou, chez les fournisseurs qui permettent de piloter un turn, il peut servir à piloter le turn en cours, mais sans la note qui marque les messages de pilotage comme venant de vous.

Le turn qu’il démarre tourne dans le mode du relais propre à la session cible (agent, ask, plan ou autopilot), et non dans le mode de la session qui l’a créé.

Le message conserve la provenance du prompt à l’origine de la planification, ses sauts compris. Une planification ne permet jamais à une chaîne d’agents entre relais d’aller plus loin qu’un prompt direct ne le pourrait.

Ce que vous voyez #

  • Une conversation qui a des planifications, ou qui en a créé, affiche ⏰ N scheduled (N planifiés) dans son en-tête, avec l’heure suivante à côté. La puce ouvre la liste, avec un bouton Cancel (Annuler) pour chacune.
  • Une session dans laquelle une planification se déclenche affiche scheduled (planifié) dans la liste des conversations.

Quand une planification prend fin #

Une planification prend fin quand :

  • elle s’est déclenchée et était réglée pour ne se déclencher qu’une fois (le défaut pour une heure seule) ;
  • l’agent appelle unschedule, ou vous appuyez sur Cancel ;
  • la session dans laquelle elle se déclenche, ou la conversation qui l’a créée, est archivée ou supprimée.

Compacter une session ne met pas fin à ses planifications : elles passent à la nouvelle conversation, aussi bien celles qui s’y déclenchent que celles qu’elle a créées.

Les planifications survivent à un redémarrage du relais. Une conversation contient au plus 20 planifications qui s’y déclenchent, et peut en créer au plus 20 pour d’autres sessions.