Listeners

`AgentListener`

A concrete orchestration class that manages the logging lifecycle. Wraps an AgentLogger and manages the concurrent listening task whilst piping events into the logger.

class AgentListener:

    logger: AgentLogger
    connected: asyncio.Event

    def __init__(self, logger: AgentLogger) -> None: ...

    async def listen(self, csm: ClientSessionManager, uid: str, iid: str | None = None) -> None:

    def close(self) -> None: ...

The following are key methods:

listen - Starts the async task that receives chunks
close - Cancels the listening task

`set_default_agent_listener`

Set the default agent listener for all agents and agentic functions in the current scope. This is the StandardListener by default.

This will be over-ridden by any contextual logging or listeners provided on spawning and invoking an agentic function or agent. See here for more information.

def set_default_agent_listener(
    listener: Callable[[], AgentListener] | None, local_context: bool = True
) -> None:
    ...

Parameters

Callable[[], AgentListener] | None

The listener constructor for logging an agent or agentic function’s activity and chat history. If None, no listener will be used.

bool

If True, is only for this Context.

Token Usage

Loggers

⌘I

Core

Logging

Prompting

`AgentListener`

`set_default_agent_listener`

​AgentListener

​set_default_agent_listener

`AgentListener`

`set_default_agent_listener`