> ## Documentation Index
> Fetch the complete documentation index at: https://phaseo.app/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Hooks de cycle de vie

> Observez les exécutions d’agents Ruby, les tours de modèle, les outils, les pauses et la fin des exécutions.

Transmettez `on_event` pour recevoir des événements de cycle de vie structurés pendant l’exécution.

```ruby theme={null}
result = agent.run(
  input: prompt,
  client: client,
  on_event: ->(event) {
    logger.info(
      "agent event",
      type: event[:type],
      run_id: event[:run_id],
      details: event[:details]
    )
  }
)
```

Les événements utiles couvrent le démarrage, la fin et l’échec d’une exécution ; les tentatives du modèle ; les fragments de texte et de raisonnement ; le démarrage, la progression, la fin et l’échec des outils ; ainsi que les points de contrôle humains.

Gardez les gestionnaires rapides. Mettez en file d’attente les opérations de persistance lentes et masquez les entrées sensibles des outils avant de transmettre les événements à des services externes.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.