Trace Emitter • AI Agent SDK

TraceEmitter: Emitter for action trace events.

TraceEmitter

Defined in the protocol module.

AI Agent

Emitter for action trace events.

Provides a high-level API for emitting trace events. Handles redaction and sink management.

Constructor

ParamField Optional[TraceSink]

No description available.

ParamField bool

No description available.

ParamField bool

No description available.

Methods

agent_start()

Emit agent start event.

agent_end()

Emit agent end event.

tool_start()

Emit tool start event.

tool_end()

Emit tool end event.

error()

Emit error event.

output()

Emit final output event.

flush()

Flush the sink.

close()

Close the sink.

Usage

python

sink = ListSink()
    emitter = TraceEmitter(sink=sink)

    emitter.agent_start("researcher")
    emitter.tool_start("search", {"query": "AI"})
    emitter.tool_end("search", duration_ms=100, status="ok")
    emitter.agent_end("researcher", duration_ms=500)

Source

View on GitHub

praisonaiagents/trace/protocol.py at line 208