Quickstart
Start with creation of the listener:Name
AgentListener is used as example, you can name it as you wishapp\Providers\AppServiceProvider.php and register event with listener:
handle method will be executed.
Available Events
AgentDTO Structure
Each event that includes
agentDto uses the following Data Transfer Object
structure:Lifecycle Events
These events track the main lifecycle stages of an agent conversation.AgentInitialized
Dispatched when the agent completes its initialization process and is ready to handle conversations. Namespace:Complete agent configuration including provider, tools, instructions, and
response schema.
ConversationStarted
Dispatched when therespond() method begins execution, marking the start of a new conversation turn.
Namespace:
ConversationEnded
Dispatched when therespond() method completes execution, indicating the end of a conversation turn.
Namespace:
ToolChanged
Dispatched when tools are dynamically added to or removed from the agent during runtime. Namespace:AgentCleared
Dispatched when the agent’s state is cleared, typically resetting conversation history and context. Namespace:EngineError
Dispatched when an error occurs in the LLM engine during processing. Namespace:Hook Events (Before/After)
These events provide hooks before and after critical operations, allowing you to modify behavior or track execution flow.BeforeReinjectingInstructions
Dispatched before instructions are reinjected into the conversation history. Namespace:BeforeSend
Dispatched just before adding message in chat history Namespace:AfterSend
Dispatched immediately after adding LLM response to Chat history. Namespace:BeforeSaveHistory
Dispatched before persisting the conversation history to storage. Namespace:BeforeResponse
Dispatched before sending message to LLM Namespace:AfterResponse
Dispatched right after receiving a message from LLM API Namespace:BeforeToolExecution
Dispatched just before a tool is executed by the agent. Namespace:The tool call instance is going to be executed. Get details with
getId,
getToolName, & getArguments methodsAfterToolExecution
Dispatched immediately after a tool completes execution. Namespace:The tool call instance is going to be executed. Get details with
getId,
getToolName, & getArguments methods
