Trace Service

Trace Service API methods in the Galtea SDK

The Trace Service in the Galtea SDK allows you to manage traces for evaluating your products. This Service is exposed by the galtea.traces object.

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

Quick Example

First, initialize the Galtea SDK:

galtea = Galtea(api_key="YOUR_API_KEY")

Generate a trace using an Agent (recommended):

# Define your agent function
def my_agent(user_message: str) -> str:
    return f"Response to: {user_message}"


trace = galtea.traces.generate(agent=my_agent, session=session, input="Generate something")

Manually create a trace:

trace = galtea.traces.create(
    session_id=session_id,
    input="What is the capital of France?",
    output="Paris",
    latency=150.5,
)

Update a trace:

trace = galtea.traces.update(
    trace_id=trace_id,
    output="Paris is the capital.",
    cost=0.0001,
)

Service Methods

• Generate Trace - Recommended for automatic span collection
• Create Trace
• Create and Evaluate - Create a trace and evaluate it in one call
• Create Trace Batch
• Update Trace
• List Traces
• Get Trace
• Delete Trace

Related

Trace

A single turn in a conversation between a user and the AI.