> ## 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 do ciclo de vida

> Observe execuções de agentes PHP, turnos do modelo, ferramentas, pausas e conclusão.

Passe um callback `onEvent` para receber eventos estruturados do ciclo de vida enquanto a execução ocorre.

```php theme={null}
$result = $agent->run(
    input: $prompt,
    client: $client,
    onEvent: function (array $event): void {
        $logger->info("agent event", [
            "type" => $event["type"],
            "run_id" => $event["run_id"],
            "details" => $event["details"] ?? [],
        ]);
    }
);
```

Entre os eventos úteis estão início, conclusão e falha da execução; tentativas do modelo; fragmentos de texto e raciocínio; início, progresso, conclusão e falha das ferramentas; e pontos de revisão humana.

Mantenha os callbacks rápidos. Enfile tarefas lentas de persistência e remova dados sensíveis das entradas de ferramentas antes de encaminhar eventos para telemetria externa.


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