OpenAI permet de planifier les sessions d’Agents API
Une application peut lancer un agent à une date donnée ou selon un calendrier. Il faut ensuite lire les événements de sa session pour savoir si le travail a abouti.
OpenAI permet à une application de déclencher une session d’agent à une date précise ou selon un calendrier récurrent. L’entreprise a ajouté cette possibilité le 23 octobre à Agents API. Le guide des automatisations détaille deux façons de s’en servir. L’application peut démarrer une nouvelle session avec des consignes initiales ou ajouter une demande à une session qui existe déjà.
Un calendrier et une session sont deux objets distincts
Une automatisation à usage unique reçoit une date exprimée en secondes Unix. Pour une exécution récurrente, l’application fournit une expression cron à cinq champs et un fuseau horaire IANA. Elle peut par exemple indiquer Europe/Paris pour faire correspondre la récurrence à l’heure locale. Une règle nouvellement créée est active par défaut. Son enregistrement ne lance pas immédiatement le travail.
L’action dépend de la configuration choisie. Pour ouvrir une nouvelle session, l’application précise l’agent et son environnement ainsi que les premiers messages à lui transmettre. Pour reprendre une session, elle indique son identifiant et le message à ajouter. Cette deuxième option permet à l’agent de retrouver le contexte de cette session. Les deux actions acceptent les deux modes de planification.
Quand la session est déjà occupée
Une demande destinée à une session en cours peut attendre avant d’être traitée. OpenAI indique aussi qu’une exécution récurrente peut arriver avec un léger décalage aléatoire. L’horaire sert de point de départ au suivi. Pour une opération qui doit se terminer avant une heure fixe, l’application doit tenir compte du temps passé en attente puis du temps de traitement par l’agent.
Suivre le travail après le déclenchement
Le registre des exécutions indique ce qu’il est advenu de la demande transmise par l’automatisation. OpenAI précise que le statut completed correspond à l’acceptation de cette demande. Pour savoir si un agent a effectivement accompli son travail, l’application doit retrouver la session et consulter ses événements. Elle peut ainsi distinguer un déclenchement qui a bien transmis le message d’une tâche qui a échoué ensuite.
Un lancement manuel aide à contrôler la configuration. Il fonctionne même si la règle est en pause et laisse le calendrier intact. Il ne consomme pas non plus une automatisation prévue pour une seule exécution. Si le travail peut avoir un effet réel, l’application doit choisir un contexte de test adapté avant d’utiliser ce bouton ou cet appel.
Qui peut créer les règles
L’application peut administrer les automatisations depuis l’API. Un agent peut aussi disposer d’un outil prévu à cet effet. Cet outil est désactivé par défaut. Lorsqu’il est activé, l’agent peut gérer les automatisations qu’il a lui-même créées dans sa session. OpenAI documente séparément la mise à jour des outils d’une session existante.
La note de version du 23 octobre inscrit cette fonction dans Agents API en bêta publique. Le guide signale également qu’une mise en pause ou une suppression agit sur les futurs déclenchements. Une demande que la session a déjà acceptée peut continuer son parcours. Avant de modifier un calendrier, il faut donc vérifier si une demande a déjà été transmise.
Pour une première utilisation, je choisirais une tâche dont on peut contrôler le résultat dans la session. Par exemple, produire un relevé puis vérifier que le fichier existe et qu’il couvre bien la période demandée. Ce contrôle donne un critère de réussite clair lorsque plusieurs exécutions se succèdent.