Span Service

The Span Service in the Galtea SDK allows you to collect, manage, and persist spans that capture the internal operations of your AI agents during inference. This Service is exposed by the galtea.spans object.

Remember that we will be using the galtea object. More information here.

Two Approaches to Span Collection

The SDK provides two ways to collect spans:

1. Automatic Collection with with `generate()`

When using galtea.traces.generate(), span collection is handled automatically:

@traced(type=SpanType.TOOL)
def fetch_user_data(user_id: str) -> dict:
    return {"name": "John Doe", "email": "john@example.com"}


@traced(type=SpanType.GENERATION)
def generate_response(prompt: str) -> str:
    return "Generated response..."


def my_overview_agent(input_data: AgentInput) -> AgentResponse:
    user = fetch_user_data("user_123")
    response = generate_response("Hello")
    return AgentResponse(content=response)


# Use generate() for automatic span context management
trace = galtea.traces.generate(
    agent=my_overview_agent,
    session=session,
    input="Show me user data",
)

2. Manual Collection with Context Management

For full control over the span lifecycle, use set_context() and clear_context(): Set context before running traced functions:

span_context = set_context(trace_id=trace_id)

Then run your traced functions within this context set/open. Once done, clear the context to flush and detach:

clear_context(span_context)

Use galtea.traces.generate() for automatic span collection instead of manual collection.

Introduction

SDK

CLI

Concepts

Two Approaches to Span Collection

1. Automatic Collection with with `generate()`

2. Manual Collection with Context Management

Service Methods

Context Management

Direct API Methods

Span

​Two Approaches to Span Collection

​1. Automatic Collection with with generate()

​2. Manual Collection with Context Management

​Service Methods

​Context Management

​Direct API Methods

​Related

Span

Two Approaches to Span Collection

1. Automatic Collection with with `generate()`

2. Manual Collection with Context Management

Service Methods

Context Management

Direct API Methods

Related