SynapseGenerationCompletedEvent

L'événement SynapseGenerationCompletedEvent est le signal de fin. Il est émis une fois que le LLM a terminé de générer sa réponse et que tous les appels d'outils ont été résolus.

Namespace

ArnaudMoncondhuy\SynapseCore\Event\SynapseGenerationCompletedEvent

Constructeur

public function __construct(
    string $fullResponse,
    TokenUsage $usage = new TokenUsage(),
    ?string $debugId = null,
)

Méthodes

TokenUsage

L'objet TokenUsage encapsule les statistiques de consommation :

$usage = $event->getUsage();

$usage->promptTokens;      // Tokens en entrée
$usage->completionTokens;  // Tokens générés
$usage->totalTokens;       // Total
$usage->toArray();         // Conversion en tableau ['prompt_tokens' => ..., ...]

Exemple : Calcul de coût et facturation

namespace App\EventSubscriber;

use ArnaudMoncondhuy\SynapseCore\Event\SynapseGenerationCompletedEvent;
use Symfony\Component\EventDispatcher\EventSubscriberInterface;

class BillingSubscriber implements EventSubscriberInterface
{
    public static function getSubscribedEvents(): array
    {
        return [SynapseGenerationCompletedEvent::class => 'onGenerationCompleted'];
    }

    public function onGenerationCompleted(SynapseGenerationCompletedEvent $event): void
    {
        $usage = $event->getUsage();

        $this->billingService->recordUsage(
            totalTokens: $usage->totalTokens,
            debugId: $event->getDebugId(),
        );
    }
}

Voir aussi

• SynapseExchangeCompletedEvent — données techniques brutes (payload API)
• Cycle de vie des événements — séquence complète