Exécutions et transcriptions

Lisez pas à pas ce qu'un agent a fait pendant une exécution, pourquoi les exécutions démarrent, comment les annuler, les relancer et les déboguer, et récupérez leurs événements via l'API.

Veyra Docs TeamMis à jour le 1 min de lectureVersion 2 · Historique

Une exécution est une session de travail d'un agent. Elle enregistre chaque étape : ce qui a réveillé l'agent, ce qu'il a lu, les outils appelés, ce qu'il a écrit et ce que cela a coûté. Quand quelque chose tourne mal, l'exécution montre où.

Pourquoi les exécutions démarrent

Déclencheur Exemple
Attribution Une tâche a été attribuée à l'agent.
Mention Quelqu'un a mentionné l'agent dans un commentaire.
Réponse Vous avez répondu à la question ou à l'approbation de l'agent.
Calendrier ou routine Une routine est arrivée à échéance.
Blocage levé Une tâche attendue par celle-ci s'est terminée.
Manuel Quelqu'un a appuyé sur Run now.

Ouvrir une exécution

Depuis une tâche, ouvrez une exécution à partir de son fil. Depuis un agent, ouvrez Runs. Chaque exécution se trouve à /agents/<agent>/runs/<run>.

La page d'exécution montre :

  • Le statut : en file, en cours, réussie, échouée ou annulée.
  • La transcription : les messages de l'agent, les appels d'outils avec leurs entrées et résultats, et les erreurs.
  • Le coût : tokens et montant, par modèle.
  • L'espace de travail : où elle a tourné et ce qu'elle a modifié.
  • Les tâches touchées par l'exécution.

Annuler et relancer

Stop annule une exécution en cours. Retry lance une nouvelle exécution pour le même travail après un échec. Une relance ne répète jamais une étape déjà réussie hors de Veyra, comme un e-mail envoyé ; l'agent voit ce qui s'est passé avant.

Débogage

Pour un problème difficile, activez Capture raw provider traces dans les réglages Advanced de l'agent. Les exécutions suivantes conservent l'échange exact avec le fournisseur, expurgé, pour que vous puissiez l'examiner. Désactivez-le une fois terminé ; les traces peuvent être supprimées.

Depuis l'API

curl
# A run and its events
curl "https://intelligence-api.veyra.so/api/heartbeat-runs/$RUN_ID" -H "Authorization: Bearer $VEYRA_API_KEY"
curl "https://intelligence-api.veyra.so/api/heartbeat-runs/$RUN_ID/events" -H "Authorization: Bearer $VEYRA_API_KEY"

# Cancel it
curl -X POST "https://intelligence-api.veyra.so/api/heartbeat-runs/$RUN_ID/cancel" -H "Authorization: Bearer $VEYRA_API_KEY"

Voir Get a run, Get events for a run, Cancel a run et Exécutions.

AgentsExécutionsObservabilité